← methodology

MCP server discovery

usability.mcp-discovery · Usability · 5 pts · required

Goal

Can an agent integrate with you?

Whether the artifacts an agent needs to build on you — docs, API specs, SDKs, MCP servers — exist and are findable.

How we test

Probed /.well-known/mcp/server-card.json, mcp.json, and docs mentions for an MCP endpoint.

How to pass

Publish /.well-known/mcp/server-card.json describing your MCP endpoint so agents can autodiscover it.

Spec

https://modelcontextprotocol.io ↗

Verify a fix

curl -X POST /api/scan/checks \
  -H 'content-type: application/json' \
  -d '{"url": "yourdomain.com", "checkIds": ["usability.mcp-discovery"]}'