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

Publish a server card at /.well-known/mcp/server-card.json describing your MCP server.
List the tools, their parameters, and their auth requirements.
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 file→ https://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.

Hand it to your AI assistant

Paste this into Claude Code, Cursor, or any assistant with your repository open. It carries the steps, how to verify them, and the shortcuts to avoid. It is generic, though: run a scan to get one written from what your pages actually do.

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 →