TCGdetect
Server Details
Any trading card question: catalog, prices, PSA population, and photo grades.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-03-26
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 16 tools
Several names collide conceptually: get_prices (card prices) vs get_pricing (API rate card) vs get_prices_batch, and search_cards vs find_card do overlapping catalog lookup (descriptions do give routing guidance). grade_card and submit_report are literally the same paid tool, and kiri_chat is an overlapping catch-all that can do catalog search, pricing, and PSA lookups already covered by dedicated tools.
The dominant pattern is clear snake_case verb_noun (get_card, list_sets, grade_card, search_cards), which reads predictably. Deviations are minor: bare noun 'account', the kiri_* tool family, and the deprecated submit_report alias that duplicates grade_card.
16 tools is slightly on the heavy side but each domain area (catalog, prices, population, grading reports, billing) is genuinely distinct. The only clearly redundant entry is the deprecated submit_report alias, which inflates the count by one.
Coverage is broad: catalog lookup, card detail, sets, prices (single and batch), PSA population, grading, report polling, PDF export, account/quota, and rate card. Gaps are modest — no direct collection CRUD endpoints despite collections being mentioned under kiri_chat, and no list_reports call to recover a report id without going through the original submission.
Available Tools
16 toolsaccountAInspect
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.
Inputs: no named parameters. Returns: object
find_cardAInspect
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 per UTC day, shared with the other free catalog calls.
Inputs: q, game, name, number, +2 more. Returns: cards, total, truncated, next_cursor
get_cardAInspect
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 day, shared with the other free catalog calls.
Inputs: card_id (required). Returns: object
get_populationAInspect
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.
Inputs: card_id (required). Returns: object
get_pricesAInspect
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, limited to 60 per minute and 1000 per key per UTC day, shared with the other free catalog calls.
Inputs: card_id (required). Returns: Prices in USD with numeric price_usd, currency, source, as_of, and stale.
get_prices_batchAInspect
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.
Inputs: card_ids (required). Returns: Prices in USD with numeric price_usd, currency, source, as_of, and stale.
get_pricingAInspect
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.
Inputs: no named parameters. Returns: object
get_reportAInspect
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.
Inputs: report_id (required). Returns: object
get_report_pdfAInspect
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.
Inputs: report_id (required), idempotency_key. Returns: object
grade_cardAInspect
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 per minute and 2 in flight.
Inputs: back (required), front (required), idempotency_key. Returns: object
identify_cardAInspect
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 release_date when known, not a grade or a use of the in-app scan allowance. Free, limited to 10 per minute and 20 per key per UTC day, on a cap separate from catalog search.
Inputs: front (required), back, idempotency_key. Returns: object
kiri_chatAInspect
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.
Inputs: message (required), back, front, estimate, +3 more. Returns: object
kiri_estimateAInspect
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.
Inputs: message (required), max_cost_usd. Returns: object
list_setsAInspect
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 calls.
Inputs: game, name, language. Returns: sets, total, truncated
search_cardsAInspect
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 total, truncated, next_cursor, language, rarity, release_date, and set_id. For nicknames or mixed free text such as "Moonbreon" or "Example Set Example Card", prefer find_card. Free, limited to 60 per minute and 1000 per key per UTC day, shared with the other free catalog calls.
Inputs: game, name, limit, cursor, +3 more. Returns: cards, total, truncated, next_cursor
submit_reportAInspect
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 and 2 in flight.
Inputs: back (required), front (required), idempotency_key. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Real sold prices, history & PSA population for graded Pokémon cards (EN/JP/CN). Knows nicknames.
Trading card prices, grading math, card shows, and collection and eBay tools for collectors.
Values graded sports cards and Pokémon/TCG slabs by grade from real sales. Free, read-only.
Find trading cards, compare listings, and check market prices.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to price trading cards and sealed products across 14 games with sourced, dated quotes, graded medians, PSA populations, eBay sold data and 365 days of history. Also supports card identification from free text or photo, batch lookups, and side-by-side price comparisons through 16 read-only tools.1MIT
- AlicenseAqualityDmaintenanceReal-time sports card pricing, market analysis, arbitrage detection, grading ROI, investment advice, and player stats (NBA/NFL/MLB). 9 tools for AI agents helping collectors and investors.924 PyPI3MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to look up trading-card market values across Pokémon, Magic, sports and other TCG catalogs, including raw prices by condition, graded ladders, price history, trending movers and set checklists. It also calculates grading ROI — gem premiums, net profit after fees, expected value and break-even gem rates — so collectors can decide whether a card is worth submitting.-
- FlicenseNot gradedqualityDmaintenanceProvides access to TCGplayer trading card data, including search, product details, pricing, and market information, enabling natural language queries for card analysis.1-
Glama MCP Gateway
Add one secure layer between your agents and this server.