Skip to main content
Glama

POKEKA — Pokémon Card Prices

Card context

get_card_context
Read-only

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. Reads POKEKA market data only; server-side request logging is disclosed in the privacy policy; does not modify user data.

Input Schema

NameRequiredDescriptionDefault
queryNoAlternative to card_id: an exact community nickname or alias.
card_idNoCard id from search_card / slang_lookup.

Output Schema

NameRequiredDescriptionDefault
cardNo
noteNo
headlineNo
last_saleNo
nicknamesNo
referenceNo
price_noteNo
risk_flagsNo
context_noteNo
price_statusNo
release_dateNo
hoarding_tierNo
has_risk_flagsNo
context_coverage_noteNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / reference / properties / source_mix
      Added value: +{
      +  "description": "verified sales in this cell counted by marketplace; a label, not part of the price",
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • addedOutput schema / properties / reference / properties / finish / description
      Added value: +"Print finish this price is for. base = regular (Unlimited) printing; unknown = a single sale whose edition (1st Edition vs regular) is not recorded — not a price for either printing; other values are named in finish_name."
  3. Changed1 schema field changed
    • addedOutput schema / properties / reference
      Added value: +{
      +  "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"
      +}
  4. Changed5 schema fields changed
    • addedOutput schema / properties / headline
      Added value: +{
      +  "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"
      +}
    • addedOutput schema / properties / last_sale
      Added value: +{
      +  "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"
      +}
    • addedOutput schema / properties / price_note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / price_status
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / release_date
      Added value: +{
      +  "type": "string"
      +}
  5. Changed10 schema fields changed
    • addedOutput schema / properties / card / properties / character
      Added value: +{
      +  "description": "featured Pokémon (EN species name)",
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / dex_no
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / card / properties / finish_tiers
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / gen_code
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / rarity
      Added value: +{
      +  "description": "bilingual rarity bucket label",
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / rarity_display
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "cjk": {
      +      "description": "JP-style code (SR/RR/…)",
      +      "type": "string"
      +    },
      +    "en": {
      +      "description": "official EN star-system name",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / card / properties / rarity_tier
      Added value: +{
      +  "description": "machine rarity tier key (double_rare/ultra_rare/…)",
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / set_name
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / variant
      Added value: +{
      +  "description": "variant slot (master_ball/poke_ball/…); absent for normal",
      +  "type": "string"
      +}
    • addedOutput schema / properties / card / properties / variant_kind
      Added value: +{
      +  "type": "string"
      +}
  6. First observed

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well past the readOnly/openWorld annotations by disclosing that coverage is curated and growing, that missing flags are not a clearance, that it reads POKEKA market data only, and that requests are logged. Those caveats materially change how an agent should interpret an empty result.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first clause and the enumerated payload list is efficient. The tail clause about privacy-policy logging and 'does not modify user data' is partly boilerplate and partly redundant with the readOnly annotation, which keeps it from a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the return shape needn't be described; the description instead covers inputs, data scope, coverage limitations, and privacy posture. Nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, and the description earns a bump by clarifying that 'query' must be an EXACT nickname and giving concrete examples ('凡高皮', '金拱门'). It also reinforces card_id as the primary identifier sourced from other tools.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific resource and enumerates exactly what comes back (nicknames, counterfeit-risk flags, turnover tier, context note) plus the price, which clearly separates it from card_price and slang_lookup. The dual input mode (card_id or exact nickname) is also named up front.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: 'Everything around one card beyond the price' hints that it complements card_price, and the schema notes where card_id comes from, but the description never says when to pick this tool over card_price, slang_lookup, or get_market_brief. No explicit exclusions or alternatives are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources