Midpoint Card Prices
Trading card prices and grading ROI for 1.5M+ Pokémon, Magic, Yu-Gi-Oh! and sports cards. Read-only.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~6,224Tokens (tool definitions)
~6.6 KBTypical response size
Significant attention impact (4.86% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"card-prices": {
"url": "https://mcp.cardcenteringtool.com/mcp"
}
}
}Remote endpoints
https://mcp.cardcenteringtool.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_cards(query, game, set_id, limit)
Use this first when the user names a trading card and wants its value, price, or whether to grade it. Searches 1.5M+ Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lorcana, sports (baseball, basketball, football, hockey, soccer, wrestling, UFC and more) and entertainment cards by name, set, number and year, returning ungraded and PSA 10 market prices in USD from real sold listings. Returns card ids for get_card_prices, grading_roi and get_price_history. Do not use for sealed product, for cards you already have an id for, or for price prediction.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Card name, optionally with set, number or year. Examples: \"Umbreon VMAX Evolving Skies\", \"1986 Fleer Jordan\", \"Charizard base set 4/102\"."
},
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Restrict to one game or sport. Omit when unsure."
},
"set_id": {
"type": "string",
"maxLength": 60,
"pattern": "^[a-zA-Z0-9_.-]*$",
"description": "Expansion id from list_sets, to search inside one set."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"matched_on": {
"type": "string",
"description": "The search term that produced the results"
},
"count": {
"type": "integer"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history."
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
],
"description": "Ungraded (raw) market price in USD"
},
"psa10_market_usd": {
"type": [
"number",
"null"
],
"description": "PSA 10 market price in USD"
},
"url": {
"type": "string",
"description": "Card page with the full price ladder and history"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url"
],
"additionalProperties": false
}
},
"note": {
"type": "string"
}
},
"required": [
"query",
"matched_on",
"count",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_card_prices(card_id)
Use this when the user wants the full current value of a specific card: ungraded prices by condition (NM/LP/MP/HP) and graded prices for every company and grade on record (PSA, CGC, BGS, SGC, TAG). Requires a card id from search_cards. Prices are USD market values from real sold listings, refreshed daily. Do not use to search by name.
Input Schema
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Catalog card id from search_cards, e.g. \"swsh7-215\" or \"pricecharting-1821843\"."
}
},
"required": [
"card_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"card": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"set_release_date": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"rarity",
"set_release_date"
],
"additionalProperties": false
},
"currency": {
"type": "string",
"const": "USD"
},
"captured_on": {
"type": [
"string",
"null"
],
"description": "Date of the latest price capture (UTC)"
},
"variant": {
"type": [
"string",
"null"
],
"description": "The printing the raw and graded rungs refer to (e.g. \"holofoil\", \"1st edition\"). Other printings are listed under other_variants."
},
"raw_note": {
"type": [
"string",
"null"
],
"description": "Set when the raw condition ladder is out of order (thin data): treat raw prices as low confidence."
},
"raw": {
"type": "array",
"items": {
"type": "object",
"properties": {
"condition": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
},
"low_usd": {
"type": [
"number",
"null"
]
},
"high_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"condition",
"market_usd",
"low_usd",
"high_usd"
],
"additionalProperties": false
}
},
"graded": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"company",
"grade",
"market_usd"
],
"additionalProperties": false
}
},
"other_variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variant": {
"type": "string"
},
"raw": {
"type": "array",
"items": {
"type": "object",
"properties": {
"condition": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
},
"low_usd": {
"type": [
"number",
"null"
]
},
"high_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"condition",
"market_usd",
"low_usd",
"high_usd"
],
"additionalProperties": false
}
},
"graded": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"company",
"grade",
"market_usd"
],
"additionalProperties": false
}
}
},
"required": [
"variant",
"raw",
"graded"
],
"additionalProperties": false
},
"description": "Other printings of the same card id (reverse holo, 1st edition…) with their own prices. Never mix these with the main ladder."
},
"summary": {
"type": "object",
"properties": {
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"psa9_usd": {
"type": [
"number",
"null"
]
},
"psa10_usd": {
"type": [
"number",
"null"
]
},
"best_graded_usd": {
"type": [
"number",
"null"
]
},
"change_30d_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"best_graded_usd",
"change_30d_pct"
],
"additionalProperties": false
},
"links": {
"type": "object",
"properties": {
"card_page": {
"type": "string"
},
"worth_grading": {
"type": "string"
}
},
"required": [
"card_page",
"worth_grading"
],
"additionalProperties": false
}
},
"required": [
"card",
"currency",
"captured_on",
"variant",
"raw_note",
"raw",
"graded",
"other_variants",
"summary",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢grading_roi(card_id, grading_fee_usd)
Use this when the user asks whether a card is worth grading, submitting to PSA/CGC/BGS/SGC/TAG, or what a PSA 10 adds. Returns raw vs PSA 9 vs PSA 10 market prices, the gem premium, net profit after grading fees per outcome, expected value by gem probability, the break-even gem rate, which company pays most, and a plain-language verdict. Requires a card id from search_cards. It does not assess the condition of the user's copy.
Input Schema
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Catalog card id from search_cards."
},
"grading_fee_usd": {
"type": "number",
"minimum": 0,
"maximum": 5000,
"description": "Grading fee to assume. Defaults to a $25 economy tier; the table also shows $50 and $150."
}
},
"required": [
"card_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"card": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"game",
"set",
"number"
],
"additionalProperties": false
},
"currency": {
"type": "string",
"const": "USD"
},
"captured_on": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"psa9_usd": {
"type": [
"number",
"null"
]
},
"psa10_usd": {
"type": [
"number",
"null"
]
},
"gem_premium_multiple": {
"type": [
"number",
"null"
],
"description": "PSA 10 price ÷ raw price"
},
"verdict": {
"anyOf": [
{
"type": "object",
"properties": {
"tone": {
"type": "string",
"enum": [
"strong",
"conditional",
"weak"
]
},
"headline": {
"type": "string"
},
"body": {
"type": "string"
}
},
"required": [
"tone",
"headline",
"body"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"top_grade_by_company": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"value_usd": {
"type": "number"
},
"centering_tolerance_front": {
"type": "string"
},
"centering_tolerance_back": {
"type": "string"
}
},
"required": [
"company",
"grade",
"value_usd",
"centering_tolerance_front",
"centering_tolerance_back"
],
"additionalProperties": false
}
},
"net_after_fee": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"type": "string"
},
"sale_usd": {
"type": "number"
},
"net_usd_by_fee": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fee_usd": {
"type": "number"
},
"net_usd": {
"type": "number"
}
},
"required": [
"fee_usd",
"net_usd"
],
"additionalProperties": false
}
}
},
"required": [
"outcome",
"sale_usd",
"net_usd_by_fee"
],
"additionalProperties": false
}
},
"expected_value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"gem_probability": {
"type": "number"
},
"expected_sale_usd": {
"type": "number"
},
"expected_net_usd": {
"type": "number"
}
},
"required": [
"gem_probability",
"expected_sale_usd",
"expected_net_usd"
],
"additionalProperties": false
}
},
"break_even_gem_probability": {
"type": [
"number",
"null"
],
"description": "Chance of a PSA 10 needed to break even at the assumed fee; null when grading never breaks even"
},
"assumed_fee_usd": {
"type": "number"
},
"links": {
"type": "object",
"properties": {
"worth_grading": {
"type": "string"
},
"card_page": {
"type": "string"
},
"measure_centering": {
"type": "string"
}
},
"required": [
"worth_grading",
"card_page",
"measure_centering"
],
"additionalProperties": false
}
},
"required": [
"card",
"currency",
"captured_on",
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"gem_premium_multiple",
"verdict",
"top_grade_by_company",
"net_after_fee",
"expected_value",
"break_even_gem_probability",
"assumed_fee_usd",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_price_history(card_id, days, grade)
Use this when the user asks how a card's price has changed over weeks or months, or wants a trend for the raw or a PSA-graded series. Returns dated USD market values for the last 7 to 180 days. Requires a card id from search_cards. Do not use for forecasts.
Input Schema
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Catalog card id from search_cards."
},
"days": {
"type": "integer",
"minimum": 7,
"maximum": 180,
"default": 90
},
"grade": {
"type": "string",
"maxLength": 10,
"description": "PSA grade for a graded series, e.g. \"10\" or \"9\". Omit for the raw (ungraded) series."
}
},
"required": [
"card_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"card_id": {
"type": "string"
},
"name": {
"type": "string"
},
"series": {
"type": "string",
"description": "\"raw\" or \"PSA <grade>\""
},
"variant": {
"type": [
"string",
"null"
],
"description": "The printing the series follows (e.g. \"holofoil\"); other printings are separate markets and are never mixed in."
},
"days": {
"type": "integer"
},
"coverage": {
"type": "object",
"properties": {
"days_with_data": {
"type": "integer"
},
"note": {
"type": "string"
}
},
"required": [
"days_with_data",
"note"
],
"additionalProperties": false,
"description": "How many of the requested days have a capture, and how to read repeated or sparse values."
},
"currency": {
"type": "string",
"const": "USD"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"date",
"market_usd"
],
"additionalProperties": false
},
"description": "Oldest first. Graded series only contain days with sales; gaps are normal."
},
"first_usd": {
"type": [
"number",
"null"
]
},
"last_usd": {
"type": [
"number",
"null"
]
},
"change_pct": {
"type": [
"number",
"null"
],
"description": "First-to-last change; null when change_note is set because a single step carries it."
},
"change_note": {
"type": [
"string",
"null"
],
"description": "Set when one step between consecutive captures accounts for the change: usually a data correction, not a market move. change_pct is null in that case."
},
"source": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"card_page": {
"type": "string"
}
},
"required": [
"card_page"
],
"additionalProperties": false
}
},
"required": [
"card_id",
"name",
"series",
"variant",
"days",
"coverage",
"currency",
"points",
"first_usd",
"last_usd",
"change_pct",
"change_note",
"source",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢best_cards_to_grade(game, set_slug, grading_fee_usd, limit)
Use this when the user asks which cards in a game, sport or set have the biggest payoff from grading. Ranks priced cards by expected net profit at a 50% gem rate (half PSA 10, half PSA 9, minus raw and the fee), requiring both PSA 9 and PSA 10 prices so thin-market outliers are excluded. Returns card ids for grading_roi. Do not use for a single named card.
Input Schema
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Game or sport to rank."
},
"set_slug": {
"type": "string",
"maxLength": 80,
"pattern": "^[a-z0-9-]*$",
"description": "Optional set slug (as used on /sets/<game>/<slug>) to rank inside one set."
},
"grading_fee_usd": {
"type": "number",
"minimum": 0,
"maximum": 5000,
"description": "Grading fee to assume. Defaults to $25."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 12
}
},
"required": [
"game"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"game": {
"type": "string"
},
"criteria": {
"type": "string"
},
"assumed_fee_usd": {
"type": "number"
},
"count": {
"type": "integer"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": "number"
},
"psa9_usd": {
"type": "number"
},
"psa10_usd": {
"type": "number"
},
"expected_net_usd_at_50pct_gem": {
"type": "number",
"description": "0.5 × PSA 10 + 0.5 × PSA 9 − raw − fee"
},
"gem_premium_multiple": {
"type": [
"number",
"null"
],
"description": "PSA 10 ÷ raw"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"set",
"number",
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"expected_net_usd_at_50pct_gem",
"gem_premium_multiple",
"url"
],
"additionalProperties": false
}
},
"links": {
"type": "object",
"properties": {
"worth_grading_index": {
"type": "string"
}
},
"required": [
"worth_grading_index"
],
"additionalProperties": false
}
},
"required": [
"game",
"criteria",
"assumed_fee_usd",
"count",
"cards",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢trending_cards(game, direction, min_market_usd, limit)
Use this when the user asks which cards are rising, hot, spiking, crashing or trending, in one game or across all games. Returns the biggest 30-day gainers (or drops) with the percentage change, measured on the PSA 10 price where the card has one and on the raw price otherwise; moves over 300% are excluded as bad data. Do not use for a single named card or for long-term history.
Input Schema
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Restrict to one game or sport; omit for all."
},
"direction": {
"type": "string",
"enum": [
"up",
"down"
],
"default": "up",
"description": "\"up\" = biggest gainers, \"down\" = biggest drops."
},
"min_market_usd": {
"type": "number",
"minimum": 0.5,
"maximum": 1000,
"default": 5,
"description": "Ignore cards whose raw price is below this."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 15
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"window_days": {
"type": "number",
"const": 30
},
"direction": {
"type": "string",
"enum": [
"up",
"down"
]
},
"game": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"excluded_unstable": {
"type": "integer",
"description": "Candidates dropped because their own 40-day series did not hold together (too few captures, a baseline that swings >2×, a >6× range, or a one-capture jump)."
},
"criteria": {
"type": "string"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"basis": {
"type": "string",
"enum": [
"PSA 10",
"raw"
],
"description": "Which price series the change refers to"
},
"price_30d_ago_usd": {
"type": "number"
},
"price_now_usd": {
"type": "number"
},
"change_30d_pct": {
"type": "number"
},
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"psa10_market_usd": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"basis",
"price_30d_ago_usd",
"price_now_usd",
"change_30d_pct",
"raw_market_usd",
"psa10_market_usd",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"window_days",
"direction",
"game",
"count",
"excluded_unstable",
"criteria",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢liquid_movers(game, include_unknown_volume, limit)
Use this when the user wants cards that are both rising in price and easy to sell: recent gainers filtered to cards with at least 25 recorded sales a year and a raw price of at least $5, across all games and sports. Better than trending_cards for flipping or selling decisions. Do not use for a single named card.
Input Schema
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Restrict to one game or sport; omit for all."
},
"include_unknown_volume": {
"type": "boolean",
"default": false,
"description": "Also include cards whose yearly sales count is not tracked (mostly Pokémon from the Scrydex source). Off by default so every result has a verifiable sales figure."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 15
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": "string",
"description": "When this ranking was computed (ISO 8601)"
},
"criteria": {
"type": "string"
},
"count": {
"type": "integer"
},
"volume_verified": {
"type": "boolean",
"description": "False when the list had to include cards whose yearly sales count is not tracked (Pokémon and other Scrydex-sourced games have no volume data)."
},
"excluded_unstable": {
"type": "integer",
"description": "Candidates dropped because their own 40-day raw series did not hold together."
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history."
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
],
"description": "Ungraded (raw) market price in USD"
},
"psa10_market_usd": {
"type": [
"number",
"null"
],
"description": "PSA 10 market price in USD"
},
"url": {
"type": "string",
"description": "Card page with the full price ladder and history"
},
"change_pct": {
"type": [
"number",
"null"
]
},
"sales_per_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Recorded sales in the last year; null only when include_unknown_volume is on and the source does not track volume."
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url",
"change_pct",
"sales_per_year"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"criteria",
"count",
"volume_verified",
"excluded_unstable",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_sets(game, query, limit)
Use this to find the set id for a game or sport (e.g. "Evolving Skies", "2019 Panini Prizm") before calling get_set_cards, or when the user asks which sets exist. Newest first. Do not use to price a single card.
Input Schema
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
]
},
"query": {
"type": "string",
"maxLength": 60,
"description": "Optional substring to filter set names, e.g. \"evolving\" or \"2019 prizm\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 30
}
},
"required": [
"game"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"game": {
"type": "string"
},
"count": {
"type": "integer"
},
"sets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"set_id": {
"type": "string",
"description": "Pass to get_set_cards or search_cards.set_id"
},
"name": {
"type": [
"string",
"null"
]
},
"release_date": {
"type": [
"string",
"null"
]
},
"card_count": {
"type": "integer"
}
},
"required": [
"set_id",
"name",
"release_date",
"card_count"
],
"additionalProperties": false
}
},
"links": {
"type": "object",
"properties": {
"sets_index": {
"type": "string"
}
},
"required": [
"sets_index"
],
"additionalProperties": false
}
},
"required": [
"game",
"count",
"sets",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_set_cards(game, set_id, sort, limit)
Use this when the user wants the most valuable cards in a specific set or a priced checklist of a set. Requires a set id from list_sets. Returns raw and PSA 10 USD prices per card. Do not use for a single named card; use search_cards instead.
Input Schema
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
]
},
"set_id": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"pattern": "^[a-zA-Z0-9_.-]+$",
"description": "Expansion id from list_sets."
},
"sort": {
"type": "string",
"enum": [
"value",
"number"
],
"default": "value",
"description": "\"value\" = most valuable first; \"number\" = checklist order."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"game",
"set_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"game": {
"type": "string"
},
"set_id": {
"type": "string"
},
"set_name": {
"type": [
"string",
"null"
]
},
"total_cards": {
"type": "integer"
},
"count": {
"type": "integer"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history."
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
],
"description": "Ungraded (raw) market price in USD"
},
"psa10_market_usd": {
"type": [
"number",
"null"
],
"description": "PSA 10 market price in USD"
},
"url": {
"type": "string",
"description": "Card page with the full price ladder and history"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"game",
"set_id",
"set_name",
"total_cards",
"count",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence
Recent observations
verifiedversion not recorded9 tools
verifiedversion not recorded9 tools
verifiedversion not recorded9 tools