# Read, write, and update docs with the MCP

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

## Prerequisites

- A Falconer account with a Pro subscription (required for API key access)
- Claude Code or Cursor

## Set up the MCP

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

## Use the agent

Once connected, the agent can search, read, create, and edit 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
```