Skip to content

Clarify MCP names#6035

Merged
ethanpalm merged 3 commits into
mainfrom
mcp-names
May 29, 2026
Merged

Clarify MCP names#6035
ethanpalm merged 3 commits into
mainfrom
mcp-names

Conversation

@ethanpalm
Copy link
Copy Markdown
Collaborator

@ethanpalm ethanpalm commented May 29, 2026

Documentation changes

This PR makes the distinctions between the MCP servers more clear with the search MCP and admin MCP


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Low Risk
Documentation-only terminology and copy updates with no product or API behavior changes.

Overview
This PR renames and reframes Mintlify’s two MCP offerings in ai/mintlify-mcp.mdx and ai/model-context-protocol.mdx: the hosted write/edit server is now admin MCP (with shortTitle Admin MCP), and the site-hosted read/search server is search MCP (with shortTitle Search MCP).

On the admin page, copy and metadata now stress dashboard access, settings, and workflows, not only docs edits. The comparison table is flipped so Admin MCP is the first column and Search MCP the second, with rows updated for audience, access, endpoints, and outputs. Connector setup labels (e.g. Admin MCP in Claude) and cross-links to the search doc use the new names.

On the search page, titles, descriptions, and body text consistently say search MCP instead of a generic “documentation MCP.” Wording shifts from “documentation” to site / content where it describes indexing, auth, rate limits, and tools. The admin cross-link in the tip uses admin MCP server. Section headings such as Search MCP compared to web search and Access your search MCP server match the new naming.

URLs and paths (/ai/mintlify-mcp, https://mcp.mintlify.com, /mcp) are unchanged; this is documentation terminology and positioning only.

Reviewed by Cursor Bugbot for commit 72be431. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 29, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 29, 2026, 10:47 PM

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 29, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview May 29, 2026, 10:48 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants