> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# ReadMe

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* List API reference pages last edited over 90 days ago for review.
* Search the docs for pages mentioning `legacy-auth` after the migration.
* Find docs with broken links across all sections.

## Available Tools

#### list\_api\_definitions

List all API definitions (OpenAPI specs) in a branch. Returns filenames, types, and upload status.

#### get\_api\_definition

Get an API definition by filename. Use list\_api\_definitions to find available filenames.

#### delete\_api\_definition

Delete an API definition permanently. Use list\_api\_definitions to find filenames.

#### list\_branches

List all branches (versions) in the ReadMe project. Returns branch names and metadata.

#### create\_branch

Create a new branch (version) in the ReadMe project. Requires a name (semver). Optionally fork from an existing versi...

#### get\_branch

Get details of a specific branch (version) by name or version number. Use list\_branches to find available branches.

#### update\_branch

Update a branch's title. Use list\_branches to find available branch names.

#### delete\_branch

Delete a branch (version) permanently. Cannot delete the stable branch. Use list\_branches to find branch names.

#### list\_categories

List categories in a branch by section type (guides or reference). Use branch='stable' for the default version.

#### create\_category

Create a new category in a branch. Requires a title. Section defaults to 'guide'. Use list\_categories to see existing...

#### get\_category

Get a specific category by section and title. Use list\_categories to find available category titles.

#### update\_category

Update a category's title or position. Use list\_categories to find category titles.

#### delete\_category

Delete a category permanently. Use list\_categories to find category titles.

#### list\_category\_pages

List all pages within a category. Use list\_categories to find section and title values.

#### list\_changelogs

List changelog entries with pagination. Supports filtering by visibility. Use page and per\_page for pagination.

#### create\_changelog

Create a new changelog entry. Requires a title. Optionally set type (added, fixed, improved, etc.) and body content.

#### get\_changelog

Get a changelog entry by slug or ID. Use list\_changelogs to find available slugs.

#### update\_changelog

Update a changelog entry's title, type, body, or visibility. Use list\_changelogs to find slugs.

#### delete\_changelog

Delete a changelog entry permanently. Use list\_changelogs to find slugs.

#### list\_custom\_pages

List all custom pages in a branch. Custom pages are standalone pages outside the guides/reference sections.

#### create\_custom\_page

Create a new custom page. Requires a title. Supports markdown or HTML content.

#### get\_custom\_page

Get a custom page by slug. Use list\_custom\_pages to find available slugs.

#### update\_custom\_page

Update a custom page's title, content, or visibility. Use list\_custom\_pages to find slugs.

#### delete\_custom\_page

Delete a custom page permanently. Use list\_custom\_pages to find slugs.

#### create\_guide

Create a new guide page. Requires title and category\_uri. Use list\_categories with section='guides' to find category ...

#### get\_guide

Get a guide page by slug. Use list\_category\_pages to find guide slugs.

#### update\_guide

Update a guide page's title, body, state, or visibility. Use list\_category\_pages to find guide slugs.

#### delete\_guide

Delete a guide page permanently. Use list\_category\_pages to find guide slugs.

#### list\_images

List uploaded images with pagination. Use page and per\_page for pagination (max 100 per page).

#### get\_image

Get an uploaded image by ID. Use list\_images to find available image IDs.

#### get\_project

Get ReadMe project metadata including name, subdomain, plan, and configuration. Useful for discovering project settings.

#### list\_recipes

List all recipes (tutorials) in a branch. Recipes are step-by-step guides for common tasks.

#### create\_recipe

Create a new recipe (tutorial). Requires a title. Optionally include body content and excerpt.

#### get\_recipe

Get a recipe by slug. Use list\_recipes to find available recipe slugs.

#### update\_recipe

Update a recipe's title, body, excerpt, or visibility. Use list\_recipes to find slugs.

#### delete\_recipe

Delete a recipe permanently. Use list\_recipes to find recipe slugs.

#### create\_reference\_page

Create a new API reference page. Requires title and category\_uri. Use list\_categories with section='reference' to fin...

#### get\_reference\_page

Get an API reference page by slug. Use list\_category\_pages with section='reference' to find page slugs.

#### update\_reference\_page

Update an API reference page's title, body, state, or visibility. Use list\_category\_pages to find page slugs.

#### delete\_reference\_page

Delete an API reference page permanently. Use list\_category\_pages to find page slugs.

#### search\_docs

Search across all documentation pages, guides, changelogs, and references. Returns matching results with highlighted ...