MCP.Market

TCG MCP server

by seanlok·io.github.seanlok/tcg-mcp·v0.4.0·1 stars
No reviews yet

Pokemon TCG MCP server: PSA grading, collection management, and multi-provider pricing.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

1 stars33 downloads/wk

Reviews

Write one

Nobody has reviewed TCG MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

TCG MCP tools (33, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • tcg_bgs_get_cert

    BGS cert lookup — stubbed. Beckett has no official public API.

  • tcg_catalog_get_set

    Fetch a Pokemon TCG set's metadata (name, total cards, release date, …).

  • tcg_catalog_list_cards_in_set

    List every card in a set (optionally filtered by rarity), with TCGPlayer market price where available. Useful for set-completion analysis and rarity-tier breakdowns.

  • tcg_catalog_search_set

    Search Pokemon TCG sets. Returns set IDs, names, release dates, totals.

  • tcg_cgc_get_cert

    CGC cert lookup — stubbed. CGC has no official public API.

  • tcg_collection_add_card

    Record a card as owned in the local SQLite DB.

  • tcg_collection_add_sealed

    Record sealed product as owned.

  • tcg_collection_attach_pricing

    Map an owned card to a pricing listing for live valuation.

  • tcg_collection_get

    Fetch a single owned card by its card_id.

  • tcg_collection_list

    List cards in the local collection, with optional filters and pagination.

  • tcg_collection_removewrite action

    Remove a card. Default is a soft-delete: status -> 'sold' and the row stays.

  • tcg_collection_search

    Search owned cards across subject, set_name, brand, variety, notes, and tags — richer than `tcg_collection_list`'s subject-only filter.

  • tcg_collection_set_completion

    Compute set-completion progress for a Pokemon TCG set.

  • tcg_collection_updatewrite action

    Update mutable fields on a collection card (cost basis, notes, status, ...).

  • tcg_collection_value

    Cost-basis summary across the collection.

  • tcg_collection_value_with_market

    Cost basis + live market value across the collection.

  • tcg_list_providers

    Show which grading / pricing providers are enabled in this process.

  • tcg_pricing_get

    Fetch the full PriceQuote for one listing on the chosen provider.

  • tcg_pricing_get_card

    Smart-routed price lookup. One call, the right provider(s) under the hood.

  • tcg_pricing_get_history

    Return the time series of pricing snapshots saved for one listing.

  • tcg_pricing_search

    Search a pricing provider for matching products.

  • tcg_pricing_snapshot

    Fetch a price quote and write it as a row in the pricing_snapshots table.

  • tcg_pricing_snapshot_collection

    Walk the collection and snapshot every owned card with an attached pricing listing, respecting per-provider rate limits.

  • tcg_psa_add_to_collection

    Look up a PSA cert AND record it in your local collection in one step.

  • tcg_psa_get_cert

    Look up a single graded card by its PSA cert number.

  • tcg_psa_get_images

    Fetch front/back image URLs for a PSA graded card.

  • tcg_psa_pop_trend

    Return the time series of pop snapshots we've captured for a card spec.

  • tcg_psa_snapshot_pop

    Capture today's PSA pop data for the spec backing this cert.

  • tcg_watchlist_add

    Add a card to the watchlist with a target buy price + thesis.

  • tcg_watchlist_close

    Mark a watchlist entry closed (bought / thesis_invalidated / manual).

  • tcg_watchlist_get

    Fetch a single watchlist entry by id.

  • tcg_watchlist_list

    List watchlist entries with optional horizon filter.

  • tcg_watchlist_updatewrite action

    Update mutable fields on a watchlist entry.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan22 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 146 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How TCG MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
33
the typical server has 7
Tools that change things
9%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,688 servers
Downloads a week
33
more than 22% of 12,191 servers with a package

What its tools let an agent do: 30 read · 3 change

Install TCG MCP in Claude Code, Cursor or VS Code

claude mcp add tcg-mcp -- uvx tcg-mcp
Add to Cursor

What the publisher says

From the TCG MCP repository's README, as published. We do not edit it. Read it on GitHub

tcg-mcp

<!-- mcp-name: io.github.seanlok/tcg-mcp -->

A Pokemon TCG MCP server. Looks up graded cards (PSA today, CGC/BGS

stubbed), manages your owned collection in a local SQLite DB, queries

pricing providers (Pokemon TCG API + PriceCharting), tracks a watchlist

with target prices, and snapshots PSA pop counts so you can see trends

over time.

tcg-mcp is a Model Context Protocol server. Install it once, wire it into Claude Desktop / Claude Code / Cursor / any MCP client, and your assistant gains 25 tools for working with PSA cert data, your personal collection, and live market prices.

What it does — 25 tools, namespaced

PSA grading (tcgpsa) — cert lookup, front/back images, snapshot pop data over time, plus a workflow tool that looks up a cert and records it as owned in one call.

CGC / BGS (tcgcgc, tcgbgs) — stubs in v0.2; no public API exists for either grader. Listed for routing parity; will route cleanly if either grader publishes an API.

Collection (tcgcollection) — add raw or graded cards (or sealed products: ETBs, booster boxes, UPCs, tins), list with filters, update cost basis, soft-delete (mark sold) or hard-delete, attach a card to a pricing listing, get a cost-basis summary or a live market valuation that joins against the most recent pricing snapshots.

Pricing (tcgpricing) — search a provider, get a full price quote (top-level market/low/high plus per-variant breakdown for Pokemon TCG API, plus per-grade levels for PriceCharting), persist snapshots into the local DB, bulk-snapshot every attached card in one call with per-provider rate-limit awareness, and query historical snapshots as a time series for trend analysis.

Watchlist (tcgwatchlist) — add target buy prices with thesis text, list by horizon (flip / hold / sealed), update, and close with a reason (bought / thesis_invalidated / manual).

Meta (tcglistproviders) — discovery tool that shows which grading + pricing providers are enabled, what env var each needs, and what tools are in the namespace.

For the full tool list run tcglistproviders after install or read the architecture doc.

Prerequisites

up at psacard.com/publicapi.

  1. Python 3.10 or newer (3.13 recommended).
  2. An MCP client — Claude Desktop, Claude Code, Cursor, Continue, etc.
  3. (Optional, for PSA tools only) A PSA Public API token — free, sign

The server works without any tokens — Pokemon TCG API queries, collection, and watchlist tools all function on a fresh install with zero credentials.

Install

Option A — uvx (recommended, zero install)

# install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# run the server (auto-installs the package on first use)
uvx tcg-mcp --help

Option B — pipx

pipx install tcg-mcp
tcg-mcp --help

Option C — pip

python3 -m pip install tcg-mcp

Option D — from source (for contributors)

git clone https://github.com/seanlok/tcg-mcp.git
cd tcg-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest        # run the test suite

Configure

Copy .env.example to .env and fill in any tokens you have:

cp .env.example .env
$EDITOR .env

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

TCG MCP: common questions

Is TCG MCP server safe?
Mostly: it is graded B (72/100). Read the TCG MCP safety report
How do I install TCG MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does TCG MCP need an API key?
Yes. The registry entry asks for PSA_API_TOKEN, POKEMONTCG_API_KEY, PRICECHARTING_TOKEN.
Is TCG MCP maintained?
The last commit was 183 days ago (2026-05-05). The latest release is v0.4.0.
How does TCG MCP compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 33 (the typical server has 7); tools that change things 9% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.