POKEKA — Pokémon Card Prices

Search cards

search_card

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`lang`	No	Optional language track filter.
`query`	Yes	Card name, nickname/slang, or set code + number. zh/en/ja all accepted.

Output Schema

TableJSON Schema

Name	Required	Description
`hint`	No
`lang`	No
`query`	No
`sample`	No
`by_lang`	No
`results`	No
`guidance`	No
`mismatch`	No
`set_code`	No
`by_rarity`	No
`condition`	No	"raw" when the user asked for an ungraded card
`guess_note`	No
`match_kind`	No	species \| card_name \| guess — guess means nothing matched and the results are prefix guesses, never price from them
`query_type`	No	"set" = the query was a bare set code/name; read guidance and use the set-level tools
`set_tracks`	No	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`	No	true only when set, number AND every other entity in the query (character, nickname, language) agree with the results
`total_cards`	No
`query_intent`	No
`related_sets`	No	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`	No
`entity_anchor`	No
`rarity_filter`	No
`safe_to_price`	No	true = results[0] can be priced without asking the user to confirm; false = candidates only
`grading_filter`	No
`qualifier_note`	No
`unresolved_note`	No
`also_matched_sets`	No
`unresolved_tokens`	No	words from the question that were NOT used to choose the card
`qualifiers_dropped`	No
`query_constraint_note`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedSep 27, 2026

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"
+}

Changed4 schema fields changedSep 23, 2026

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"

Changed6 schema fields changedSep 11, 2026

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"
+}

Changed7 schema fields changedSep 3, 2026

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"
+}

Changed18 schema fields changedAug 27, 2026

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"
+}
```

Changed3 schema fields changedJul 31, 2026

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"
+}

First observedJul 29, 2026

TDQS

A4.6/5.0

Behavior4/5

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

With annotations present, the description still adds meaningful behavior: results are capped at 10 with a truncation-avoiding fallback for set-level queries, and 'Calls record usage and query metadata within POKEKA' explains why readOnlyHint is false for what looks like a read. It stops short of describing result ordering or emptiness behavior.

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?

It is dense but front-loaded: the primary search surface comes first, then the return/handoff contract, then the set-code fallback. The bilingual sentence is redundant for an English-reading agent but not wasteful, and no filler sentences are present.

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?

An output schema exists so return values need no explanation, yet the description still supplies the fields the agent needs to act (card_id, rarity/variant/species). Combined with the fallback routing and language-track rules, an agent can invoke this correctly without further context.

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 a 3 is the baseline, but the description goes further by giving concrete query syntax examples ('sv8a 喷火龙', 'CEL 4'), explaining that zh/en/ja are all accepted, and clarifying that lang restricts to one track with no mixing.

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 description names a specific verb (search) and resource (graded Pokémon cards) plus the three accepted query modes: name in three languages, community nickname, or set code + card number. It also distinguishes its role from siblings by stating it returns card_id for use with pricing/history/population tools.

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

Usage Guidelines5/5

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

It gives explicit usage conditions and even an edge-case routing rule: a bare set code or set name returns a set-level summary and the agent should follow it to get_set_overview / set_species_summary. It also documents the optional lang filter behavior and that language tracks are never mixed.

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

All POKEKA — Pokémon Card Prices tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?