canonical: https://jentic.com/apis/pokemontcg.io/pokemontcg

# Pokemon TCG API

The Pokemon TCG API provides access to Pokemon Trading Card Game data, letting you search cards by name, type, set, and rarity and retrieve full card details by id. It also serves card sets and the reference lists of types, subtypes, supertypes, and rarities used across the game. The API is free to use, with an optional API key that raises rate limits.

## For AI agents

Search Pokemon Trading Card Game cards by name, type, set, and rarity, retrieve card and set details, and list types, subtypes, supertypes, and rarities. Free to use with an optional API key.

## Scope

Does not handle deck building, user accounts, or marketplace transactions. Use for Pokemon TCG card and set data lookup only.

## Capabilities

- Search Pokemon trading cards by name, type, set, and rarity
- Retrieve a single card by its id with full details
- Search card sets and retrieve set details
- List the card types, subtypes, and supertypes in the game
- List the rarities used across the card game

## Use cases

### AI Card Data Agent

An AI agent connected to the Pokemon TCG API through Jentic can answer questions about cards by searching the catalog, retrieving a card by id, and reading its set and rarity. Because the data is free to query, the agent can resolve card references for deck tools or chat assistants without a paid data source.

Example prompt: Search cards for a name, retrieve the top match by id, and report its set and rarity

### Card Search and Lookup

Search Pokemon cards with query filters for name, type, set, and rarity, then fetch the full record of a chosen card by id. The API returns structured card data an application can display or index.

Example prompt: Search for cards of a given type in a specific set and retrieve the first result by id

### Set and Reference Data

Build card tools on top of the game's reference data: sets, types, subtypes, supertypes, and rarities. The API lists each of these so an application can populate filters and validate user input against real values.

Example prompt: List the available sets and the full set of card rarities to populate a filter

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/cards` | Search cards |
| GET | `/cards/{id}` | Get a card by id |
| GET | `/sets` | Search sets |
| GET | `/sets/{id}` | Get a set by id |
| GET | `/types` | List card types |
| GET | `/rarities` | List card rarities |

## Key resources

- **Cards** — Trading cards searchable by name, type, set, and rarity, with details by id
- **Sets** — Card sets, searchable and retrievable by id
- **Reference** — Types, subtypes, supertypes, and rarities used across the game

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 58 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 56 / 100
  - AI-Readiness & Agent Experience: 40 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 50 / 100
- **View full report:** https://jentic.com/apis/pokemontcg.io/pokemontcg/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Pokemon TCG API by hand means attaching an optional key header and learning its card, set, and reference endpoints yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The Pokemon TCG API is read-only and carries its filters in the query string, so a rule bounds which operations your agent may call rather than which query. A rule can allow card and set lookups while leaving the type and rarity listings out unless you add them.
- **Credential handling:** Your Pokemon TCG API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'search for a Pokemon card', and Jentic returns the matching Pokemon TCG operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **TCGdex** — Multilingual Pokemon TCG card database, a direct alternative data source.
- **Magic: The Gathering** — Card data for a different trading card game, where this API covers Pokemon.
- **PokeAPI** — Pokemon species and video-game data, complementing the trading card data here.

## FAQ

### Is there a Pokemon TCG MCP server?

You don't need an MCP server to give your agent the Pokemon TCG API. Jentic connects it directly from the API Directory: import it, store your optional API key once, and your agent can search cards and sets. Operations are discovered on demand, so your agent's context stays lean.

### Can I limit what my agent is allowed to do with the Pokemon TCG API?

Yes. The Pokemon TCG API is read-only and carries its filters in the query string, so a rule bounds which operations your agent may call. Write a rule that allows only card and set lookups, leaving the type and rarity listings out unless you add them, and every call is logged.

### What authentication does the Pokemon TCG API use?

The Pokemon TCG API accepts an optional API key sent in the X-Api-Key header per its OpenAPI spec, and providing one raises your rate limits. With Jentic, the key is stored encrypted by your own Jentic One instance and injected at call time.

### Can I search for a card by rarity with the Pokemon TCG API?

Yes. The cards endpoint accepts query filters for name, type, set, and rarity, so an agent can narrow results to a specific rarity. You can then retrieve the full record of a matching card by its id.

### What are the rate limits for the Pokemon TCG API?

The spec notes that an API key raises your rate limits but does not state the numbers. Check the Pokemon TCG developer documentation at https://docs.pokemontcg.io for current limits.

### How do I search for a card with the Pokemon TCG API through Jentic?

Import the Pokemon TCG API from the Jentic API Directory, store your optional API key once, and have your agent search by intent such as 'search for a Pokemon card'. Jentic returns the search operation with its input schema, and your agent passes the query filters. To run it on your own infrastructure, install Jentic One from its GitHub repo.