Tools / Trading 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.

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

Parameters

query *stringCard name or search text (e.g. "Charizard", "Black Lotus", "Dark Magician")

gamestringWhich card game to search

limitnumberNumber of results (1-20, default 10)

pagenumberPage number for pagination (default 1)

Example

Search for Charizard Pokemon cards

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

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.

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

Parameters

card_id *stringCard ID from search results (e.g. "base1-4" for Pokemon, UUID for MTG, number for Yu-Gi-Oh)

game *stringWhich card game

Example

Get price for Base Set Charizard

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "trading-cards",
  "skill": "card_price",
  "input": {
    "card_id": "base1-4",
    "game": "pokemon"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Browse Set

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

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

Parameters

set_id *stringSet identifier — Pokemon: "base1", "sv1". MTG: "lea", "2xm". Yu-Gi-Oh: set name

game *stringWhich card game

sort_bystringSort cards by value or name

limitnumberNumber of cards to return (1-50, default 20)

Example

Browse the Base Set by value

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "trading-cards",
  "skill": "set_browse",
  "input": {
    "set_id": "base1",
    "game": "pokemon"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

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.

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

Parameters

game *stringWhich card game

raritystringFilter by rarity (e.g. "Rare Holo", "mythic", "Ultra Rare")

set_idstringFilter to a specific set ID or code

type_filterstringCard type filter (e.g. "Pokemon", "creature", "Effect Monster")

limitnumberNumber of cards (1-25, default 10)

Example

Most valuable Pokemon cards

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "trading-cards",
  "skill": "top_cards",
  "input": {
    "game": "pokemon"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Identify Card

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

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

Parameters

name *stringFull or partial card name (e.g. "chariz", "bolt", "blue eyes")

game *stringWhich card game to search

set_idstringSet ID or code to narrow search

numberstringCard number within a set (e.g. "4", "141")

Example

Identify a Pokemon card by partial name

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "trading-cards",
  "skill": "identify_card",
  "input": {
    "name": "chariz",
    "game": "pokemon"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"trading-cards","skill":"search_cards","input":{}}' \
  https://api.toolrouter.com/v1/tools/call