search_cards
Pack: ygoprodeck · Endpoint: https://gateway.pipeworx.io/ygoprodeck/mcp
Search Yu-Gi-Oh! trading card game (TCG) cards by name (fuzzy), card type, attribute, monster race/type, archetype, or level. Returns matching cards with names, types, descriptions, ATK/DEF, attributes, archetypes, images, and TCGplayer card prices.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | Fuzzy card name match, e.g. “Dark Magician”, “Blue-Eyes”. |
type | string | no | Card type, e.g. ‘Effect Monster’, ‘Normal Monster’, ‘Spell Card’, ‘Trap Card’, ‘XYZ Monster’. |
attribute | string | no | Monster attribute, e.g. ‘DARK’, ‘LIGHT’, ‘EARTH’, ‘WATER’, ‘FIRE’, ‘WIND’, ‘DIVINE’. |
race | string | no | Monster type/race, e.g. ‘Spellcaster’, ‘Dragon’, ‘Warrior’. For Spell/Trap, the property e.g. ‘Continuous’, ‘Quick-Play’. |
archetype | string | no | Card archetype, e.g. “Blue-Eyes”, “Dark Magician”, “Sky Striker”. |
level | number | no | Monster level/rank, e.g. 7. |
num | number | no | Number of results to return (default 20, max 50). |
offset | number | no | Pagination offset (default 0). |
Example call
curl -X POST https://gateway.pipeworx.io/ygoprodeck/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_cards","arguments":{}}}'
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"ygoprodeck": {
"url": "https://gateway.pipeworx.io/ygoprodeck/mcp"
}
}
}
See Getting Started for client-specific install steps.