cardinal-mcp

Drop-in MCP server for the Cardinal universal entity data API. Plug Cardinal into any MCP-aware AI agent — Claude Desktop, Claude Code, Cursor, Windsurf, custom agents — and they can query Europe's entity universe natively without writing a line of HTTP code.

Install

pip install cardinal-mcp

Configure

Set two env vars and point your MCP client at the binary.

export CARDINAL_API_KEY="cardinal_live_..."   # get one at cardinal.dev
export CARDINAL_BASE_URL="https://api.cardinal.dev"   # optional, default

Claude Desktop / Claude Code

~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cardinal": {
      "command": "cardinal-mcp",
      "env": {
        "CARDINAL_API_KEY": "cardinal_live_...",
        "CARDINAL_BASE_URL": "https://api.cardinal.dev"
      }
    }
  }
}

Cursor / Windsurf

Add the same mcpServers block to your editor's MCP config. Both editors read the same shape as Claude Desktop.

Custom agent

Run cardinal-mcp as a stdio subprocess and speak JSON-RPC 2.0 over its stdin/stdout. Wire-compatible with MCP 2025-06-18.

Tools exposed

License

MIT.