Skip to content

Document MCP discovery endpoint#5715

Merged
ethanpalm merged 2 commits intomainfrom
mintlify/mcp-discovery-1778255450
May 8, 2026
Merged

Document MCP discovery endpoint#5715
ethanpalm merged 2 commits intomainfrom
mintlify/mcp-discovery-1778255450

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 lets agents and agent-readiness scanners locate a docs site's MCP server URL and authentication options without prior configuration.

Changes

  • Added a "Discovery endpoint" section to the MCP page describing the JSON response shape, fields, and behavior when authentication is enabled.

Source change

Triggered by a feature commit that adds a public, unauthenticated /.well-known/mcp endpoint to documentation sites. The response includes the MCP server version, transport, default URL, and a list of public and (when applicable) authenticated server entries with OAuth 2.0.


Note

Low Risk
Documentation-only change describing a new MCP discovery endpoint; no runtime or behavior changes in this PR.

Overview
Adds documentation for a public /.well-known/mcp MCP discovery document, including an example response payload and a brief field/behavior reference (noting the additional authenticated server entry when auth is enabled).

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

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, 3:56 PM

@ethanpalm ethanpalm merged commit c90f30b into main May 8, 2026
5 checks passed
@ethanpalm ethanpalm deleted the mintlify/mcp-discovery-1778255450 branch May 8, 2026 18:58
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