agentspeed.
← all fixes
Remediation

An MCP Server Card is reachable at `/.well-known/mcp/server-card.json` (or referenced from a Link header) and validates against the Model Context Protocol spec.

discoverability.mcp_server_carddiscoverabilityweight 1deterministicauto-fix available
Why it matters

An MCP (Model Context Protocol) server card declares the agent-callable tools your site exposes. Agents use it to discover what they can do on your behalf (search products, get quotes, file tickets) without you having to publish a custom integration per agent runtime.

Underlying specification: https://modelcontextprotocol.io

How to fix
  1. Publish a server card at /.well-known/mcp/server-card.json describing your MCP server.
  2. List the tools, their parameters, and their auth requirements.
  3. Reference it from /llms.txt under an "Agent tools" section so agents discover it during their initial pass.
Generated snippet

The snippet below uses your-domain.example as a placeholder. Replace it with your actual host before deploying. For a fix tailored to your live site, run a scan and open the per-domain remediation page.

Generated fixnew filehttps://your-domain.example/.well-known/mcp/server-card.json

AgentSpeed didn't find an MCP Server Card. The Model Context Protocol is how AI agents discover the tools your site exposes, and a server card at the canonical .well-known location lets capability-aware agents pick the right one without HTML scraping.

{
  "schemaVersion": "2024-11-05",
  "name": "Your Domain",
  "description": "One-sentence description of the tools your site exposes to agents.",
  "url": "https://your-domain.example",
  "contact": {
    "email": "mcp@your-domain.example"
  },
  "capabilities": {
    "tools": [
      {
        "name": "search",
        "description": "Search the public catalogue of <your-content>."
      }
    ]
  }
}
save as https://your-domain.example/.well-known/mcp/server-card.json
  • Save as `/.well-known/mcp/server-card.json` (note the dot prefix).
  • The schemaVersion field tracks the MCP spec version; update when MCP publishes a new draft.
  • See modelcontextprotocol.io for the canonical schema and examples.
Run a scan to check your site
Verify on your site

Run a scan against your domain to see whether discoverability.mcp_server_card currently passes, warns, or fails. Free, no signup; the score page is permanent and citable.

Run a scan →See the full rubric →