Skip to content
MCP server

TCGdetect

Trading card prices, PSA population and AI photo grading for Pokémon, MTG and more

Status and history

Answered our latest tool-list check 3 hours ago with 16 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.1.0
Listing updated
2 days ago

About TCGdetect

TCGdetect is a freemium MCP server for antiques and collectibles. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.tcgdetect.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tcgdetect": {
      "url": "https://mcp.tcgdetect.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (16)

Read directly from the server.

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

What it does

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

Pricing

Freemium

Free lookups with rate limits; pay-per-use for batch prices, population ($0.01), grading reports ($0.30)

Prices change. Check tcgdetect.com before you buy.

TCGdetect 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 to TCGdetect

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. A Galaga-style space shooter played from below, open to humans and AI agents

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory
  5. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play