Skip to content

docs: document additional MCP discovery paths#6003

Closed
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/1561a81f
Closed

docs: document additional MCP discovery paths#6003
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/1561a81f

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 26, 2026

Summary

Mintlify now serves MCP discovery info at three additional well-known paths probed by agent-readiness scanners, in addition to the existing /.well-known/mcp endpoint. These endpoints are served automatically and require no configuration.

Changes

  • Added a note to the MCP discovery endpoint section describing the additional paths: /.well-known/mcp.json, /.well-known/mcp/server-card.json, and /.well-known/mcp/server-cards.json.
  • Mirrored the update across the Spanish, French, and Chinese translations.

Note

Low Risk
Documentation-only additions to MCP discovery sections with no product or security behavior changes.

Overview
The Discovery endpoint section in model-context-protocol.mdx now documents three extra well-known URLs beyond /.well-known/mcp: the same discovery JSON at /.well-known/mcp.json, an MCP server card at /.well-known/mcp/server-card.json, and a server-card list at /.well-known/mcp/server-cards.json. The new copy notes these exist for agent-readiness scanner compatibility and that Mintlify serves them automatically with no site configuration.

The same paragraph was added to the Spanish, French, and Chinese MCP docs so localized pages stay aligned with English.

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

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 26, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 26, 2026, 11:46 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 26, 2026

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

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview May 26, 2026, 11:46 PM

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

@ethanpalm
Copy link
Copy Markdown
Collaborator

closing in favor of #6010

@ethanpalm ethanpalm closed this May 27, 2026
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