Midpoint Card Prices
Trading card prices and grading ROI for 1.5M+ Pokémon, Magic, Yu-Gi-Oh! and sports cards. Read-only.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~6,224トークン数（ツール定義）
~6.6 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 4.86%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"card-prices": {
"url": "https://mcp.cardcenteringtool.com/mcp"
}
}
}リモートエンドポイント
https://mcp.cardcenteringtool.com/mcpstreamable-httpできること
ツール一覧
ツール（9）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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.
入力スキーマ
{
"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#"
}出力スキーマ
{
"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#"
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 9 件
検証済みバージョンは記録されていませんツール 9 件
検証済みバージョンは記録されていませんツール 9 件