# TCGdetect

> TCGdetect is a freemium MCP server for antiques and collectibles. Trading card prices, PSA population and AI photo grading for Pokémon, MTG and more. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://tcgdetect.com/developers
- **MCP Registry name:** com.tcgdetect/tcgdetect
- **Categories:** antiques and collectibles, games and play
- **Listing updated:** 2026-11-15

## About

Behind the MCP endpoint is a self-serve API covering Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece and Riftbound. Any signed-up account can create a key in Settings, and no Pro or Elite upgrade is needed. The tool list can be read without a key, but calling a tool needs a valid bearer key.

Prices come as the latest snapshot only: a TCGplayer near-mint market figure, a PriceCharting ungraded figure, and graded prices when they are stored. The site states plainly that there is no price-history endpoint. PSA population is looked up per TCGdetect catalog card id rather than by PSA spec id.

Photo grading takes front and back images and returns an estimate, not a PSA, CGC or BGS grade. Free calls share 60 requests per minute and 1,000 per UTC day, while batch prices, population lookups, grading reports and the natural-language Kiri endpoint are charged per use.

## Features

- **Card search and lookup:** Search the catalog, find a single card or list sets through the free search_cards, find_card, list_sets and get_card calls.
- **Latest price snapshot:** get_prices returns the TCGplayer near-mint market price, the PriceCharting ungraded price and stored graded prices.
- **PSA population by card id:** Looks up PSA population for one catalog card id, at $0.01 per successful lookup.
- **AI photo grading:** grade_card starts a report from front and back photos and returns an estimated grade, with an optional PDF.
- **Batch pricing:** Prices for up to 50 cards in one request cost $0.05.
- **Natural-language requests:** The Kiri endpoint answers plain-language questions and offers a free cost estimate first.

## Good for

- Check the current market price of a Pokémon or Magic card from an AI chat
- Look up PSA population for a specific catalog card
- Estimate a card's condition from front and back photos before sending it for grading
- Price a batch of up to 50 cards for a collection review
- Identify a card from a photo and get its catalog match

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tcgdetect https://mcp.tcgdetect.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tcgdetect.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tcgdetect": {
      "url": "https://mcp.tcgdetect.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tcgdetect": {
      "type": "http",
      "url": "https://mcp.tcgdetect.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tcgdetect": {
      "serverUrl": "https://mcp.tcgdetect.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tcgdetect": {
      "type": "http",
      "url": "https://mcp.tcgdetect.com/mcp"
    }
  }
}
```

## Tools

- `account`: Use this for any question about whether this API key works, how much wallet balance is left, remaining free catalog or identify quota, or how many free trial reports remain. The response names the key (name and prefix) so you can tell keys apart. An invalid key is rejected and is not charged. Free, limited to 120 per minute.
- `get_card`: Use this for any question about one catalog card once you already have its id. It returns the name, set, collector number, image, language (en or ja), and rarity for Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound. Unknown language or rarity is null, and it does not return prices or PSA population. Free, limited to 60 per minute and 1000 per key per UTC da
- `search_cards`: Use this for any question about which trading card printing in Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound matches a name, set, or collector number. Filters are applied before the cap; pass number for 4/102, H9, or TG06 and omit set_name unless the user named the set, because H9 matches a stored H09 and a name ending in (H9); the response includes tota
- `kiri_chat`: Use this for any natural-language request that should search the catalog, check prices or PSA population, or work with a collection. The cost is usage-based and varies with complexity. Grades and PSA lookups it completes are charged at their listed prices. usage-based, holds $0.4212 per request, limited to 10 per minute and 100 per key per UTC day and 2 in flight.
- `kiri_estimate`: Use this for any question about what a Kiri request might cost before you spend. It returns a cost range and the maximum hold, and it does not run Kiri. Grades and PSA lookups on a live request are charged at their listed prices. Free, limited to 30 per minute and 300 per key per UTC day.
- `get_population`: Use this for any question about how many copies PSA has graded, or how scarce a PSA grade is. Population is PSA only, for cards in Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound. A card with no stored population is still a successful paid lookup, and a missing card id is not charged. $0.01 per success, limited to 120 per minute.
- `get_prices_batch`: Use this for any question that needs prices for more than about 10 trading cards at once, up to 50. For a few cards, call get_prices (free) per card instead of this $0.05 batch. Each card includes raw_nm, raw_pc, and graded prices when stored, and one successful call has one charge. $0.05 per success, limited to 30 per minute.
- `get_prices`: Use this for any question about what one trading card is worth. raw_nm is the TCGplayer near mint market price; raw_pc is the PriceCharting ungraded average sale; graded is PriceCharting sold comps by vendor and grade, all USD, with source, as_of, and a stale flag. A card with no stored prices is still a successful free lookup; PSA 9.5 is omitted because PSA does not issue that grade. Free, limite
- `get_pricing`: Use this for any question about what a TCGdetect API or MCP call costs right now. It returns the live rate card, including free calls and wallet prices. No API key is required. Free.
- `submit_report`: Use this for any follow-up that already thinks of the call as submit_report; prefer grade_card, which is the same tool. Deprecated alias of grade_card: front and back JPEG, PNG, or WebP data URLs required (min 250px, keep under ~350KB). The report is an estimate, not a PSA, CGC, or BGS grade. $0.30 per successful report ($0.25 when the wallet balance is at least $250.00), limited to 10 per minute 
- `grade_card`: Use this for any question that asks you to grade a trading card from photos. Prefer this name; submit_report is a deprecated alias of the same paid report (front and back photos required). It returns identity, a condition estimate (not a PSA/CGC/BGS grade), centering, defects, prices, and PSA population. $0.30 per successful report ($0.25 when the wallet balance is at least $250.00), limited to 10
- `get_report`: Use this for any follow-up after a grading report was started and you need the finished grade, centering, defects, prices, or PSA population. Poll until the status is completed or failed. Polling itself is not charged, and a failed report releases the hold. Free, limited to 120 per minute.
- `get_report_pdf`: Use this for any request for a PDF of a finished TCGdetect grading report. Call it only after get_report says the report is completed. You are charged only when the PDF is returned. $0.05 per success, limited to 30 per minute.
- `identify_card`: Use this for any question that starts with photos and asks what the trading card is. Send a front JPEG, PNG, or WebP data URL (min 250px, keep under ~350KB); a back photo is optional and is not used, and the call typically takes 15-20 seconds. It returns a catalog match for Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound, including set_id, game_id, and rel
- `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
- `list_sets`: Use this for any question about set names, including mapping a Japanese set title such as Ruler of the Black Flame to Obsidian Flames. Filter by name and an optional game slug (pokemon, mtg, yugioh, onepiece, riftbound) or language en/ja. Each row includes id, name, game, language, and release_date. Free, limited to 60 per minute and 1000 per key per UTC day, shared with the other free catalog cal

## FAQ

### Do I need an account?

Yes. Any signed-up account can create a tcgdev_live_ key in Settings; tools/list works without one but tools/call needs a key.

### Does it give price history?

No. The site says there is no price-history endpoint; prices are the latest snapshot.

### Is the photo grade an official grade?

No. The result is an estimate, not a PSA, CGC or BGS grade.

### What are the free limits?

Search, find, sets, card and price lookups share 60 requests per minute and 1,000 per UTC day; card identification from a photo allows 10 per minute and 20 per day.

### Is TCGdetect free?

TCGdetect has a free plan, with paid plans for more usage or features.

### How do I add TCGdetect to Claude Code?

Run this command in your terminal: claude mcp add --transport http tcgdetect https://mcp.tcgdetect.com/mcp

### What are the best alternatives to TCGdetect?

The closest alternatives to TCGdetect are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vector Alienspace.

## Alternatives

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/tcgdetect
