MCP tools reference

Falconer MCP exposes tools your AI client can use to find, read, create, update, organize, and manage Falconer documents.

Organization discovery

Tool	What it does
list_organizations	Lists Falconer organizations available to the MCP connection.

If only one organization is available, your client can usually omit organizationId. If multiple organizations are available, pass the selected organizationId on future Falconer tool calls.

Find and read documents

Tool	What it does
search	Searches Falconer documents by keyword query, semantic query, or both.
read	Reads a Falconer document by document ID, title, or Falconer URL.

Use search when you do not know the exact document. Use read before editing so the agent can copy exact Markdown text from the current document.

Create and update documents

Tool	What it does
create	Creates a Falconer document from Markdown.
replace_document_content	Replaces exact Markdown text in a document.
insert_document_content	Inserts Markdown before or after exact anchor text, or at the start or end of a document.
delete_document_content	Deletes exact Markdown text from a document.
edit	Legacy exact replacement tool. Prefer the targeted content tools above.
overwrite	Replaces the full Markdown body of a document.
delete	Archives a Falconer document by ID.

Prefer replace_document_content, insert_document_content, and delete_document_content for targeted updates. Use overwrite only when the whole document needs to be rewritten.

Comments

Tool	What it does
list_document_comments	Lists comment threads on a Falconer document.
reply_to_comment	Replies to an existing document comment.
edit_comment	Edits one of your existing comments.
delete_comment	Deletes one of your existing comments.
resolve_comment	Resolves a document comment thread.
unresolve_comment	Reopens a resolved document comment thread.

Navigation and folders

Tool	What it does
list_nav_children	Lists visible child folders and documents for a navigation location.
get_nav_tree	Gets a visible Falconer navigation tree.
get_folder	Gets folder metadata and visible one-level children.
create_folder	Creates a Falconer folder.
update_folder	Updates a folder title or description.
reorder_folder_children	Sets the full direct-child order for a folder.
reorder_nav_children	Sets the full direct-child order for a folder or document nav item.
move_nav_item	Moves a folder or document navigation item.
move_document	Moves a document navigation placement by document ID.
publish_document	Publishes a private document into company navigation.
delete_folder	Archives a folder and its documents.

Inspect navigation placement before moving documents or folders. If a document move or publish reports ambiguous placement, retry with the returned sourceNavItemId.

Permissions and media

Tool	What it does
update_document_permissions	Updates document ACL mode, organization-wide access, public access, user access, or group access. Direct permission changes on inherited documents switch them to explicit mode automatically.
upload_media	Uploads an image or video and returns a snippet that can be inserted into document content.

Permissions

The MCP connection uses your Falconer account. Your client can only access documents, folders, comments, and permissions your account can access in Falconer.