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.
- MCP endpoint:
https://mcp.tcgdetect.com/mcp(Streamable HTTP) - Official MCP Registry name:
com.tcgdetect/tcgdetect - Developer docs: https://tcgdetect.com/developers
- Support: contact@tcgdetect.com
Games currently covered: Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound.
Get an API key
- Create a free account at tcgdetect.com.
- Open Settings → Developer API (direct link).
- 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:
- Copy this folder to
~/.cursor/plugins/local/tcgdetect. - Reload the Cursor window (Developer: Reload Window).
- 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):
| Tool | Live 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_chat | Usage-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):
| Tool | What it does | Cost |
|---|---|---|
account | Confirm the key, wallet balance, remaining free quota, and trial reports left | Free |
get_pricing | Live rate card | Free |
search_cards | Find printings by name, set, number, language, or game | Free |
find_card | Ranked free-text / nickname lookup (for example “Moonbreon” or “Base Set Charizard 1st edition”) | Free |
list_sets | Set names, including Japanese-to-English title mapping | Free |
get_card | One catalog card by id (no prices or population) | Free |
get_prices | Single-card TCGplayer near-mint, PriceCharting ungraded, and graded comps | Free |
get_prices_batch | Prices for up to 50 cards in one call | Paid |
get_population | PSA population for one card | Paid |
identify_card | Identify a card from a front photo (back optional, unused). Not a grade. | Free (daily cap) |
kiri_estimate | Preview what a Kiri request might cost; does not run Kiri | Free |
kiri_chat | Natural-language catalog, price, population, or collection help | Paid (usage-based) |
grade_card | Full grading report from front and back photos (condition estimate, not a PSA/CGC/BGS grade) | Paid |
submit_report | Deprecated alias of grade_card | Paid |
get_report | Poll a grading report until it is completed or failed | Free |
get_report_pdf | PDF of a completed report | Paid |
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 theTCGDETECT_API_KEYvariable and logomcp.jsonand.mcp.json— same remote server config (Cursor Marketplace usesmcp.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.