price_deck

Prices a pasted decklist (any TCG: Magic, Pokemon, Yu-Gi-Oh, One Piece, Lorcana, and 18+ more) and returns a ready-to-buy TCGplayer cart link. Paste the raw decklist text — one card per line, quantity + name, e.g. '4x Lightning Bolt' or '2 Counterspell (7ED)'. Returns a priced table (qty, name, set, unit price, line total), a grand total, any lines that couldn't be resolved with did-you-mean suggestions, and one affiliate-wrapped buy link.

Parameters2

deck	string	required	The raw decklist text, one card per line (e.g. "4x Lightning Bolt\n2 Counterspell (7ED)").
game	string	optional	Optional game hint (e.g. 'Magic', 'Pokemon', 'Yu-Gi-Oh', 'One Piece', 'Lorcana') when the decklist is ambiguous.

Raw schema

{
  "type": "object",
  "properties": {
    "deck": {
      "description": "The raw decklist text, one card per line (e.g. \"4x Lightning Bolt\\n2 Counterspell (7ED)\").",
      "type": "string"
    },
    "game": {
      "description": "Optional game hint (e.g. 'Magic', 'Pokemon', 'Yu-Gi-Oh', 'One Piece', 'Lorcana') when the decklist is ambiguous.",
      "type": "string"
    }
  },
  "required": [
    "deck"
  ]
}

price_card

Looks up the current market price of a single TCG card (any of 22+ games: Magic, Pokemon, Yu-Gi-Oh, One Piece, Lorcana, and more). Returns the best match's price and an affiliate-wrapped TCGplayer product link, plus alternates when the name is ambiguous.

Parameters3

game	string	optional	Optional game hint (e.g. 'Magic', 'Pokemon') when the name is ambiguous across games.
name	string	required	Card name to look up.
set	string	optional	Optional set name/code to disambiguate printings.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "description": "Optional game hint (e.g. 'Magic', 'Pokemon') when the name is ambiguous across games.",
      "type": "string"
    },
    "name": {
      "description": "Card name to look up.",
      "type": "string"
    },
    "set": {
      "description": "Optional set name/code to disambiguate printings.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

list_printings

Lists every known printing of a TCG card (any of 22+ games) — every set it was printed in, with per-finish (nonfoil/foil) prices and treatment tags (border, frame, promo, full art). Use this instead of price_card when the buyer wants to compare printings, find the cheapest version, or find a specific treatment (e.g. borderless, showcase). Returns a `grouping` field: "oracle_id" means the printings are confirmed the exact same card; "normalized_name" is a best-effort name match that can occasionally over- or under-group.

Parameters6

finish	string	optional	Optional: narrow to printings available in a finish, e.g. 'foil' or 'etched'. Cannot be combined with intent=cheapest or with set/treatment.
game	string	optional	Optional game hint (e.g. 'Magic', 'Pokemon') when the name is ambiguous across games.
intent	string	optional	Optional: "all" (default) lists every printing; "cheapest" returns only the lowest-priced one. Cannot be combined with set/finish/treatment.
name	string	required	Card name to look up.
set	string	optional	Optional: narrow to a single set name/code. Cannot be combined with intent=cheapest or with finish/treatment.
treatment	string	optional	Optional: narrow to printings with a treatment/variant, e.g. 'borderless', 'showcase', 'full_art', 'boosterfun'. Cannot be combined with intent=cheapest or with set/finish.

Raw schema

{
  "type": "object",
  "properties": {
    "finish": {
      "description": "Optional: narrow to printings available in a finish, e.g. 'foil' or 'etched'. Cannot be combined with intent=cheapest or with set/treatment.",
      "type": "string"
    },
    "game": {
      "description": "Optional game hint (e.g. 'Magic', 'Pokemon') when the name is ambiguous across games.",
      "type": "string"
    },
    "intent": {
      "description": "Optional: \"all\" (default) lists every printing; \"cheapest\" returns only the lowest-priced one. Cannot be combined with set/finish/treatment.",
      "enum": [
        "all",
        "cheapest"
      ],
      "type": "string"
    },
    "name": {
      "description": "Card name to look up.",
      "type": "string"
    },
    "set": {
      "description": "Optional: narrow to a single set name/code. Cannot be combined with intent=cheapest or with finish/treatment.",
      "type": "string"
    },
    "treatment": {
      "description": "Optional: narrow to printings with a treatment/variant, e.g. 'borderless', 'showcase', 'full_art', 'boosterfun'. Cannot be combined with intent=cheapest or with set/finish.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

Tcgmcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

price_deck

price_card

list_printings

Install

Remote endpoint