Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion ai/mintlify-mcp.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Admin Model Context Protocol (MCP) server"
shortTitle: "Admin MCP"
description: "Let AI tools directly edit your content and update settings in your dashboard with the admin MCP server. Connect Claude, Cursor, or any MCP client to draft, save, and ship changes."
description: "Give AI tools like Claude and Cursor write access to your Mintlify content and dashboard so they can edit pages, update settings, and open PRs."
keywords: ["MCP", "write access", "AI", "editing", "Claude", "Cursor", "branch", "pull request"]
---

Expand All @@ -21,7 +21,7 @@
| :-- | :-- | :-- |
| **Audience** | Your team | Your end users |
| **Access** | Read, edit, restructure, save, create workflows, manage settings | Read and search published pages |
| **Endpoints** | Hosted by Mintlify, scoped to your project | `/mcp` on your site domain |

Check warning on line 24 in ai/mintlify-mcp.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/mintlify-mcp.mdx#L24

Use 'endpoints?' instead of 'Endpoints'.
| **Output** | Content edits, navigation changes, pull requests, workflow runs | Search results and page content |

## Connect to the admin MCP
Expand Down Expand Up @@ -111,7 +111,7 @@

### Navigation

- **`list_nodes`** — Walk the navigation tree with optional filters. Filter by `parentId` (use `recursive: true` to include all descendants), one or more node types, or any division scope: `language`, `version`, `tab`, `dropdown`, `anchor`, `product`, or `item`. Results are paginated through an opaque `cursor`.

Check warning on line 114 in ai/mintlify-mcp.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/mintlify-mcp.mdx#L114

In general, use active voice instead of passive voice ('are paginated').
- **`create_node`** — Add a new page, group, tab, anchor, version, language, product, or dropdown.
- **`update_node`** — Update a node's properties in place (rename a group, change an icon, set a default version).
- **`move_node`** — Move a node, including renaming a page's path.
Expand All @@ -135,8 +135,8 @@
After you connect the admin MCP, you can drive it with natural-language prompts. For example:

- _"Check out a branch called `add-billing-faq` and create a new page under the FAQ group titled 'Billing'. Draft answers for the five questions in this Linear issue."_
- _"Find every page that mentions the deprecated `legacy_token` field and update the example to use `api_key` instead. Save as a PR titled 'docs: replace legacy\_token references'."_

Check warning on line 138 in ai/mintlify-mcp.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/mintlify-mcp.mdx#L138

Did you really mean 'legacy_token'?
- _"Reorganize the API reference: move the webhooks pages into a new group called 'Webhooks' and update the icons to match the rest of the section."_

Check warning on line 139 in ai/mintlify-mcp.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/mintlify-mcp.mdx#L139

Use 'REST' instead of 'rest'.

## Best practices

Expand Down
2 changes: 1 addition & 1 deletion ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Search Model Context Protocol (MCP) server"
shortTitle: "Search MCP"
description: "Connect your content to AI tools like Claude and Cursor with a hosted MCP server for search."
description: "Connect AI tools like Claude, Cursor, and ChatGPT to your hosted search MCP server so they can find and retrieve your content."
keywords: ["MCP", "AI tools", "Claude", "Cursor", "search"]
---

Expand Down
Loading