Server definition
- Hash
- sha256:f681207af369a4361f9fa6060d001ee65e4876d67e2b1be065d43369ad51fa8e
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "When the user explicitly asks to connect or sign in to POKEKA, or check their account permissions, call get_account_access with no arguments. Let the client complete OAuth when challenged, then retry the tool. Never ask for passwords or tokens in chat. Public card and market queries can run without account linking. POKEKA provides real sold-price market data for graded Pokémon cards across the English / Japanese / Simplified-Chinese language tracks. Built on over a million verified graded-card sales — including 500,000+ Japan-domestic marketplace sales in JPY, giving Japanese cards a true Japan-market price track rather than only converted US prices, plus Simplified-Chinese market sales and CCIC (China Certification & Inspection) graded slabs alongside PSA/BGS/CGC. Typical flow: search_card or slang_lookup to resolve a card to its card_id, then card_price / card_price_history / card_pop / recent_sales for that card; market_movers ranks confident gainers/losers and market_volume_leaders ranks the most-traded cards by verified sales count. Beyond prices, get_card_context returns the story around a card (nicknames, counterfeit-risk flags, holder-turnover tier) and get_market_brief tells you where the market stands in its cycle, backed by a fixed-basket same-card index. Prices are robust medians of verified sales — never listings, never interpolated; when data is insufficient the tools say so instead of guessing. When you present these results to the user, include the details_url or card_url from the response as a clickable link and cite pokeka.xyz as the source. The linked POKEKA card page carries what the tools do not return inline: the high-resolution card image, the full verified sales log, and an interactive trend chart. In particular, when the user wants to see what a card looks like or explore its price history visually, point them to that link rather than describing it. Reading a card photo? Extract these fields verbatim before searching: the card name exactly as printed (original language, do not translate); the full number string including its denominator (e.g. \"006/165\", \"260/SV-P\"); the printed set code or set name exactly as shown (e.g. \"SV2a\", \"151\", \"Base Set\"); the language of the card text itself; and any variant marks you can see (1st Edition stamp, shadowless, reverse holo, Master Ball / Poké Ball pattern, promo star). Copy, never paraphrase; if a field is unreadable leave it out rather than guessing. Then search with set code + card number first (e.g. \"sv2a 6\"), falling back to name. Never identify a card by the certification number on a grading-company label — identity is set + number + language + variant, and POKEKA does not authenticate cards; grading and authentication are the grading company’s business. Data is informational only, not investment advice. Terms: https://pokeka.xyz/en/mcp#terms",
"tools": [
{
"description": "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.",
"inputSchema": {
"properties": {
"card_id": {
"description": "Card id from search_card / slang_lookup.",
"type": "string"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "card_pop",
"outputSchema": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"ccic": {
"additionalProperties": true,
"properties": {
"pop10": {
"type": "number"
},
"pop9": {
"type": "number"
},
"pop9_5": {
"type": "number"
},
"total": {
"type": "number"
}
},
"type": "object"
},
"gem_rate": {
"type": "number"
},
"gem_rate_band": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"note": {
"type": "string"
},
"psa": {
"additionalProperties": true,
"properties": {
"pop10": {
"type": "number"
},
"pop8": {
"type": "number"
},
"pop9": {
"type": "number"
},
"total": {
"type": "number"
}
},
"type": "object"
},
"scarcity_tier": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"card_id": {
"description": "Card id from search_card / slang_lookup. An exact community nickname (e.g. \"moonbreon\", \"鬼皮\") also resolves when it maps to exactly one card.",
"type": "string"
},
"company": {
"description": "Optional grading company to price, e.g. \"PSA\". Use with grade.",
"enum": [
"PSA",
"BGS",
"CGC",
"CCIC",
"ARS",
"SGC",
"PCG"
],
"type": "string"
},
"condition": {
"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.",
"enum": [
"graded",
"raw"
],
"type": "string"
},
"grade": {
"description": "Optional grade to price, e.g. \"10\", \"9.5\", \"9\". Use with company. No fallback to another grade.",
"type": "string"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "card_price",
"outputSchema": {
"additionalProperties": true,
"properties": {
"card": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"fx_as_of": {
"type": "string"
},
"grade_ladder": {
"items": {
"additionalProperties": true,
"properties": {
"as_of": {
"description": "snapshot date of a reference (non-sale) price — quote it as of this date, not as today",
"type": "string"
},
"company": {
"type": "string"
},
"confidence": {
"type": "string"
},
"estimate_max_date": {
"description": "Latest sale included in a historical estimate; not the newest source sale.",
"type": "string"
},
"estimate_min_date": {
"type": "string"
},
"finish": {
"type": "string"
},
"grade": {
"type": "string"
},
"last_sold": {
"type": "string"
},
"market": {
"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.",
"type": "string"
},
"n_sales": {
"type": "number"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_date": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"headline": {
"additionalProperties": true,
"description": "omitted when there is no verified headline price — read price_status",
"properties": {
"as_of": {
"description": "snapshot date of a reference (non-sale) price — quote it as of this date, not as today",
"type": "string"
},
"company": {
"type": "string"
},
"confidence": {
"type": "string"
},
"estimate_max_date": {
"description": "Latest sale included in a historical estimate; not the newest source sale.",
"type": "string"
},
"estimate_min_date": {
"type": "string"
},
"finish": {
"type": "string"
},
"grade": {
"type": "string"
},
"last_sold": {
"type": "string"
},
"market": {
"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.",
"type": "string"
},
"n_sales": {
"type": "number"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_date": {
"type": "string"
}
},
"type": "object"
},
"headline_confidence": {
"type": "string"
},
"last_sold_date": {
"type": "string"
},
"note": {
"type": "string"
},
"price_status": {
"enum": [
"ok",
"reference_only",
"insufficient_data",
"price_withheld_quality_gate",
"card_not_found",
"unreleased",
"grade_not_available",
"unsupported_market_type"
],
"type": "string"
},
"reference": {
"additionalProperties": true,
"properties": {
"as_of": {
"description": "snapshot date of a reference (non-sale) price — quote it as of this date, not as today",
"type": "string"
},
"company": {
"type": "string"
},
"confidence": {
"type": "string"
},
"estimate_max_date": {
"description": "Latest sale included in a historical estimate; not the newest source sale.",
"type": "string"
},
"estimate_min_date": {
"type": "string"
},
"finish": {
"type": "string"
},
"grade": {
"type": "string"
},
"last_sold": {
"type": "string"
},
"market": {
"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.",
"type": "string"
},
"n_sales": {
"type": "number"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_date": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"card_id": {
"description": "Card id from search_card / slang_lookup.",
"type": "string"
},
"weeks": {
"description": "How many recent weeks (default 26, max 26).",
"maximum": 26,
"minimum": 1,
"type": "integer"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "card_price_history",
"outputSchema": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"change_pct_30d": {
"type": "number"
},
"change_pct_90d": {
"type": "number"
},
"note": {
"type": "string"
},
"point_count": {
"type": "number"
},
"series": {
"items": {
"additionalProperties": true,
"properties": {
"median_usd": {
"type": "number"
},
"n_sales": {
"type": "number"
},
"week": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"weeks_requested": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_account_access",
"outputSchema": {
"additionalProperties": true,
"properties": {
"access_tier": {
"enum": [
"free",
"pro_trial",
"pro"
],
"type": "string"
},
"connected": {
"type": "boolean"
},
"detailed_market_data": {
"description": "Whether the linked account currently has access to detailed market data; individual tool limits still apply.",
"type": "boolean"
},
"manage_connection_url": {
"description": "POKEKA account page where the user can manage or revoke this connection.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"card_id": {
"description": "Card id from search_card / slang_lookup.",
"type": "string"
},
"query": {
"description": "Alternative to card_id: an exact community nickname or alias.",
"type": "string"
}
},
"type": "object"
},
"name": "get_card_context",
"outputSchema": {
"additionalProperties": true,
"properties": {
"card": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"context_coverage_note": {
"type": "string"
},
"context_note": {
"type": "string"
},
"has_risk_flags": {
"type": "boolean"
},
"headline": {
"additionalProperties": true,
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"n_sales": {
"type": "number"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
}
},
"type": "object"
},
"hoarding_tier": {
"enum": [
"high_churn",
"mid",
"locked"
],
"type": "string"
},
"last_sale": {
"additionalProperties": true,
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"n_sales": {
"type": "number"
},
"note": {
"description": "Always quote this caveat with the number — it is one sale, not a valuation.",
"type": "string"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_date": {
"type": "string"
}
},
"type": "object"
},
"nicknames": {
"items": {
"type": "string"
},
"type": "array"
},
"note": {
"type": "string"
},
"price_note": {
"type": "string"
},
"price_status": {
"type": "string"
},
"reference": {
"additionalProperties": true,
"properties": {
"as_of": {
"description": "snapshot date of a reference (non-sale) price — quote it as of this date, not as today",
"type": "string"
},
"company": {
"type": "string"
},
"confidence": {
"type": "string"
},
"estimate_max_date": {
"description": "Latest sale included in a historical estimate; not the newest source sale.",
"type": "string"
},
"estimate_min_date": {
"type": "string"
},
"finish": {
"type": "string"
},
"grade": {
"type": "string"
},
"last_sold": {
"type": "string"
},
"market": {
"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.",
"type": "string"
},
"n_sales": {
"type": "number"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_date": {
"type": "string"
}
},
"type": "object"
},
"release_date": {
"type": "string"
},
"risk_flags": {
"items": {
"additionalProperties": true,
"properties": {
"note": {
"type": "string"
},
"source": {
"type": "string"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"market": {
"description": "Track, default all.",
"enum": [
"all",
"en",
"ja",
"zh-cn"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_market_brief",
"outputSchema": {
"additionalProperties": true,
"properties": {
"as_of": {
"type": "string"
},
"basket_size": {
"type": "number"
},
"change_from_base": {
"type": "number"
},
"drawdown_from_peak": {
"type": "number"
},
"index_level": {
"type": "number"
},
"market": {
"type": "string"
},
"note": {
"type": "string"
},
"phase": {
"type": "string"
},
"tx_7d_count": {
"type": "number"
},
"upcoming_events": {
"items": {
"additionalProperties": true,
"properties": {
"date": {
"type": "string"
},
"text": {
"type": "string"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"lang": {
"description": "Optional language track filter — same code can be different products per track.",
"enum": [
"en",
"ja",
"zh-cn"
],
"type": "string"
},
"page": {
"description": "Checklist page (0-based). Anonymous/free tier: 20 cards/page, first 2 pages; Pro: 50/page (whole-set sweeps are rate-guarded).",
"type": "number"
},
"set_code": {
"description": "Set code, official abbreviation, or set name (e.g. \"151c\", \"sv2a\", \"CEL\", \"Celebrations\").",
"type": "string"
}
},
"required": [
"set_code"
],
"type": "object"
},
"name": "get_set_overview",
"outputSchema": {
"additionalProperties": true,
"properties": {
"by_lang": {
"type": "object"
},
"by_rarity": {
"items": {
"additionalProperties": true,
"properties": {
"display_cjk": {
"type": "string"
},
"display_en": {
"type": "string"
},
"n": {
"type": "number"
},
"tier": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"by_variant": {
"items": {
"additionalProperties": true,
"properties": {
"n": {
"type": "number"
},
"variant": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"checklist": {
"items": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"checklist_capped": {
"type": "boolean"
},
"checklist_page": {
"type": "number"
},
"checklist_page_size": {
"type": "number"
},
"guidance": {
"type": "string"
},
"lang": {
"type": "string"
},
"note": {
"type": "string"
},
"set_code": {
"type": "string"
},
"species_note": {
"type": "string"
},
"top_species": {
"items": {
"additionalProperties": true,
"properties": {
"character": {
"type": "string"
},
"n": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"total_cards": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"direction": {
"description": "\"up\" = cards rising, \"down\" = cards falling. Default \"up\".",
"enum": [
"up",
"down"
],
"type": "string"
},
"lang": {
"description": "Market track: \"en\", \"ja\" or \"zh-cn\".",
"enum": [
"en",
"ja",
"zh-cn"
],
"type": "string"
},
"window": {
"description": "Change window: \"7d\", \"30d\" or \"90d\". Omit to use the default window published for that track.",
"enum": [
"7d",
"30d",
"90d"
],
"type": "string"
}
},
"required": [
"lang"
],
"type": "object"
},
"name": "market_movers",
"outputSchema": {
"additionalProperties": true,
"properties": {
"anchor_date": {
"description": "The window anchors to this latest-sale date; present it.",
"type": "string"
},
"direction": {
"type": "string"
},
"market": {
"type": "string"
},
"mover_count": {
"type": "number"
},
"movers": {
"items": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_url": {
"type": "string"
},
"change_pct": {
"type": "number"
},
"grade": {
"description": "Representative grade being compared (e.g. \"PSA 10\") — pools never mix grades.",
"type": "string"
},
"name": {
"type": "string"
},
"price_basis": {
"description": "\"reference\" = price_usd is a PriceCharting aggregate, NOT our verified sales — say so when quoting it.",
"enum": [
"verified_sales",
"reference"
],
"type": "string"
},
"price_usd": {
"type": "number"
},
"rank": {
"type": "number"
},
"sales_in_window": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"window": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"grade_company": {
"description": "Grading filter, default all. PSA10 = PSA grade-10 slabs only.",
"enum": [
"all",
"PSA",
"CCIC",
"PSA10"
],
"type": "string"
},
"lang": {
"description": "Language track filter, default all.",
"enum": [
"all",
"en",
"ja",
"zh-cn"
],
"type": "string"
},
"limit": {
"description": "How many leaders (default 10, max 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"window": {
"description": "Volume window, default 7d. Anchored to the latest sale on record, not wall-clock now.",
"enum": [
"24h",
"7d",
"30d"
],
"type": "string"
}
},
"type": "object"
},
"name": "market_volume_leaders",
"outputSchema": {
"additionalProperties": true,
"properties": {
"anchor_date": {
"description": "Latest sale date on record — always cite this with results",
"type": "string"
},
"grade_company": {
"type": "string"
},
"lang": {
"type": "string"
},
"leader_count": {
"type": "number"
},
"leaders": {
"items": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"gmv_usd": {
"type": "number"
},
"lang": {
"type": "string"
},
"latest_sale_at": {
"type": "string"
},
"median_usd": {
"description": "mixed-grade reference, not a per-grade quote",
"type": "number"
},
"name_en": {
"type": "string"
},
"name_zh": {
"type": "string"
},
"rank": {
"type": "number"
},
"sales_count": {
"type": "number"
},
"set_code": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"window": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"card_id": {
"description": "Card id from search_card / slang_lookup.",
"type": "string"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "recent_sales",
"outputSchema": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"fx_as_of": {
"type": "string"
},
"note": {
"type": "string"
},
"sale_count": {
"type": "number"
},
"sales": {
"items": {
"additionalProperties": true,
"properties": {
"company": {
"type": "string"
},
"finish": {
"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.",
"type": "string"
},
"grade": {
"type": "string"
},
"marketplace": {
"type": "string"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_type": {
"type": "string"
},
"sold_at": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"lang": {
"description": "Optional language track filter.",
"enum": [
"en",
"ja",
"zh-cn"
],
"type": "string"
},
"query": {
"description": "Card name, nickname/slang, or set code + number. zh/en/ja all accepted.",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_card",
"outputSchema": {
"additionalProperties": true,
"properties": {
"also_matched_sets": {
"items": {
"type": "string"
},
"type": "array"
},
"by_lang": {
"type": "object"
},
"by_rarity": {
"items": {
"additionalProperties": true,
"properties": {
"display_cjk": {
"type": "string"
},
"display_en": {
"type": "string"
},
"n": {
"type": "number"
},
"tier": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"condition": {
"description": "\"raw\" when the user asked for an ungraded card",
"type": "string"
},
"entity_anchor": {
"additionalProperties": true,
"properties": {
"found_in": {
"type": "string"
},
"kind": {
"enum": [
"nickname"
],
"type": "string"
},
"term": {
"description": "the dictionary term found inside the question",
"type": "string"
}
},
"type": "object"
},
"exact_match": {
"description": "true only when set, number AND every other entity in the query (character, nickname, language) agree with the results",
"type": "boolean"
},
"grading_filter": {
"additionalProperties": true,
"properties": {
"additional_requests": {
"items": {
"additionalProperties": true,
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"requested_tier": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"requested_tier": {
"type": "string"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"guess_note": {
"type": "string"
},
"guidance": {
"type": "string"
},
"hint": {
"type": "string"
},
"lang": {
"type": "string"
},
"match_kind": {
"description": "species | card_name | guess — guess means nothing matched and the results are prefix guesses, never price from them",
"type": "string"
},
"mismatch": {
"additionalProperties": true,
"properties": {
"matched_character": {
"type": "string"
},
"matched_name": {
"type": "string"
},
"requested_terms": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"qualifier_note": {
"type": "string"
},
"qualifiers_dropped": {
"items": {
"type": "string"
},
"type": "array"
},
"query": {
"type": "string"
},
"query_constraint_note": {
"type": "string"
},
"query_intent": {
"enum": [
"price"
],
"type": "string"
},
"query_type": {
"description": "\"set\" = the query was a bare set code/name; read guidance and use the set-level tools",
"type": "string"
},
"rarity_filter": {
"additionalProperties": true,
"properties": {
"requested": {
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"related_sets": {
"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.",
"items": {
"additionalProperties": true,
"properties": {
"lang": {
"type": "string"
},
"set_code": {
"type": "string"
},
"total_cards": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"result_count": {
"type": "number"
},
"results": {
"items": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"safe_to_price": {
"description": "true = results[0] can be priced without asking the user to confirm; false = candidates only",
"type": "boolean"
},
"sample": {
"items": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"set_code": {
"type": "string"
},
"set_tracks": {
"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.",
"items": {
"additionalProperties": true,
"properties": {
"lang": {
"type": "string"
},
"set_code": {
"type": "string"
},
"total_cards": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"total_cards": {
"type": "number"
},
"unresolved_note": {
"type": "string"
},
"unresolved_tokens": {
"description": "words from the question that were NOT used to choose the card",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"lang": {
"description": "Optional language track filter.",
"enum": [
"en",
"ja",
"zh-cn"
],
"type": "string"
},
"set_code": {
"description": "Set code, official abbreviation, or set name.",
"type": "string"
}
},
"required": [
"set_code"
],
"type": "object"
},
"name": "set_species_summary",
"outputSchema": {
"additionalProperties": true,
"properties": {
"coverage_note": {
"type": "string"
},
"guidance": {
"type": "string"
},
"lang": {
"type": "string"
},
"note": {
"type": "string"
},
"set_code": {
"type": "string"
},
"species": {
"items": {
"additionalProperties": true,
"properties": {
"by_variant": {
"type": "object"
},
"character": {
"type": "string"
},
"dex_no": {
"type": "number"
},
"total_faces": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"species_count": {
"type": "number"
},
"species_covered_cards": {
"type": "number"
},
"total_cards": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"lang": {
"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.",
"enum": [
"en",
"ja",
"zh-cn"
],
"type": "string"
},
"limit": {
"description": "How many top cards to return (1-20, default 10).",
"maximum": 20,
"minimum": 1,
"type": "number"
},
"set_code": {
"description": "Set code, official abbreviation, or set name (e.g. \"m2a\", \"151c\", \"CEL\").",
"type": "string"
}
},
"required": [
"set_code"
],
"type": "object"
},
"name": "set_top_priced_cards",
"outputSchema": {
"additionalProperties": true,
"properties": {
"guidance": {
"type": "string"
},
"lang": {
"type": "string"
},
"needs_lang": {
"type": "boolean"
},
"note": {
"type": "string"
},
"priced_cards": {
"description": "cards on this track with a usable price (the ranking pool)",
"type": "number"
},
"ranked": {
"items": {
"additionalProperties": true,
"properties": {
"card": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"price": {
"additionalProperties": true,
"properties": {
"as_of": {
"description": "snapshot date of a reference (non-sale) price — quote it as of this date, not as today",
"type": "string"
},
"company": {
"type": "string"
},
"confidence": {
"type": "string"
},
"estimate_max_date": {
"description": "Latest sale included in a historical estimate; not the newest source sale.",
"type": "string"
},
"estimate_min_date": {
"type": "string"
},
"finish": {
"type": "string"
},
"grade": {
"type": "string"
},
"last_sold": {
"type": "string"
},
"market": {
"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.",
"type": "string"
},
"n_sales": {
"type": "number"
},
"price_cny": {
"type": "number"
},
"price_jpy": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"sale_date": {
"type": "string"
}
},
"type": "object"
},
"price_basis": {
"enum": [
"verified_sales",
"reference"
],
"type": "string"
},
"price_method": {
"type": "string"
},
"rank": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"set_code": {
"type": "string"
},
"total_cards": {
"type": "number"
},
"tracks": {
"items": {
"additionalProperties": true,
"properties": {
"lang": {
"type": "string"
},
"priced_cards": {
"type": "number"
},
"total_cards": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"term": {
"description": "The nickname / slang term.",
"type": "string"
}
},
"required": [
"term"
],
"type": "object"
},
"name": "slang_lookup",
"outputSchema": {
"additionalProperties": true,
"properties": {
"card_count": {
"type": "number"
},
"cards": {
"items": {
"additionalProperties": true,
"properties": {
"card_id": {
"type": "string"
},
"card_number": {
"type": "string"
},
"card_url": {
"type": "string"
},
"character": {
"description": "featured Pokémon (EN species name)",
"type": "string"
},
"dex_no": {
"type": "number"
},
"finish_tiers": {
"type": "string"
},
"gen_code": {
"type": "string"
},
"image_url": {
"type": "string"
},
"lang": {
"type": "string"
},
"name": {
"type": "string"
},
"rarity": {
"description": "bilingual rarity bucket label",
"type": "string"
},
"rarity_display": {
"additionalProperties": true,
"properties": {
"cjk": {
"description": "JP-style code (SR/RR/…)",
"type": "string"
},
"en": {
"description": "official EN star-system name",
"type": "string"
}
},
"type": "object"
},
"rarity_tier": {
"description": "machine rarity tier key (double_rare/ultra_rare/…)",
"type": "string"
},
"set_code": {
"type": "string"
},
"set_name": {
"type": "string"
},
"variant": {
"description": "variant slot (master_ball/poke_ball/…); absent for normal",
"type": "string"
},
"variant_kind": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"term": {
"type": "string"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:f681207af369a4361f9fa6060d001ee65e4876d67e2b1be065d43369ad51fa8e | sha256sum