find_card
Use this for any question that names a card in free text, including nicknames like Moonbreon, 1st edition or Shadowless, or an English or Japanese set title. Example: q="Example Set Example Card" or a nickname such as Moonbreon. Results are ranked with match_score, exact_match, variant, and a needs_clarification hint when more than one printing fits. Free, limited to 60 per minute and 1000 per key per UTC day, shared with the other free catalog calls.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text, for example 'Example Set Example Card', 'Moonbreon', or an English or Japanese set title. | |
| game | No | Optional game slug. | |
| name | No | Optional structured card name, if not using q. | |
| number | No | Optional collector number. | |
| language | No | Optional language filter. | |
| set_name | No | Optional set name, including JP/EN equivalents such as Ruler of the Black Flame. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cards | No | ||
| total | No | ||
| truncated | No | ||
| next_cursor | No |