Midpoint Card Prices
Trading card prices and grading ROI for 1.5M+ Pokémon, Magic, Yu-Gi-Oh! and sports cards. Read-only.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~6,224Tokens (definiciones de herramientas)
~6.6 KBTamaño de respuesta típico
Impacto significativo en la atención (4.86% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"card-prices": {
"url": "https://mcp.cardcenteringtool.com/mcp"
}
}
}Puntos de conexión remotos
https://mcp.cardcenteringtool.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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#"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada9 herramientas
verificadoversión no registrada9 herramientas