Skip to main content
Glama

POKEKA — Pokémon Card Prices

Search cards

search_card
Read-only

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. Keep artwork descriptions and negative conditions in query (e.g. "alt art", "not 1st Edition"). Read artwork_filter / finish_filter: conflicting or unverified conditions do not permit quoting; not 1st Edition does not by itself mean Unlimited. 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. Also resolves sealed products that have a fixed card list (theme decks, starter sets) by product name, e.g. "Water Blast theme deck": the result then carries a product block with the card list instead of card candidates. POKEKA has no price for sealed products. Reads POKEKA market data only; server-side request logging is disclosed in the privacy policy; does not modify user data.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "query": "<query>"
    },
    "name": "search_card"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNoOptional language track filter.
queryYesCard name, nickname/slang, or set code + number. zh/en/ja all accepted. At most 160 characters (counted as Unicode code points); a longer query is rejected, not cut — keep it to the card name, set, number and the conditions that matter.

Output Schema

NameRequiredDescriptionDefault
hintNo
langNo
noteNo
orderNoheadline_price_desc = the listed cards are the most expensive ones, not the ones collectors usually mean
queryNo
sampleNo
by_langNo
resultsNo
speciesNo
guidanceNo
mismatchNo
set_codeNo
by_rarityNo
conditionNo"raw" when the user asked for an ungraded card
guess_noteNo
match_kindNospecies | card_name | guess — guess means nothing matched and the results are prefix guesses, never price from them
query_typeNo"set" = the query was a bare set code/name; read guidance and use the set-level tools
set_tracksNowhen 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.
term_scopeNospecies = the term is a nickname for a whole Pokémon species (many cards), not for one card
exact_matchNotrue only when set, number AND every other entity in the query (character, nickname, language) agree with the results
total_cardsNo
query_intentNo
related_setsNoonly 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_countNo
entity_anchorNo
finish_filterNo
rarity_filterNo
safe_to_priceNotrue = results[0] can be priced without asking the user to confirm; false = candidates only
artwork_filterNo
grading_filterNo
qualifier_noteNo
unresolved_noteNo
card_count_totalNohow many cards the term matches in total; card_count / result_count is only how many are listed
also_matched_setsNo
unresolved_tokensNowords from the question that were NOT used to choose the card
qualifiers_droppedNo
qualifiers_recognizedNo
query_constraint_noteNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / results / items / properties / market_level
      Added value: +{
      +  "description": "best price evidence across all printings and grades: live / reference / sale_only",
      +  "type": "string"
      +}
    • addedOutput schema / properties / sample / items / properties / market_level
      Added value: +{
      +  "description": "best price evidence across all printings and grades: live / reference / sale_only",
      +  "type": "string"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / query / description
      Previous value: -"Card name, nickname/slang, or set code + number. zh/en/ja all accepted."New value: +"Card name, nickname/slang, or set code + number. zh/en/ja all accepted. At most 160 characters (counted as Unicode code points); a longer query is rejected, not cut — keep it to the card name, set, number and the conditions that matter."
  3. Changed3 schema fields changed
    • addedOutput schema / properties / artwork_filter
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "candidates": {
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "card_id": {
      +            "type": "string"
      +          },
      +          "evidence": {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "observed_at": {
      +                  "type": "string"
      +                },
      +                "source": {
      +                  "type": "string"
      +                },
      +                "source_key": {
      +                  "type": "string"
      +                },
      +                "source_name": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "status": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "hint": {
      +      "type": "string"
      +    },
      +    "requested": {
      +      "type": "string"
      +    },
      +    "status": {
      +      "enum": [
      +        "matched",
      +        "conflicting",
      +        "unverified"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / finish_filter
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "candidates": {
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "card_id": {
      +            "type": "string"
      +          },
      +          "remaining": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "excluded": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "hint": {
      +      "type": "string"
      +    },
      +    "remaining": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "requested": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "status": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / qualifiers_recognized
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "as": {
      +        "type": "string"
      +      },
      +      "excluded": {
      +        "type": "boolean"
      +      },
      +      "phrase": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  4. Changed5 schema fields changed
    • addedOutput schema / properties / card_count_total
      Added value: +{
      +  "description": "how many cards the term matches in total; card_count / result_count is only how many are listed",
      +  "type": "number"
      +}
    • addedOutput schema / properties / note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / order
      Added value: +{
      +  "description": "headline_price_desc = the listed cards are the most expensive ones, not the ones collectors usually mean",
      +  "type": "string"
      +}
    • addedOutput schema / properties / species
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / term_scope
      Added value: +{
      +  "description": "species = the term is a nickname for a whole Pokémon species (many cards), not for one card",
      +  "enum": [
      +    "species"
      +  ],
      +  "type": "string"
      +}
  5. Changed2 schema fields changed
    • addedOutput schema / properties / related_sets
      Added value: +{
      +  "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"
      +}
    • addedOutput schema / properties / set_tracks
      Added value: +{
      +  "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"
      +}
  6. Changed4 schema fields changed
    • addedOutput schema / properties / entity_anchor
      Added value: +{
      +  "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"
      +}
    • addedOutput schema / properties / guess_note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / match_kind
      Added value: +{
      +  "description": "species | card_name | guess — guess means nothing matched and the results are prefix guesses, never price from them",
      +  "type": "string"
      +}
    • addedOutput schema / properties / unresolved_tokens / description
      Added value: +"words from the question that were NOT used to choose the card"
  7. Changed6 schema fields changed
    • addedOutput schema / properties / grading_filter / properties / additional_requests
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "company": {
      +        "type": "string"
      +      },
      +      "grade": {
      +        "type": "string"
      +      },
      +      "requested_tier": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / grading_filter / properties / requested_tier
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / grading_filter / properties / status
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / query_constraint_note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / query_intent
      Added value: +{
      +  "enum": [
      +    "price"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / rarity_filter
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "requested": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "status": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  8. Changed7 schema fields changed
    • addedOutput schema / properties / condition
      Added value: +{
      +  "description": "\"raw\" when the user asked for an ungraded card",
      +  "type": "string"
      +}
    • changedOutput schema / properties / exact_match / description
      Previous value: -"false = the set/number qualifier in the query was NOT satisfied by any result"New value: +"true only when set, number AND every other entity in the query (character, nickname, language) agree with the results"
    • addedOutput schema / properties / grading_filter
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "company": {
      +      "type": "string"
      +    },
      +    "grade": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / mismatch
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "matched_character": {
      +      "type": "string"
      +    },
      +    "matched_name": {
      +      "type": "string"
      +    },
      +    "requested_terms": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / safe_to_price
      Added value: +{
      +  "description": "true = results[0] can be priced without asking the user to confirm; false = candidates only",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / unresolved_note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / unresolved_tokens
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  9. Changed18 schema fields changed
    • addedOutput schema / properties / also_matched_sets
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / by_lang
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / by_rarity
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "display_cjk": {
      +        "type": "string"
      +      },
      +      "display_en": {
      +        "type": "string"
      +      },
      +      "n": {
      +        "type": "number"
      +      },
      +      "tier": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / guidance
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / query_type
      Added value: +{
      +  "description": "\"set\" = the query was a bare set code/name; read guidance and use the set-level tools",
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / character
      Added value: +{
      +  "description": "featured Pokémon (EN species name)",
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / dex_no
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / results / items / properties / finish_tiers
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / gen_code
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / rarity
      Added value: +{
      +  "description": "bilingual rarity bucket label",
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / 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 / results / items / properties / rarity_tier
      Added value: +{
      +  "description": "machine rarity tier key (double_rare/ultra_rare/…)",
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / set_name
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / variant
      Added value: +{
      +  "description": "variant slot (master_ball/poke_ball/…); absent for normal",
      +  "type": "string"
      +}
    • addedOutput schema / properties / results / items / properties / variant_kind
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / sample
      Added value: +{
      +  "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"
      +}
    • addedOutput schema / properties / set_code
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / total_cards
      Added value: +{
      +  "type": "number"
      +}
  10. Changed3 schema fields changed
    • addedOutput schema / properties / exact_match
      Added value: +{
      +  "description": "false = the set/number qualifier in the query was NOT satisfied by any result",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / qualifier_note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / qualifiers_dropped
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  11. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Annotations already declare a safe read-only, non-open-world operation, and the description still adds substantive behavior: a hard cap of 10 results, a set-level fallback instead of a truncated list, sealed-product resolution that returns a product block, the fact that POKEKA has no price for sealed products, and a server-side logging disclosure. Only "does not modify user data" redundantly restates the annotations.

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

Conciseness3/5

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

The query-syntax guidance is front-loaded and useful, but the remainder is a dense run-on that piles filtering caveats, sealed-product behavior, data-source scope, and a privacy-policy pointer into one paragraph. The Chinese sentence largely duplicates the English content, and the privacy/logging line earns marginal space relative to its decision value.

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

Completeness4/5

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

Given an output schema exists, the description need not explain field-level returns, and it correctly covers the non-obvious cases: set-level fallback, sealed products, language-track isolation, and filter-condition handling. Minor gaps remain around what happens with zero matches versus ten-plus matches, which matters for a capped search.

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, but the description adds real meaning: query accepts artwork descriptors and negative conditions ("alt art", "not 1st Edition"), and lang selects a single language track with tracks never mixed. This goes beyond the schema's field-level text even though it does not restate the 160-character limit.

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?

The opening sentence names a specific verb (Search) and resource (graded Pokémon cards) and enumerates the three accepted query forms: name in zh/en/ja, community nickname, and set code + number. It also distinguishes scope from siblings by directing set-level questions to get_set_overview / set_species_summary and downstream price/trend work to the card_id-consuming tools.

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

Usage Guidelines4/5

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

Explicit routing exists: bare set codes or set names return a set-level summary you should follow to get_set_overview / set_species_summary, and card_id is the handoff key for the other tools. It also warns that artwork_filter/finish_filter must be read and that conflicting or unverified conditions do not permit quoting. It stops short of covering no-result or >10-match refinement paths, and does not clarify its relationship to the slang_lookup sibling for nickname resolution.

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