cardinal-mcp 0.1.0

MCP server for the Cardinal universal entity data API. Drop-in for Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-aware AI agent.

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

Tool	What it does
search_entities	Search by name + country + status + kind
get_entity	Full entity record by Cardinal ID
lookup_by_registry	Lookup by native registry id (orgnr, business id, ...)
get_entity_risk_summary	AI-generated compliance briefing
search_court_records	Bankruptcies, judgments, enforcement actions
search_officers	Cross-entity officer / director / owner search
natural_language_query	Plain-English question → structured query → rows + summary

License

MIT.