MCP tool reference

This page lists every tool a connected AI client can call through Orbit’s remote MCP connector — 22 tools plus 12 guided workflow prompts.

Every call runs as the signed-in user: read tools see only what you can see, and write tools require your write access plus an editor seat.

Find and read pages

Tool	What it does
orbit_list_workspaces	List the Orbit workspaces accessible to the signed-in user.
orbit_list_notes	List folders and markdown pages in one workspace.
orbit_search_notes	Search indexed pages across all accessible workspaces or one workspace.
orbit_resolve_note	Resolve a page hint, path, or URL into an exact page reference.
orbit_get_note	Read a page as raw content, full metadata, a document map for safe edits (sections, tables, and meeting blocks), a single section, or agent-ready context.
orbit_get_folder	Read a folder page: its pages, connections to other folders and pages, and incoming references.
orbit_list_comment_threads	Read a page’s comment threads in full — authors, messages, replies, reactions, resolved state, and where each thread is anchored.
orbit_get_workspace_graph	Return the workspace’s wiki-link graph.

Comments are visible to AI clients

The full, document-map, and section formats of orbit_get_note report where your comment threads are anchored — a page-level summary, plus a per-section and per-table list for the document map. Only the commented text is shared; the comment messages themselves never leave Orbit.

This lets a client preserve commented passages when it edits. When an edit does destroy the anchored text, the write result reports it as commentImpact, and a well-behaved client tells you which comments lost their anchor. Those comments are not deleted — they show as unanchored in Orbit, and reattach if the text comes back.

Create and edit pages

Tool	What it does
orbit_create_note	Create a new markdown page by path; refuses to overwrite existing pages. Can set the page’s icon, subtitle and tags in the same call.
orbit_append_to_note	Append to the end of a page or to a chosen heading section; never replaces existing content.
orbit_patch_note	Make surgical edits: exact text replacement, block replacement, section replacement, or insert after a heading.
orbit_upload_asset	Upload a binary attachment to a page and return ready-to-insert markdown.
orbit_add_meeting_block	Add a native meeting notes block to a page from your client’s summary and the transcript as plain copied text (no file needed); a summary alone is enough.
orbit_set_page_properties	Set a page’s emoji icon, its one-line subtitle and its Orbit tags. These live outside the markdown, so the other write tools can’t set them. Refused on locked pages.

Build a knowledge base from documents

Ask your AI client to “build a knowledge base from the HR Policies folder” and it can turn a folder of Word, PDF or PowerPoint files into linked Orbit pages: a home page, sections with subpages, FAQs, a glossary and an About page listing every source document. The client reads the documents with its own tools (in Claude, the Microsoft 365 connector, or files you attach); Orbit does not read them. Before writing anything it shows a short outline and asks once, “Build it?”. Every page links back to its source documents, flags places where two documents disagree, and says “Not covered in the source documents” instead of guessing. Ask it later to “update the knowledge base” and it changes only what the documents changed.

The client gets these steps from orbit_get_guide, which it calls by itself when you ask, so there is nothing to install. The same steps are the orbit_build_knowledge_base prompt and the orbit-build-knowledge-base Agent Skill.

HTML reports

Ask your AI client for an HTML report, overview, or explainer and it can store it straight into a page as an HTML block using the normal create and edit tools — no extra tool is needed. The client writes a :::html block with the raw HTML; Orbit shows it in a sandbox where scripts, forms, embedded frames, content from other websites, and links are blocked. If the HTML relies on any of those, the write result warns the client so it can switch to inline styles and embedded images. orbit_get_note with format=document-map lists every HTML block in htmlBlocks[].

Columns

Your AI client can lay content side by side with the same columns you create by dragging: a :::::columns row holding ::::column blocks, optionally with a width percentage. orbit_get_note with format=document-map lists every columns row in columns[], and sections never cross a column fence, so section edits stay inside one column.

Page tables

A page table shown on a page is a ![[Name.orbitdb]] line. The tools still call it a database. orbit_get_note with format=document-map lists each one in databases[], so your AI client can see where they sit. orbit_get_database reads its columns and rows, orbit_update_database changes rows, columns, title and view, and orbit_create_database adds a new one to a page. If an edit removes the line, the write result tells the client that only the embed left the page; the page table itself is unchanged.

There is deliberately no full-page overwrite tool: edits stay localized so open collaborative editors stay in sync.

Edit tables

These tools edit existing markdown tables atomically, protected against stale reads by table hashes.

Tool	What it does
orbit_insert_table_rows	Insert rows into a table.
orbit_update_table_cells	Update individual body cells.
orbit_delete_table_rows	Delete body rows.
orbit_move_table_rows	Move rows from one table to another atomically.

Organize and delete

Tool	What it does
orbit_move_note	Move or rename one page within a workspace; never deletes content.
orbit_delete_note	Move one page to Recently Deleted — a restorable soft delete, not a permanent delete.
orbit_delete_folder	Recursively delete a folder; child pages go to Recently Deleted, and folders containing non-page files are rejected by default.

Deleted pages are restorable in Orbit — see Versions, export, and trash.

Diagnose problems

Tool	What it does
orbit_doctor	Return connector version, instructions, and advertised capabilities.
orbit_get_write_status	Check whether a timed-out write was received, applied, persisted, or failed.
orbit_get_guide	Return Orbit’s step-by-step guide for a larger job (today: building or updating a knowledge base from documents).

Run guided workflows (prompts)

Clients that support MCP prompts also get 13 guided workflows. Prompts are instructions, not tools — they do not modify Orbit by themselves.

Prompt	What it does
orbit_query_wiki	Answer a question from wiki content, with citations and no writes by default.
orbit_summarize_workspace	Summarize a workspace using search, graph, and page context.
orbit_note_briefing	Brief you on one page plus its backlinks, links, and related pages.
orbit_lint_wiki	Inspect a workspace for wiki health issues and propose reviewable fixes.
orbit_find_contradictions	Identify conflicting statements or stale assumptions.
orbit_build_context_pack	Build a bounded, cited context pack for an external task.
orbit_draft_from_related_notes	Draft new markdown from related pages and link context.
orbit_append_meeting_notes	Turn raw meeting notes or a transcript into a summary and add it to a page as Orbit’s meeting block.
orbit_ingest_source	Turn one source page into cited wiki updates or candidate pages.
orbit_promote_candidate	Review a candidate page and promote it into the wiki after confirmation.
orbit_prepare_ai_ready_wiki	Prepare a normal workspace for AI-assisted wiki workflows.
orbit_collect_context	Collect all Orbit context connected to a client or topic folder, following folder connections across accessible workspaces.
orbit_build_knowledge_base	Turn a folder of documents into a linked knowledge base of Orbit pages, after one quick confirm.

Up next: teach your client Orbit’s conventions with the Agent Skills.