# MCP tools reference

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

![Claude.ai connector settings showing Falconer MCP tool permissions](/docs/images/falconer-mcp-tool-permissions.png)

## 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.