canonical: https://jentic.com/apis/master-setter.com/master-setter

# Master Setter Pokémon TCG Catalog API

The Master Setter Pokémon TCG Catalog API returns read-only card and set data for the Pokémon Trading Card Game, modelled at the printing level: each card by language, finish, and set, which is what a scanner resolves and a collector or seller tracks. It covers 16 languages, from English and Japanese to Thai, Indonesian, and Latin American Spanish, with set ids such as en-base1 and card ids such as en-base1-4. You can list sets newest first, fetch one set with a card_count computed from the cards actually present, list a set's cards in number order, or search card names in each card's own language. A free key comes from a single request with an email address.

## For AI agents

Look up Pokémon TCG sets and cards with all their printings across 16 languages, list a set's cards, and search card names in their own language. Read-only, with a free key issued from one request.

## Scope

Does not handle card prices, marketplace listings, order processing, or collection storage. Use for read-only Pokémon TCG card and set catalog lookups only.

## Capabilities

- Fetch one card by id, such as en-base1-4, with every variant printing and its variant_label and images
- List every card in a set in number order with hp, types, rarity, artist, and regulation_mark
- Search card names with a case-insensitive contains-match in the card's own language, narrowed with the lang filter
- List sets newest first filtered by language, or fetch one set with a card_count computed from the cards present
- Page through large results with limit and offset and read the total_is_estimate flag on search totals
- Issue a free-tier key instantly by posting an email address

## Use cases

### Agent-run collection lookups through Jentic

A collector's agent can answer questions like 'which Japanese printings of this card exist' by calling Master Setter through Jentic. It searches the name in the right language with the q and lang filters, fetches the matching card by id to get all its variant printings, and reports rarity, artist, and image links, all read-only.

Example prompt: Search cards with q set to ピカチュウ and lang set to ja, pick the first result, fetch it by id, and list each variant_label with its large image

### Card scanner and inventory resolution

Scanner apps and seller tools need to resolve a physical card to an exact printing, not just a card name. Because the catalog models card by language, finish, and set, a scan can be matched to a card id such as en-base1-4 and its variants, so inventory lists track the specific printing being sold.

Example prompt: Fetch card en-base1-4, choose the variant whose variant_key matches the scanned finish, and return its id, name, rarity, and variant_label for the inventory record

### Set completion tracking

Master set collectors track every card in a set across printings. Fetching one set returns a card_count computed from the cards actually present, and listing the set's cards in number order gives a checklist to compare against a collection.

Example prompt: Fetch set ko-sv4a to read its card_count, then list all cards in that set with limit 200 and return the numbers missing from the user's collection list

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/cards` | Get one card with its printings, list a set's cards, or search by name |
| GET | `/v1/sets` | List sets or get one set with its real card count |
| POST | `/v1/keys` | Get a free API key |

## Key resources

- **Sets** — List sets by language, newest first, or get one set with its computed card count.
- **Cards** — Get one card with its printings, list a set's cards, or search by name.
- **Keys** — Issue a free-tier API key for an email address.

## 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:** 63 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 90 / 100
  - Developer Experience & Jentic Compatibility: 65 / 100
  - AI-Readiness & Agent Experience: 46 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 50 / 100
- **View full report:** https://jentic.com/apis/master-setter.com/master-setter/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 Master Setter by hand means requesting a key, sending it as a bearer token, and handling language codes, pagination, and the monthly quota headers yourself. Through Jentic you install once, import Master Setter from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Master Setter takes set and card ids as query parameters rather than path segments, so rules bound which operations your agent may call, not which set. You choose the operations it may call, so key creation is not included unless you add it.
- **Credential handling:** Your Master Setter 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 'find a Pokémon card's printings' or 'list cards in a set', and Jentic returns the matching Master Setter operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Pokémon TCG API** — Pokémon TCG API offers card and set data focused on English printings.
- **TCGdex** — TCGdex is an open multilingual Pokémon card database that Master Setter draws some content from.
- **Magic: The Gathering API** — Card and set data for Magic: The Gathering.
- **CompsAPI** — Sales comparables for collectibles, adding price context to catalog data.

## FAQ

### What authentication does the Master Setter Pokémon TCG Catalog API use?

The Master Setter API authenticates with a bearer token per its OpenAPI spec: send Authorization: Bearer with your mst_ key. The key-creation route, POST `/v1/keys`, is open and returns a free key for an email address. Through Jentic the key is stored encrypted on your own instance and injected at call time.

### Is there a Master Setter MCP server?

You don't need an MCP server to give your agent the Master Setter catalog. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls it. Operations are discovered on demand, so your agent's context stays free of another server's tool definitions.

### Can I limit what my agent is allowed to do with the Master Setter API?

Yes. Write a rule that allows only GET `/v1/cards` and GET `/v1/sets`, so the agent can look up and search the catalog but cannot request new keys. Every call it makes is logged.

### What are the rate limits for the Master Setter API?

The spec states the free tier allows 1,000 requests a month, and every response carries X-RateLimit-Limit, X-RateLimit-Used, and X-RateLimit-Remaining headers so your agent can track its position. Key creation is limited to one active free key per email and at most 3 new keys per IP per day.

### How do I search for cards in Japanese or Korean?

Names are stored in each card's own language, so search with the native name: pass q with the Japanese or Korean name to GET `/v1/cards` and add lang set to ja or ko to restrict results to that language. Search totals are estimates, flagged by total_is_estimate.

### How do I look up a card's printings with Master Setter through Jentic?

Search Jentic for an intent like 'look up a Pokémon card's printings', import the Master Setter API, and store your key once. Your agent then calls GET `/v1/cards` with an id such as en-base1-4 and reads every variant printing. To run it on your own infrastructure, install Jentic One from its GitHub repo.