---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/trading-cards
---
# Trading Cards

Look up trading card prices, details, and set info across Pokemon TCG, Magic: The Gathering, and Yu-Gi-Oh. Search by card name, browse sets, compare prices across marketplaces, and identify cards from partial info.

- **Version:** 0.01
- **Categories:** data, search
- **Workflow:** search_cards → card_price → set_browse → card_price → top_cards → identify_card → card_price

## Skills (5)

### Search Cards (`search_cards`)

Search for trading cards by name across Pokemon TCG, Magic: The Gathering, or Yu-Gi-Oh. Returns card details, images, and market prices.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Card name or search text (e.g. "Charizard", "Black Lotus", "Dark Magician") |
| `game` | string | No | Which card game to search (pokemon, mtg, yugioh) [default: "pokemon"] |
| `limit` | number | No | Number of results (1-20, default 10) [default: 10] |
| `page` | number | No | Page number for pagination (default 1) [default: 1] |

**Returns:** Matching cards with names, sets, rarities, images, and market prices from TCGPlayer and CardMarket

**Examples:**

*Search for Charizard Pokemon cards:*

```json
{
  "query": "Charizard",
  "game": "pokemon"
}
```

*Find Magic Lightning Bolt cards:*

```json
{
  "query": "Lightning Bolt",
  "game": "mtg"
}
```

*Look up Yu-Gi-Oh Blue-Eyes White Dragon:*

```json
{
  "query": "Blue-Eyes White Dragon",
  "game": "yugioh"
}
```

### Card Price (`card_price`)

Get detailed pricing for a specific card including prices by condition, foil variants, and purchase links. Use a card_id from search results.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `card_id` | string | Yes | Card ID from search results (e.g. "base1-4" for Pokemon, UUID for MTG, number for Yu-Gi-Oh) |
| `game` | string | Yes | Which card game (pokemon, mtg, yugioh) [default: "pokemon"] |

**Returns:** Full price breakdown by condition and variant with purchase links to TCGPlayer and CardMarket

**Examples:**

*Get price for Base Set Charizard:*

```json
{
  "card_id": "base1-4",
  "game": "pokemon"
}
```

*Get Yu-Gi-Oh card price:*

```json
{
  "card_id": "46986414",
  "game": "yugioh"
}
```

### Browse Set (`set_browse`)

Browse all cards in a specific set, sorted by value. Find the most valuable pulls or check set composition.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `set_id` | string | Yes | Set identifier — Pokemon: "base1", "sv1". MTG: "lea", "2xm". Yu-Gi-Oh: set name |
| `game` | string | Yes | Which card game (pokemon, mtg, yugioh) [default: "pokemon"] |
| `sort_by` | string | No | Sort cards by value or name (value, number, name) [default: "value"] |
| `limit` | number | No | Number of cards to return (1-50, default 20) [default: 20] |

**Returns:** Cards in the set sorted by value with prices, rarities, and images

**Examples:**

*Browse the Base Set by value:*

```json
{
  "set_id": "base1",
  "game": "pokemon"
}
```

*Browse Alpha Edition MTG cards:*

```json
{
  "set_id": "lea",
  "game": "mtg"
}
```

### Top Cards (`top_cards`)

Find the most valuable or popular cards for a game. Filter by rarity, type, or set to discover what is worth the most.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `game` | string | Yes | Which card game (pokemon, mtg, yugioh) [default: "pokemon"] |
| `rarity` | string | No | Filter by rarity (e.g. "Rare Holo", "mythic", "Ultra Rare") |
| `set_id` | string | No | Filter to a specific set ID or code |
| `type_filter` | string | No | Card type filter (e.g. "Pokemon", "creature", "Effect Monster") |
| `limit` | number | No | Number of cards (1-25, default 10) [default: 10] |

**Returns:** Most valuable cards sorted by market price descending with images, rarities, and set info

**Examples:**

*Most valuable Pokemon cards:*

```json
{
  "game": "pokemon"
}
```

*Top mythic MTG cards:*

```json
{
  "game": "mtg",
  "rarity": "mythic"
}
```

*Most expensive Yu-Gi-Oh cards:*

```json
{
  "game": "yugioh"
}
```

### Identify Card (`identify_card`)

Identify a card from partial information — a name fragment, set number, or vague description. Helpful when the user has incomplete details.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | string | Yes | Full or partial card name (e.g. "chariz", "bolt", "blue eyes") |
| `game` | string | Yes | Which card game to search (pokemon, mtg, yugioh) [default: "pokemon"] |
| `set_id` | string | No | Set ID or code to narrow search |
| `number` | string | No | Card number within a set (e.g. "4", "141") |

**Returns:** Best matching cards with full details, images, and prices based on the partial information provided

**Examples:**

*Identify a Pokemon card by partial name:*

```json
{
  "name": "chariz",
  "game": "pokemon"
}
```

*Find a card by partial name in MTG:*

```json
{
  "name": "bolt",
  "game": "mtg"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call trading-cards search_cards --query Charizard --game pokemon

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"trading-cards","skill":"search_cards","input":{"query":"Charizard","game":"pokemon"}}' \
     https://api.toolrouter.com/v1/tools/call
```

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs