Read, write, and update docs with the MCP

The Falconer MCP lets coding agents like Claude Code and Cursor read, search, create, edit, overwrite, and delete your Falconer docs directly — without leaving your editor or chat interface.

Prerequisites

• A Falconer account with a Pro subscription
• Claude Code or Cursor

Set up the MCP

Follow the Set up MCP and CLI guide to install the CLI, authenticate with OAuth, and add the MCP server for Claude Code or Cursor.

Use the agent

Once connected, the agent can search, read, create, edit, overwrite, and delete your Falconer docs.

Search for a doc

Ask the agent:

Search my Falconer docs for our API authentication guide

Or in Claude Code, the agent will call search automatically when you reference internal knowledge.

Search returns excerpts. Use read with the document ID to get the full content after a search.

Read a specific doc

Paste a Falconer link into your conversation:

Read this doc: https://falconer.com/editor/abc123__api-auth-guide

The agent fetches the full markdown content and uses it as context.

Create a new doc

Try something like:

Summarize what we just discussed and save it as a Falconer doc

The agent calls create with the markdown content and returns the URL of the new doc. It lands in your Private collection — you can review and publish it from there.

Edit existing docs

Permissions apply. The agent can only access docs your account has permission to see.

You can ask for specific updates, like:

Update the Falconer doc 'Deployment runbook' -- change all references to staging-v1 to staging-v2

The agent reads the doc first and then makes the update.

You can also ask for generic updates, like:

Update all of our deployment-related docs based on this session

Overwrite a doc

When you need to replace a document’s entire content rather than making targeted edits:

Replace the contents of the API reference doc with the new spec we just generated

The overwrite tool replaces the full Markdown content. Use this when the document needs a complete rewrite rather than incremental changes.

Delete a doc

To archive a document:

Delete the outdated onboarding doc abc123

The agent calls delete with the document ID. Deleted documents are archived and can be restored from the Falconer UI if needed.

Visibility in responses. When reading or searching docs, the agent receives each document’s visibility status (private, shared, or published) so it knows who can access the content.