CardShowData MCP Server

Model Context Protocol server for the CardShowData TCG pricing API. Lets AI assistants (Claude Desktop, Claude Code, ChatGPT, Cursor, etc.) answer questions like "What's a Base Set Charizard worth?" or "Which Pokemon cards spiked this week?" with live pricing data.

Install

The recommended way is via uvx, which fetches and runs the latest published version with no setup:

uvx cardshowdata-mcp

You'll need a free API key — sign up at cardshowdata.com.

Configure in Claude Desktop / Claude Code

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cardshowdata": {
      "command": "uvx",
      "args": ["cardshowdata-mcp"],
      "env": {
        "CSD_API_KEY": "your_api_key"
      }
    }
  }
}

Restart Claude Desktop. The 14 tools below become available immediately.

Tools

Configuration

Notes

• All prices are integer cents (market_price_cents, recommended_list_price_cents, etc.). Cardmarket entries are EUR; everything else is USD — distinguished by the currency field.
• Pricing is per-variant. A Base Set Charizard's 1st-edition holofoil and unlimited holofoil have very different fair values; always inspect every entry in variants[].
• Errors use a stable envelope ({error: {type, code, message, status, request_id, doc_url, details}}). Pass error.code to explain_api_error for handling guidance.

Develop locally

git clone https://github.com/cardshowdata/cardshowdata
cd cardshowdata/packages/mcp
uv sync
uv run pytest

License

MIT