TCG Price Intelligence MCP Server

MCP server that aggregates trading card game data and prices from 3 free APIs:

• Pokemon TCG via pokemontcg.io
• Yu-Gi-Oh! via YGOProDeck
• Magic: The Gathering via Scryfall

Tools

| Tool | Description | |------|-------------| | search-card | Cross-TCG card search by name, set, or game | | get-price | Current market price (USD/EUR) for a specific card | | price-history | Price snapshot (current only — no free API provides true historical data) | | collection-value | Bulk card list valuation with per-card and total values | | set-overview | All cards in a set with prices (paginated, max 50 per page) |

Installation

# Global install
npm install -g tcg-price-mcp

# Or clone and build
git clone <repo-url>
cd tcg-price-mcp
npm install
npm run build

Usage

# Start MCP server (cached mode — uses fixtures, no network needed)
tcg-price-mcp

# Start MCP server (live mode — calls real APIs)
tcg-price-mcp --live

# Test with MCP Inspector
npx @modelcontextprotocol/inspector tcg-price-mcp

Claude Desktop / Smithery Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "tcg-price-mcp": {
      "command": "npx",
      "args": ["-y", "tcg-price-mcp"]
    }
  }
}

For live API mode:

{
  "mcpServers": {
    "tcg-price-mcp": {
      "command": "npx",
      "args": ["-y", "tcg-price-mcp", "--live"]
    }
  }
}

Configuration

Optional environment variables:

| Variable | Description | |----------|-------------| | POKEMON_TCG_API_KEY | pokemontcg.io API key for higher rate limits (optional, 20K/day without key) |

Development

npm install
npm run build
npm test           # Run tests (cached mode, no network)
npm run lint       # ESLint
npm run format     # Prettier

Fixture Cache

Default mode (--cached) reads from ./fixtures/. This allows tests and development without network access.

Use --live flag to fetch from real APIs and update fixtures.

API Rate Limits

• pokemontcg.io: 20,000 requests/day (higher with API key)
• Scryfall: 10 requests/second (100ms polite delay between requests)
• YGOProDeck: No authentication required, no published rate limits

All providers implement retry with exponential backoff for 5xx and rate limit responses.

License

MIT