agent-ready-mcp-server-card

An MCP Server Card is a standardized JSON metadata file that makes an MCP server discoverable by AI agents. It declares the server's identity, transport endpoint, and supported capabilities so compatible clients can automatically identify and connect to the deployment.

To implement MCP server discovery metadata for Cloudflare Workers, configure a JSON endpoint at `/.well-known/mcp/server-card.json`. This endpoint must return valid server metadata, including serverInfo, the transport endpoint, and supported capabilities for agent discovery.

Yes, the MCP Server Card pattern works with Streamable HTTP MCP deployments. It is specifically designed to apply to Cloudflare Workers and Agents SDK applications requiring standardized server metadata and capability discovery.

You validate MCP server readiness for AI agent discovery by scanning the deployed server with the isitagentready.com scanner. This scanner verifies that the MCP discovery metadata passes validation and is correctly configured for agent access.

You should declare supported tools, resources, and prompts in your MCP server card. Documenting these capabilities ensures that AI agents can accurately discover and interact with the functions your MCP server exposes.

Your MCP server might not be discovered by AI clients if the `/.well-known/mcp/server-card.json` endpoint is missing or misconfigured. You must ensure valid serverInfo, a transport endpoint, and supported capabilities are present, then validate using isitagentready.com.