MCP

Scan a live MCP server

Connects to a remote MCP endpoint over Streamable HTTP, runs the handshake, and grades the tools, resources, and prompts it advertises against MCP best practices. Returns a weighted mcpScore (0–100) with per-check findings. Synchronous (no polling). Public — no API key required. Remote http(s) endpoints only; stdio servers aren't reachable. This is a standalone tool: its score is independent of the site agent-readability score.

post/api/v1/scan/mcp

Request

  • Base URL: https://agent-ready.dev
  • URL: https://agent-ready.dev/api/v1/scan/mcp
  • Auth: none required

Request body

endpointstring uri required

Example request

{
  "endpoint": "https://mcp.example.com/mcp"
}

Response

The MCP server scan result and its shareable report URL.

shareUrlstring required

Example response

{
  "scan": {
    "id": "bUqzgS67CE",
    "endpoint": "https://mcp.example.com/mcp",
    "host": "mcp.example.com",
    "checks": [
      {
        "checkId": "S1",
        "name": "llms.txt exists"
      }
    ]
  },
  "shareUrl": "/mcp-server-scanner/bUqzgS67CE"
}

Changes

No recorded changes to this operation across all 1 revision of this API.