Skip to content

Document additional discovery methods#6010

Merged
ethanpalm merged 1 commit into
mainfrom
agent-card
May 27, 2026
Merged

Document additional discovery methods#6010
ethanpalm merged 1 commit into
mainfrom
agent-card

Conversation

@ethanpalm
Copy link
Copy Markdown
Collaborator

@ethanpalm ethanpalm commented May 27, 2026

Documentation changes

A2A cards and more endpoints for agent-readiness.


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 updates with no product or security behavior changes.

Overview
Documents agent-readiness discovery endpoints that Mintlify already serves, so readers know how to find MCP and skills without dashboard setup.

On MCP, the discovery section now notes that /.well-known/mcp is also available at /.well-known/mcp.json, plus MCP server card URLs at /.well-known/mcp/server-card.json and /.well-known/mcp/server-cards.json, and states that these endpoints need no configuration.

On skill.md, a new Agent card section describes GET /.well-known/agent-card.json (A2A agent card 0.2.0), how A2A agents use it with documentationUrl and per-skill fetches, reverse-proxy forwarding for that path, and that the card is a session-free discovery complement to MCP.

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

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 27, 2026

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

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

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 27, 2026

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

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

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

@ethanpalm ethanpalm merged commit aab0432 into main May 27, 2026
6 checks passed
@ethanpalm ethanpalm deleted the agent-card branch May 27, 2026 23:43
mintlify Bot added a commit that referenced this pull request May 27, 2026
mintlify Bot added a commit that referenced this pull request May 27, 2026
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
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