Serveur MCP
POKEKA — Pokémon Card Prices
xyz.pokeka/card-prices
Ce que fait ce MCP
Searches Pokémon cards and reports verified graded-card prices, sales history, market movements, population data, and set statistics.
Capacités
Outils
14
outils
card_pop
Population report
Graded population for one card: PSA population by grade (total / 10 / 9 / 8), CCIC population (total / 10 / 9.5 / 9), PSA gem rate and scarcity tier when available. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['card_id'], 'properties': {'card_id': {'type': 'string', 'description': 'Card id from search_card / slang_lookup.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'psa': {'type': 'object', 'properties': {'pop8': {'type': 'number'}, 'pop9': {'type': 'number'}, 'pop10': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': True}, 'ccic': {'type': 'object', 'properties': {'pop9': {'type': 'number'}, 'pop10': {'type': 'number'}, 'total': {'type': 'number'}, 'pop9_5': {'type': 'number'}}, 'additionalProperties': True}, 'note': {'type': 'string'}, 'card_id': {'type': 'string'}, 'gem_rate': {'type': 'number'}, 'gem_rate_band': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'scarcity_tier': {'type': 'string'}}, 'additionalProperties': True}
card_price
Card price
Use when the user asks what a card is worth, its PSA 10 / PSA 9 / CCIC 10 price, current market value, or what it last sold for. Returns a headline price (USD/CNY/JPY) from verified real sales (robust median — never listings, never interpolated) with grading company, grade, sample size, window and confidence, plus a per-grade ladder (PSA 10/9/8, CCIC, BGS, CGC …). Pass company + grade to price a specific grade (e.g. company "PSA", grade "9"); if that grade has no data the response says price_status "grade_not_available" and does NOT fall back to PSA 10. price_status "reference_only" = low confidence or thin sample — quote it with that caveat (safe_to_quote=false). "card_not_found" = wrong id, search again. Markets are kept separate: Japanese cards with Japan-domestic activity are priced from JPY marketplace sales (not converted US prices), Simplified-Chinese cards from Chinese market sales including CCIC slabs. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['card_id'], 'properties': {'grade': {'type': 'string', 'description': 'Optional grade to price, e.g. "10", "9.5", "9". Use with company. No fallback to another grade.'}, 'card_id': {'type': 'string', 'description': 'Card id from search_card / slang_lookup. An exact community nickname (e.g. "moonbreon", "鬼皮") also resolves when it maps to exactly one card.'}, 'company': {'enum': ['PSA', 'BGS', 'CGC', 'CCIC', 'ARS', 'SGC', 'PCG'], 'type': 'string', 'description': 'Optional grading company to price, e.g. "PSA". Use with grade.'}, 'condition': {'enum': ['graded', 'raw'], 'type': 'string', 'description': '"raw" = the user asked for an ungraded card. Raw prices are not offered yet; the response says so instead of returning a graded price.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'card': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'note': {'type': 'string'}, 'fx_as_of': {'type': 'string'}, 'headline': {'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'snapshot date of a reference (non-sale) price — quote it as of this date, not as today'}, 'grade': {'type': 'string'}, 'finish': {'type': 'string'}, 'market': {'type': 'string', 'description': 'Which market this sale actually happened in (USD/CNY/JPY). The other two currency fields are convenience conversions at current FX rates, NOT prices observed in those markets. A USD-market sale quoted in CNY does not mean the card trades at that price in China.'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'last_sold': {'type': 'string'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_date': {'type': 'string'}, 'confidence': {'type': 'string'}, 'estimate_max_date': {'type': 'string', 'description': 'Latest sale included in a historical estimate; not the newest source sale.'}, 'estimate_min_date': {'type': 'string'}}, 'description': 'omitted when there is no verified headline price — read price_status', 'additionalProperties': True}, 'reference': {'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'snapshot date of a reference (non-sale) price — quote it as of this date, not as today'}, 'grade': {'type': 'string'}, 'finish': {'type': 'string'}, 'market': {'type': 'string', 'description': 'Which market this sale actually happened in (USD/CNY/JPY). The other two currency fields are convenience conversions at current FX rates, NOT prices observed in those markets. A USD-market sale quoted in CNY does not mean the card trades at that price in China.'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'last_sold': {'type': 'string'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_date': {'type': 'string'}, 'confidence': {'type': 'string'}, 'estimate_max_date': {'type': 'string', 'description': 'Latest sale included in a historical estimate; not the newest source sale.'}, 'estimate_min_date': {'type': 'string'}}, 'additionalProperties': True}, 'grade_ladder': {'type': 'array', 'items': {'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'snapshot date of a reference (non-sale) price — quote it as of this date, not as today'}, 'grade': {'type': 'string'}, 'finish': {'type': 'string'}, 'market': {'type': 'string', 'description': 'Which market this sale actually happened in (USD/CNY/JPY). The other two currency fields are convenience conversions at current FX rates, NOT prices observed in those markets. A USD-market sale quoted in CNY does not mean the card trades at that price in China.'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'last_sold': {'type': 'string'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_date': {'type': 'string'}, 'confidence': {'type': 'string'}, 'estimate_max_date': {'type': 'string', 'description': 'Latest sale included in a historical estimate; not the newest source sale.'}, 'estimate_min_date': {'type': 'string'}}, 'additionalProperties': True}}, 'price_status': {'enum': ['ok', 'reference_only', 'insufficient_data', 'price_withheld_quality_gate', 'card_not_found', 'unreleased', 'grade_not_available', 'unsupported_market_type'], 'type': 'string'}, 'last_sold_date': {'type': 'string'}, 'headline_confidence': {'type': 'string'}}, 'additionalProperties': True}
card_price_history
Card price history
Weekly median price series for one card (representative grade, up to 26 weeks) plus 30d/90d change percentages (only shown when statistically confident). Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['card_id'], 'properties': {'weeks': {'type': 'integer', 'maximum': 26, 'minimum': 1, 'description': 'How many recent weeks (default 26, max 26).'}, 'card_id': {'type': 'string', 'description': 'Card id from search_card / slang_lookup.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'week': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'median_usd': {'type': 'number'}}, 'additionalProperties': True}}, 'card_id': {'type': 'string'}, 'point_count': {'type': 'number'}, 'change_pct_30d': {'type': 'number'}, 'change_pct_90d': {'type': 'number'}, 'weeks_requested': {'type': 'number'}}, 'additionalProperties': True}
get_account_access
Connect POKEKA account and check access
Connect the user's existing POKEKA account or check its current access permissions. Use when the user explicitly asks to connect, sign in, or check their POKEKA account access (连接账号、登录、查看账号权限). Requires POKEKA OAuth; if not connected, return the account-linking challenge and retry after authorization. Public card and market queries do not require this tool. Returns the existing access tier and connection-management link, never credentials or personal identifiers. Does not purchase or change a plan. Calls update token activity and may record internal usage statistics.
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'connected': {'type': 'boolean'}, 'access_tier': {'enum': ['free', 'pro_trial', 'pro'], 'type': 'string'}, 'detailed_market_data': {'type': 'boolean', 'description': 'Whether the linked account currently has access to detailed market data; individual tool limits still apply.'}, 'manage_connection_url': {'type': 'string', 'description': 'POKEKA account page where the user can manage or revoke this connection.'}}, 'additionalProperties': True}
get_card_context
Card context
Everything around one card beyond the price: community nicknames (圈内叫法), counterfeit-risk flags with self-check steps, holder-turnover tier (locked vs high-churn), and a curated context note — plus the headline price. Accepts card_id or an exact nickname via query (e.g. "凡高皮", "金拱门"). Absence of flags is not a clearance; coverage is curated and growing. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Alternative to card_id: an exact community nickname or alias.'}, 'card_id': {'type': 'string', 'description': 'Card id from search_card / slang_lookup.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'card': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'note': {'type': 'string'}, 'headline': {'type': 'object', 'properties': {'grade': {'type': 'string'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}}, 'additionalProperties': True}, 'last_sale': {'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'Always quote this caveat with the number — it is one sale, not a valuation.'}, 'grade': {'type': 'string'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_date': {'type': 'string'}}, 'additionalProperties': True}, 'nicknames': {'type': 'array', 'items': {'type': 'string'}}, 'reference': {'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'snapshot date of a reference (non-sale) price — quote it as of this date, not as today'}, 'grade': {'type': 'string'}, 'finish': {'type': 'string'}, 'market': {'type': 'string', 'description': 'Which market this sale actually happened in (USD/CNY/JPY). The other two currency fields are convenience conversions at current FX rates, NOT prices observed in those markets. A USD-market sale quoted in CNY does not mean the card trades at that price in China.'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'last_sold': {'type': 'string'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_date': {'type': 'string'}, 'confidence': {'type': 'string'}, 'estimate_max_date': {'type': 'string', 'description': 'Latest sale included in a historical estimate; not the newest source sale.'}, 'estimate_min_date': {'type': 'string'}}, 'additionalProperties': True}, 'price_note': {'type': 'string'}, 'risk_flags': {'type': 'array', 'items': {'type': 'object', 'properties': {'note': {'type': 'string'}, 'type': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': True}}, 'context_note': {'type': 'string'}, 'price_status': {'type': 'string'}, 'release_date': {'type': 'string'}, 'hoarding_tier': {'enum': ['high_churn', 'mid', 'locked'], 'type': 'string'}, 'has_risk_flags': {'type': 'boolean'}, 'context_coverage_note': {'type': 'string'}}, 'additionalProperties': True}
get_market_brief
Market brief
Where the graded-Pokémon market stands in its cycle, per language track (all / en / ja): a one-line phase read backed by a fixed-basket same-card index (never vibes), peak/drawdown numbers, weekly verified-sale counts, and an upcoming release/event calendar. Not investment advice. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'properties': {'market': {'enum': ['all', 'en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Track, default all.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'as_of': {'type': 'string'}, 'phase': {'type': 'string'}, 'market': {'type': 'string'}, 'basket_size': {'type': 'number'}, 'index_level': {'type': 'number'}, 'tx_7d_count': {'type': 'number'}, 'upcoming_events': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'text': {'type': 'string'}, 'type': {'type': 'string'}}, 'additionalProperties': True}}, 'change_from_base': {'type': 'number'}, 'drawdown_from_peak': {'type': 'number'}}, 'additionalProperties': True}
get_set_overview
Set overview & checklist
Whole-set statistics for one Pokémon TCG set: total cards, per-language-track counts, breakdown by rarity (with EN star-system + JP-style display names) and by variant (Master Ball / Poké Ball mirror slots etc.), top featured Pokémon, plus a paginated card checklist. 中文用户: 一次拿到整个系列的卡表统计(总卡数/每稀有度几张/每变体几张/出场宝可梦), 不用逐张搜。Use for questions like "how many cards / SR cards are in 151c". Accepts internal set_code, official abbreviation (CEL) or set name. Catalog data only — for the most valuable cards in a set use set_top_priced_cards; per-card prices via card_price. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['set_code'], 'properties': {'lang': {'enum': ['en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Optional language track filter — same code can be different products per track.'}, 'page': {'type': 'number', 'description': 'Checklist page (0-based). Anonymous/free tier: 20 cards/page, first 2 pages; Pro: 50/page (whole-set sweeps are rate-guarded).'}, 'set_code': {'type': 'string', 'description': 'Set code, official abbreviation, or set name (e.g. "151c", "sv2a", "CEL", "Celebrations").'}}}
Schéma de sortie
{'type': 'object', 'properties': {'lang': {'type': 'string'}, 'note': {'type': 'string'}, 'by_lang': {'type': 'object'}, 'guidance': {'type': 'string'}, 'set_code': {'type': 'string'}, 'by_rarity': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'tier': {'type': 'string'}, 'display_en': {'type': 'string'}, 'display_cjk': {'type': 'string'}}, 'additionalProperties': True}}, 'checklist': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}}, 'by_variant': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'variant': {'type': 'string'}}, 'additionalProperties': True}}, 'top_species': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'character': {'type': 'string'}}, 'additionalProperties': True}}, 'total_cards': {'type': 'number'}, 'species_note': {'type': 'string'}, 'checklist_page': {'type': 'number'}, 'checklist_capped': {'type': 'boolean'}, 'checklist_page_size': {'type': 'number'}}, 'additionalProperties': True}
market_movers
Market movers
Use when the user asks which Pokémon cards are rising or falling, what is hot, or the biggest moves this week/month. lang = "en" / "ja" / "zh-cn" (market tracks never mix). direction = "up" (cards rising) or "down" (cards falling), default "up". window = "7d" / "30d" / "90d"; omit to use the default window published for that track. Every row passes a liquidity gate — at least 5 verified sales in both the current and the base window, change capped at ±40%, both medians consistent with the card's reference price — and carries price_now / price_base / n_cur / n_prev, so a listed move is a real same-card, same-grade move. Up to 20 cards. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['lang'], 'properties': {'lang': {'enum': ['en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Market track: "en", "ja" or "zh-cn".'}, 'window': {'enum': ['7d', '30d', '90d'], 'type': 'string', 'description': 'Change window: "7d", "30d" or "90d". Omit to use the default window published for that track.'}, 'direction': {'enum': ['up', 'down'], 'type': 'string', 'description': '"up" = cards rising, "down" = cards falling. Default "up".'}}}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'market': {'type': 'string'}, 'movers': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'number'}, 'grade': {'type': 'string', 'description': 'Representative grade being compared (e.g. "PSA 10") — pools never mix grades.'}, 'card_id': {'type': 'string'}, 'card_url': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'price_basis': {'enum': ['verified_sales', 'reference'], 'type': 'string', 'description': '"reference" = price_usd is a PriceCharting aggregate, NOT our verified sales — say so when quoting it.'}, 'sales_in_window': {'type': 'number'}}, 'additionalProperties': True}}, 'window': {'type': 'string'}, 'direction': {'type': 'string'}, 'anchor_date': {'type': 'string', 'description': 'The window anchors to this latest-sale date; present it.'}, 'mover_count': {'type': 'number'}}, 'additionalProperties': True}
market_volume_leaders
Volume leaders
Most-traded graded Pokémon cards by verified sales count over a 24h / 7d / 30d window, filterable by language track (all / en / ja / zh-cn) and grading company (all / PSA / CCIC / PSA10). Windows anchor to the latest sale date on record (anchor_date in the response) — always present results with that date. median_usd is a mixed-grade reference; use card_price for a precise per-grade quote. Up to 50 leaders. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'properties': {'lang': {'enum': ['all', 'en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Language track filter, default all.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many leaders (default 10, max 50).'}, 'window': {'enum': ['24h', '7d', '30d'], 'type': 'string', 'description': 'Volume window, default 7d. Anchored to the latest sale on record, not wall-clock now.'}, 'grade_company': {'enum': ['all', 'PSA', 'CCIC', 'PSA10'], 'type': 'string', 'description': 'Grading filter, default all. PSA10 = PSA grade-10 slabs only.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'lang': {'type': 'string'}, 'note': {'type': 'string'}, 'window': {'type': 'string'}, 'leaders': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'rank': {'type': 'number'}, 'card_id': {'type': 'string'}, 'gmv_usd': {'type': 'number'}, 'name_en': {'type': 'string'}, 'name_zh': {'type': 'string'}, 'card_url': {'type': 'string'}, 'set_code': {'type': 'string'}, 'median_usd': {'type': 'number', 'description': 'mixed-grade reference, not a per-grade quote'}, 'card_number': {'type': 'string'}, 'sales_count': {'type': 'number'}, 'latest_sale_at': {'type': 'string'}}, 'additionalProperties': True}}, 'anchor_date': {'type': 'string', 'description': 'Latest sale date on record — always cite this with results'}, 'leader_count': {'type': 'number'}, 'grade_company': {'type': 'string'}}, 'additionalProperties': True}
recent_sales
Recent sales
Most recent verified sales for one card (up to 10): date, grading company + grade, price in USD, marketplace name. Sales span US, Japan-domestic and Chinese marketplaces — each sale is a real completed transaction, not a listing. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['card_id'], 'properties': {'card_id': {'type': 'string', 'description': 'Card id from search_card / slang_lookup.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'sales': {'type': 'array', 'items': {'type': 'object', 'properties': {'grade': {'type': 'string'}, 'finish': {'type': 'string', 'description': 'Print finish of the card sold (1st_edition, shadowless, reverse_holo, no_symbol, red_cheeks, yellow_cheeks). Combinations are joined with "+" (e.g. 1st_edition+red_cheeks). Absent = no finish recorded for that sale.'}, 'company': {'type': 'string'}, 'sold_at': {'type': 'string'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_type': {'type': 'string'}, 'marketplace': {'type': 'string'}}, 'additionalProperties': True}}, 'card_id': {'type': 'string'}, 'fx_as_of': {'type': 'string'}, 'sale_count': {'type': 'number'}}, 'additionalProperties': True}
search_card
Search cards
Search graded Pokémon cards by name (Chinese / English / Japanese), community nickname (e.g. "鬼皮"), or set code + card number (e.g. "sv8a 喷火龙", "CEL 4"). 中文用户: 按官方卡名/圈内简称/系列码+卡号查任意宝可梦评级卡, 返回 card_id 供查价/走势/存世量工具使用。Returns up to 10 matching cards with card_id (incl. rarity/variant/species fields) — use card_id with the other tools. A bare set code or set name (e.g. "151c", "Celebrations") returns a set-level summary with guidance instead of a truncated card list — follow it to get_set_overview / set_species_summary for whole-set stats. Optional lang filters to one language track (en / ja / zh-cn); tracks are never mixed. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['query'], 'properties': {'lang': {'enum': ['en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Optional language track filter.'}, 'query': {'type': 'string', 'description': 'Card name, nickname/slang, or set code + number. zh/en/ja all accepted.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'hint': {'type': 'string'}, 'lang': {'type': 'string'}, 'query': {'type': 'string'}, 'sample': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}}, 'by_lang': {'type': 'object'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}}, 'guidance': {'type': 'string'}, 'mismatch': {'type': 'object', 'properties': {'matched_name': {'type': 'string'}, 'requested_terms': {'type': 'array', 'items': {'type': 'string'}}, 'matched_character': {'type': 'string'}}, 'additionalProperties': True}, 'set_code': {'type': 'string'}, 'by_rarity': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'tier': {'type': 'string'}, 'display_en': {'type': 'string'}, 'display_cjk': {'type': 'string'}}, 'additionalProperties': True}}, 'condition': {'type': 'string', 'description': '"raw" when the user asked for an ungraded card'}, 'guess_note': {'type': 'string'}, 'match_kind': {'type': 'string', 'description': 'species | card_name | guess — guess means nothing matched and the results are prefix guesses, never price from them'}, 'query_type': {'type': 'string', 'description': '"set" = the query was a bare set code/name; read guidance and use the set-level tools'}, 'set_tracks': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'set_code': {'type': 'string'}, 'total_cards': {'type': 'number'}}, 'additionalProperties': True}, 'description': 'when the query is a set-level name or a bare set code: every (set_code, lang) it exists on, with card counts. The same release usually has a different set code per language track.'}, 'exact_match': {'type': 'boolean', 'description': 'true only when set, number AND every other entity in the query (character, nickname, language) agree with the results'}, 'total_cards': {'type': 'number'}, 'query_intent': {'enum': ['price'], 'type': 'string'}, 'related_sets': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'set_code': {'type': 'string'}, 'total_cards': {'type': 'number'}}, 'additionalProperties': True}, 'description': 'only when unambiguous: the set that carries the same collector name on the requested language track (the same release usually has a different set code per language). Absent when the name covers a whole era or product family rather than one release.'}, 'result_count': {'type': 'number'}, 'entity_anchor': {'type': 'object', 'properties': {'kind': {'enum': ['nickname'], 'type': 'string'}, 'term': {'type': 'string', 'description': 'the dictionary term found inside the question'}, 'found_in': {'type': 'string'}}, 'additionalProperties': True}, 'rarity_filter': {'type': 'object', 'properties': {'status': {'type': 'string'}, 'requested': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}, 'safe_to_price': {'type': 'boolean', 'description': 'true = results[0] can be priced without asking the user to confirm; false = candidates only'}, 'grading_filter': {'type': 'object', 'properties': {'grade': {'type': 'string'}, 'status': {'type': 'string'}, 'company': {'type': 'string'}, 'requested_tier': {'type': 'string'}, 'additional_requests': {'type': 'array', 'items': {'type': 'object', 'properties': {'grade': {'type': 'string'}, 'company': {'type': 'string'}, 'requested_tier': {'type': 'string'}}, 'additionalProperties': True}}}, 'additionalProperties': True}, 'qualifier_note': {'type': 'string'}, 'unresolved_note': {'type': 'string'}, 'also_matched_sets': {'type': 'array', 'items': {'type': 'string'}}, 'unresolved_tokens': {'type': 'array', 'items': {'type': 'string'}, 'description': 'words from the question that were NOT used to choose the card'}, 'qualifiers_dropped': {'type': 'array', 'items': {'type': 'string'}}, 'query_constraint_note': {'type': 'string'}}, 'additionalProperties': True}
set_species_summary
Set species summary
Per-Pokémon breakdown for one set: how many card faces each species has and how they split across variants (base / Master Ball / Poké Ball / …). 中文用户: 这个系列里每只宝可梦有几张卡、各是什么版本(普卡/大师球闪/精灵球闪)一表拿全。Answers "which Pokémon has the most versions in this set". Counts are catalog facts, NOT pull-rate probabilities. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['set_code'], 'properties': {'lang': {'enum': ['en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Optional language track filter.'}, 'set_code': {'type': 'string', 'description': 'Set code, official abbreviation, or set name.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'lang': {'type': 'string'}, 'note': {'type': 'string'}, 'species': {'type': 'array', 'items': {'type': 'object', 'properties': {'dex_no': {'type': 'number'}, 'character': {'type': 'string'}, 'by_variant': {'type': 'object'}, 'total_faces': {'type': 'number'}}, 'additionalProperties': True}}, 'guidance': {'type': 'string'}, 'set_code': {'type': 'string'}, 'total_cards': {'type': 'number'}, 'coverage_note': {'type': 'string'}, 'species_count': {'type': 'number'}, 'species_covered_cards': {'type': 'number'}}, 'additionalProperties': True}
set_top_priced_cards
Highest-priced cards in a set
Rank the highest-priced cards inside one Pokémon TCG set, on one language track (top N, max 20). 中文用户: 某个系列里最贵的前几张卡(如「M2A 前5最高价的卡」「151c 最贵的卡」)一次拿到, 不用逐张查价。Answers "most expensive / top 5 priciest cards in m2a". Each row carries exactly the price card_price returns for that card_id (its headline grade, usually PSA 10 or CCIC 10) with price_basis = verified_sales or reference. Cards with no usable price are not ranked, and the response says how many cards in the set have one. Returns only the top of the ranking — it is not a price-sorted checklist and has no paging. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['set_code'], 'properties': {'lang': {'enum': ['en', 'ja', 'zh-cn'], 'type': 'string', 'description': 'Language the CARDS are printed in (e.g. ja for Japanese sets such as m2a / sv2a), not the language the user is writing in. Prices are never mixed across tracks. Omit it unless the set code exists on more than one track — the response then lists the tracks.'}, 'limit': {'type': 'number', 'maximum': 20, 'minimum': 1, 'description': 'How many top cards to return (1-20, default 10).'}, 'set_code': {'type': 'string', 'description': 'Set code, official abbreviation, or set name (e.g. "m2a", "151c", "CEL").'}}}
Schéma de sortie
{'type': 'object', 'properties': {'lang': {'type': 'string'}, 'note': {'type': 'string'}, 'ranked': {'type': 'array', 'items': {'type': 'object', 'properties': {'card': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'rank': {'type': 'number'}, 'price': {'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'snapshot date of a reference (non-sale) price — quote it as of this date, not as today'}, 'grade': {'type': 'string'}, 'finish': {'type': 'string'}, 'market': {'type': 'string', 'description': 'Which market this sale actually happened in (USD/CNY/JPY). The other two currency fields are convenience conversions at current FX rates, NOT prices observed in those markets. A USD-market sale quoted in CNY does not mean the card trades at that price in China.'}, 'company': {'type': 'string'}, 'n_sales': {'type': 'number'}, 'last_sold': {'type': 'string'}, 'price_cny': {'type': 'number'}, 'price_jpy': {'type': 'number'}, 'price_usd': {'type': 'number'}, 'sale_date': {'type': 'string'}, 'confidence': {'type': 'string'}, 'estimate_max_date': {'type': 'string', 'description': 'Latest sale included in a historical estimate; not the newest source sale.'}, 'estimate_min_date': {'type': 'string'}}, 'additionalProperties': True}, 'price_basis': {'enum': ['verified_sales', 'reference'], 'type': 'string'}, 'price_method': {'type': 'string'}}, 'additionalProperties': True}}, 'tracks': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'total_cards': {'type': 'number'}, 'priced_cards': {'type': 'number'}}, 'additionalProperties': True}}, 'guidance': {'type': 'string'}, 'set_code': {'type': 'string'}, 'needs_lang': {'type': 'boolean'}, 'total_cards': {'type': 'number'}, 'priced_cards': {'type': 'number', 'description': 'cards on this track with a usable price (the ranking pool)'}}, 'additionalProperties': True}
slang_lookup
Nickname lookup
Resolve a Chinese/Japanese/English community nickname (e.g. "鬼皮", "老喷", "Zard") to the actual card(s): official names, set, number, card_id. 中文用户: 把圈内简称(鬼皮/老喷/大月…)解析成具体是哪张卡。Up to 10 cards. Calls record usage and query metadata within POKEKA.
Schéma d’entrée
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'The nickname / slang term.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'term': {'type': 'string'}, 'cards': {'type': 'array', 'items': {'type': 'object', 'properties': {'lang': {'type': 'string'}, 'name': {'type': 'string'}, 'dex_no': {'type': 'number'}, 'rarity': {'type': 'string', 'description': 'bilingual rarity bucket label'}, 'card_id': {'type': 'string'}, 'variant': {'type': 'string', 'description': 'variant slot (master_ball/poke_ball/…); absent for normal'}, 'card_url': {'type': 'string'}, 'gen_code': {'type': 'string'}, 'set_code': {'type': 'string'}, 'set_name': {'type': 'string'}, 'character': {'type': 'string', 'description': 'featured Pokémon (EN species name)'}, 'image_url': {'type': 'string'}, 'card_number': {'type': 'string'}, 'rarity_tier': {'type': 'string', 'description': 'machine rarity tier key (double_rare/ultra_rare/…)'}, 'finish_tiers': {'type': 'string'}, 'variant_kind': {'type': 'string'}, 'rarity_display': {'type': 'object', 'properties': {'en': {'type': 'string', 'description': 'official EN star-system name'}, 'cjk': {'type': 'string', 'description': 'JP-style code (SR/RR/…)'}}, 'additionalProperties': True}}, 'additionalProperties': True}}, 'card_count': {'type': 'number'}}, 'additionalProperties': True}
Historique
Modifications récentes des outils
Modifié
search_card
29 September 2026 03:00
Modifié
get_market_brief
25 September 2026 03:00
Modifié
get_card_context
25 September 2026 03:00
Modifié
market_volume_leaders
25 September 2026 03:00
Modifié
slang_lookup
25 September 2026 03:00
Modifié
market_movers
25 September 2026 03:00
Modifié
recent_sales
25 September 2026 03:00
Modifié
card_pop
25 September 2026 03:00
Modifié
card_price_history
25 September 2026 03:00
Modifié
card_price
25 September 2026 03:00
Modifié
set_species_summary
25 September 2026 03:00
Modifié
set_top_priced_cards
25 September 2026 03:00
Modifié
get_set_overview
25 September 2026 03:00
Modifié
search_card
25 September 2026 03:00
Ajouté
get_account_access
25 September 2026 03:00
Ajouté
set_top_priced_cards
19 September 2026 02:49
Modifié
get_set_overview
19 September 2026 02:49
Ajouté
get_market_brief
17 September 2026 12:55
Ajouté
get_card_context
17 September 2026 12:55
Ajouté
market_volume_leaders
17 September 2026 12:55
Ajouté
slang_lookup
17 September 2026 12:55
Ajouté
market_movers
17 September 2026 12:55
Ajouté
recent_sales
17 September 2026 12:55
Ajouté
card_pop
17 September 2026 12:55
Ajouté
card_price_history
17 September 2026 12:55
Ajouté
card_price
17 September 2026 12:55
Ajouté
set_species_summary
17 September 2026 12:55
Ajouté
get_set_overview
17 September 2026 12:55
Ajouté
search_card
17 September 2026 12:55
Découvrir
Serveurs MCP similaires
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
API Acre
com.apiacre/api-acre
Offers paid APIs for EVM blockchain inspection, data transformation and validation, geocoding, weather, currency conversion, and …
Ask AI
com.ask-ai-data-connector/ask-ai
Answers questions about connected e-commerce data from Shopify, Klaviyo, GA4, Triple Whale, and other sources, covering sales, ma…
Neonjelly
io.neonjelly/mcp
Analyzes Shopify stores, products, apps, traffic, competitors, catalog changes, market cohorts and outreach contacts across a lar…
zobrx
com.zobrx/zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
sella
io.github.sella-network/sella
Operates an agent marketplace for purchasing datasets, APIs, and products, including catalog discovery, purchase settlement, deli…
kurashigram
io.github.Kotaro-Studio/kurashigram
Provides cited Japanese price comparisons, cost-of-living statistics, product prices, shopping data, public benefit information, …
Keepa
io.github.pipeworx-io/keepa
Searches Amazon products and categories and provides price, sales-rank, deal, bestseller, and historical product data through Kee…