mcp-server-cardVerified SpecificationModel Context Protocol (MCP) Server Card Implementation
Publishing machine-readable MCP tool and resource cards to enable autonomous AI agents to interact with your services.
The Model Context Protocol (MCP) is the emerging open protocol created by Anthropic and adopted across the AI industry for discovering backend tools and structured APIs.
Step-by-Step Remediation Guide
4 Actionable Steps- 1Create a JSON manifest describing your public tools and capabilities.
- 2Host the file at https://yourdomain.com/.well-known/mcp.json.
- 3Ensure the endpoint serves Content-Type: application/json and allows CORS GET requests.
- 4Validate that tool inputSchema matches JSON Schema Draft-07 standards.
Production Implementation Code
jsonCopy and deploy this production snippet into your application to satisfy the audit test.
{
"$schema": "https://modelcontextprotocol.io/schema/server-card.json",
"name": "my-platform-mcp",
"version": "1.0.0",
"description": "Public documentation search and query tools",
"transport": {
"type": "sse",
"url": "https://yourdomain.com/api/mcp/sse"
},
"capabilities": {
"tools": [
{
"name": "search_docs",
"description": "Searches documentation knowledge base",
"inputSchema": {
"type": "object",
"properties": {
"query": { "type": "string" }
},
"required": ["query"]
}
}
]
}
}Technical Architecture & In-Depth Details
Making Your Platform Autonomous-Agent Ready
As AI systems evolve from simple chatbots into autonomous agents capable of performing multi-step tasks, they need standard discovery protocols to know what endpoints and tools are available.
Publishing /.well-known/mcp.json tells any compatible agent (Claude Desktop, Cursor, Agent SDKs) exactly how to authenticate, which tools are callable, and how to format requests safely.