Skip to content

Document MCP discovery endpoint#5714

Closed
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/docs-mcp-well-known-1778250666
Closed

Document MCP discovery endpoint#5714
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/docs-mcp-well-known-1778250666

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 8, 2026

Summary

Documents the new public /.well-known/mcp discovery endpoint that returns a JSON document describing a docs site's MCP server URL(s), transport, and authentication requirements. AI tools and agent-readiness scanners can probe this path to detect a Mintlify-hosted MCP server without needing the URL in advance.

The new section explains:

  • What the endpoint is and where it lives
  • That it is publicly accessible, returns CORS headers, and is cached for 24 hours
  • The shape of the response, including the public /mcp entry and the optional /authed/mcp entry when authenticated MCP is enabled
  • A representative JSON example

Updates apply to the English page plus the Spanish, French, and Chinese translations of the Model Context Protocol page.

Generated-By: mintlify-agent
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 8, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 8, 2026, 2:36 PM

@ethanpalm
Copy link
Copy Markdown
Collaborator

closing in favor of #5715

@ethanpalm ethanpalm closed this May 8, 2026
@ethanpalm ethanpalm deleted the mintlify/docs-mcp-well-known-1778250666 branch May 8, 2026 18:49
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.

1 participant