@falconer/mcp

MCP server for reading, searching, and updating Falconer documents from MCP clients.

What's New in 0.1.11

• Matches the Falconer Public API 0.1.11 schema.
• Adds set_document_status for setting a document's review-workflow status (draft, in_review, approved, outdated).
• Adds list_document_reviewers and update_document_reviewers for managing document reviewers.
• Adds update_document_metadata for updating document title, slug, and metadata.
• Adds ask_falcon for synthesized, cited answers over the workspace.
• Adds rich component authoring guidance to the server system prompt.

What's New in 0.1.10

• Matches the Falconer Public API 0.1.10 schema.
• Adds create_comment for creating anchored document comments.

What's New in 0.1.9

• Matches the Falconer Public API 0.1.9 schema.
• Adds document revision tools for listing, reading, creating, restoring, and deleting revisions.

What's New in 0.1.8

• Matches the Falconer Public API 0.1.8 schema.
• Adds reorder_folder_children for full direct-child folder reordering.
• Forwards parentDocumentId for document create, move, and publish tools.
• Adds unresolve_comment for reopening resolved comment threads.

What's New in 0.1.7

• Matches the Falconer Public API 0.1.7 schema.
• Adds targeted content replace/insert/delete tools.
• Adds comment list/reply/update/delete/resolve tools.
• Adds media upload support for images and videos.
• Adds navigation tools for children, trees, moves, and publishing docs.
• Adds folder create/read/update/delete tools.
• Adds document permission update tools.

Falconer documents use Markdown. Preserve Falconer-specific syntax exactly when editing:

• Inline references/citations: ![f>][reference-id]. Older docs may contain ![f>][display text][reference-id]; preserve those as-is.
• Math: inline $latex$ or $$latex$$; block math fenced with $$...$$ or $$$...$$$.
• Tables and task lists use GitHub-flavored Markdown.
• Local images and videos should be uploaded with upload_media first, then the returned snippet should be inserted into document content.

Setup

1. Install CLI and authenticate

npm install -g @falconer/cli
falconer oauth login

2. Add MCP server

Claude Code:

claude mcp add falconer -- npx @falconer/mcp@latest

Cursor — add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "falconer": {
      "command": "npx",
      "args": ["@falconer/mcp@latest"]
    }
  }
}

3. Verify

• Claude Code: Restart and run /mcp
• Cursor: Open Command Palette → "View: Open MCP Settings"

Tools

| Tool | Description | |------|-------------| | read | Fetch a document by ID, title, or URL | | search | Search documents by keyword or semantic query | | upload_media | Upload a local image or video and return a ready-to-insert markdown/HTML snippet | | create | Create a new document from markdown | | replace_document_content | Replace exact Markdown text in a document | | insert_document_content | Insert Markdown content before/after an exact anchor, or at document start/end | | delete_document_content | Delete exact Markdown text from a document | | edit | Legacy find-and-replace edit on a document | | overwrite | Replace a document's full markdown content. Whole-document rewrites can cause existing comments to lose the text they reference. | | delete | Delete a document by archiving it | | list_document_revisions | List revision metadata for a document | | read_document_revision | Read the Markdown content for a document revision | | create_document_revision | Create a revision of the current document content | | restore_document_revision | Restore a document to a revision | | delete_document_revision | Delete a single document revision | | list_comments | List document comment threads | | create_comment | Create a new anchored document comment | | reply_to_comment | Reply to a document comment | | update_comment | Update a document comment or reply | | delete_comment | Delete a document comment or reply | | resolve_comment | Resolve a document comment thread | | unresolve_comment | Unresolve a document comment thread | | list_nav_children | List visible child folders and documents for a nav location | | get_nav_tree | Get a visible navigation tree | | get_folder | Get folder metadata and visible one-level children | | create_folder | Create a folder | | update_folder | Update folder metadata | | reorder_folder_children | Set the full direct-child order for a folder | | move_nav_item | Move a folder or document nav item | | move_document | Move a document nav placement by document ID | | publish_document | Publish a private document into company navigation | | delete_folder | Delete a folder by archiving it and its documents | | update_document_permissions | Update document permissions |

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