agent-server-card-mcp

An MCP server for generating, validating, and discovering MCP server cards — a standardized way to describe MCP servers so AI agents can automatically find and understand them.

Server Cards are machine-readable JSON files that describe an MCP server's capabilities, similar to how robots.txt describes crawling rules or manifest.json describes web apps. They live at .well-known/mcp-server-card.json and contain:

• Name & Description — What the server does
• Tools — List of available tools with descriptions
• Author & Repository — Who built it, where to find the source
• Categories — Tags for discovery and search
• Pricing — Whether it's free, freemium, or paid
• Transport — Whether it uses stdio, HTTP, or both
• Auth — Whether authentication is required

As the MCP ecosystem grows, agents need a way to discover and evaluate servers automatically. Server Cards solve this by providing:

1. Automatic Discovery — Agents can check .well-known/mcp-server-card.json on any domain
2. Standardized Metadata — Consistent format for comparing servers
3. Capability Description — Agents know what tools are available before connecting
4. Trust Signals — Author, repository, and pricing information

pip install agent-server-card-mcp

{
  "mcpServers": {
    "server-cards": {
      "command": "server-card-server"
    }
  }
}

{
  "mcpServers": {
    "server-cards": {
      "command": "uvx",
      "args": ["agent-server-card-mcp"]
    }
  }
}

| Tool | Description | |------|-------------| | generate_card | Generate a .well-known/mcp-server-card.json for any MCP server | | validate_card | Validate a server card against the JSON schema | | discover | Try to discover a server card from a URL via .well-known | | search | Search indexed server car