TCGdetect

Remote MCP for trading-card data: catalog search, TCGplayer and PriceCharting prices, PSA population, photo identification, and AI grading reports for Pokémon (EN/JP), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound. Free catalog, prices, and photo ID (20/day); paid tools use a prepaid wallet. Bearer API key from tcgdetect.com.

Hosted MCP Server

npx add-mcp 'https://mcp.tcgdetect.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

TCGdetect

A Cursor (and Agent Plugins) package for the TCGdetect remote MCP server. It gives an agent access to trading-card catalog data, market prices, PSA population, photo identification, and grading reports.

This repository is the public plugin package only: manifests, MCP config, logo, and docs. It does not include the TCGdetect server source.

Games currently covered: Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound.

Get an API key

  1. Create a free account at tcgdetect.com.
  2. Open Settings → Developer API (direct link).
  3. Create a key. It starts with tcgdev_live_.

Treat the key like a password. Do not commit it, put it in a plugin file, or paste it into a public issue or review form. The manifests only reference ${TCGDETECT_API_KEY}.

Install in Cursor

After this package is listed, install TCGdetect from the Cursor Marketplace or cursor.directory, then set your key under Plugins → Configure.

To try the package locally before it is listed:

  1. Copy this folder to ~/.cursor/plugins/local/tcgdetect.
  2. Reload the Cursor window (Developer: Reload Window).
  3. Open Customize, confirm the TCGdetect MCP server is present, and set TCGDETECT_API_KEY.

You can also add the server yourself in mcp.json:

{
  "mcpServers": {
    "tcgdetect": {
      "url": "https://mcp.tcgdetect.com/mcp",
      "headers": {
        "Authorization": "Bearer ${TCGDETECT_API_KEY}"
      }
    }
  }
}

initialize and tools/list work without a key. Tool calls that read your account or spend quota need a key.

Free vs paid

A key is free. Catalog search, card details, single-card prices, set lookup, photo identification, account status, the live rate card, Kiri cost estimates, and polling a report do not debit the wallet. Photo identification is capped (20 per key per UTC day). Some free catalog calls share a daily cap.

Paid tools debit a prepaid USD wallet (top up at tcgdetect.com):

ToolLive rate (13 Nov 2026, America/New_York)
get_population$0.01 per successful PSA lookup (a miss is still charged)
get_prices_batch$0.05 per success (up to 50 cards; prefer free get_prices for a few cards)
kiri_chatUsage-based; a per-request hold is reserved. Call kiri_estimate first.
grade_card$0.30 per successful report, or $0.25 when the wallet balance is at least $250. submit_report is a deprecated alias of the same tool.
get_report_pdf$0.05 per success, only after the report is completed

Accounts may include free trial reports; check account for how many remain. A failed report releases its hold. Rates can change — ask the agent to call get_pricing (free, no key required) for the current rate card.

Tools

Fetched live from tools/list on the MCP on 13 Nov 2026 (America/New_York):

ToolWhat it doesCost
accountConfirm the key, wallet balance, remaining free quota, and trial reports leftFree
get_pricingLive rate cardFree
search_cardsFind printings by name, set, number, language, or gameFree
find_cardRanked free-text / nickname lookup (for example “Moonbreon” or “Base Set Charizard 1st edition”)Free
list_setsSet names, including Japanese-to-English title mappingFree
get_cardOne catalog card by id (no prices or population)Free
get_pricesSingle-card TCGplayer near-mint, PriceCharting ungraded, and graded compsFree
get_prices_batchPrices for up to 50 cards in one callPaid
get_populationPSA population for one cardPaid
identify_cardIdentify a card from a front photo (back optional, unused). Not a grade.Free (daily cap)
kiri_estimatePreview what a Kiri request might cost; does not run KiriFree
kiri_chatNatural-language catalog, price, population, or collection helpPaid (usage-based)
grade_cardFull grading report from front and back photos (condition estimate, not a PSA/CGC/BGS grade)Paid
submit_reportDeprecated alias of grade_cardPaid
get_reportPoll a grading report until it is completed or failedFree
get_report_pdfPDF of a completed reportPaid

Photo inputs are JPEG, PNG, or WebP data URLs. Minimum 250px on a side; keep each image around 350KB or smaller. Reports require front and back; identify requires front.

Example prompts

  • What’s my TCGdetect wallet balance and remaining free identify quota?
  • Find Base Set Charizard and give the English unlimited near-mint price.
  • What’s the English name for the Japanese set Ruler of the Black Flame?
  • Look up the PSA population for that Charizard printing.
  • Here’s a photo of a card — what printing is it?
  • What would it cost to ask Kiri about Moonbreon prices? Estimate first, don’t run it yet.
  • What’s the current TCGdetect rate card?

Use paid tools only when you intend to spend wallet funds. For grading, provide clear front and back photos and expect the report to be a condition estimate, not an official PSA, CGC, or BGS grade.

Package layout

  • plugin.json — Agent Plugins 1.0 manifest (portable; reusable later for a Codex plugin ZIP)
  • .cursor-plugin/plugin.json — Cursor plugin manifest, including the TCGDETECT_API_KEY variable and logo
  • mcp.json and .mcp.json — same remote server config (Cursor Marketplace uses mcp.json; cursor.directory auto-detects .mcp.json)
  • assets/logo.png — official 512×512 TCGdetect mark (black background plate)
  • LICENSE — MIT, copyright TCGdetect

A future OpenAI Codex / ChatGPT directory submission can start from this package. That portal currently requires an OAuth connection flow for public review, which this MCP does not implement yet, so this repo does not include OpenAI listing extensions.

Validate manifests with python3 scripts/validate.py.