Server data from the Official MCP Registry
Pokemon TCG MCP server: PSA grading, collection management, and multi-provider pricing.
Pokemon TCG MCP server: PSA grading, collection management, and multi-provider pricing.
tcg-mcp is a well-structured MCP server for Pokemon trading card grading and collection management with appropriate authentication patterns and security practices. Code is clean with proper input validation via Pydantic. Permissions align with the server's purpose (network access for APIs, local SQLite database, environment variables for credentials). Minor code quality observations noted but do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
3 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: PSA_API_TOKEN
Environment variable: POKEMONTCG_API_KEY
Environment variable: PRICECHARTING_TOKEN
Environment variable: TCG_DB_PATH
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-seanlok-tcg-mcp": {
"env": {
"TCG_DB_PATH": "your-tcg-db-path-here",
"PSA_API_TOKEN": "your-psa-api-token-here",
"POKEMONTCG_API_KEY": "your-pokemontcg-api-key-here",
"PRICECHARTING_TOKEN": "your-pricecharting-token-here"
},
"args": [
"tcg-mcp"
],
"command": "uvx"
}
}
}From the project's GitHub README.
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.
PSA grading (tcg_psa_*) — 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 (tcg_cgc_*, tcg_bgs_*) — 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 (tcg_collection_*) — 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 (tcg_pricing_*) — 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 (tcg_watchlist_*) — add target buy prices with thesis text,
list by horizon (flip / hold / sealed), update, and close with a reason
(bought / thesis_invalidated / manual).
Meta (tcg_list_providers) — 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 tcg_list_providers after install or read the
architecture doc.
The server works without any tokens — Pokemon TCG API queries, collection, and watchlist tools all function on a fresh install with zero credentials.
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
pipxpipx install tcg-mcp
tcg-mcp --help
pippython3 -m pip install tcg-mcp
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
Copy .env.example to .env and fill in any tokens you have:
cp .env.example .env
$EDITOR .env
Or set the env vars however your client supports it (most clients let you
specify env per MCP server in the config).
| Env var | Required for | Notes |
|---|---|---|
PSA_API_TOKEN | PSA tools | Get one — free |
POKEMONTCG_API_KEY | Higher Pokemon TCG API rate limit (optional) | Get one — free |
PRICECHARTING_TOKEN | PriceCharting tools | Paid subscription required |
TCG_DB_PATH | Local DB location | Default ~/.tcg-mcp/tcg.db |
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS),
%APPDATA%\Claude\claude_desktop_config.json (Windows), or
~/.config/Claude/claude_desktop_config.json (Linux):
{
"mcpServers": {
"tcg-mcp": {
"command": "uvx",
"args": ["tcg-mcp"],
"env": {
"PSA_API_TOKEN": "your-token-here",
"TCG_DB_PATH": "~/Documents/tcg-mcp.db"
}
}
}
}
Quit Claude Desktop fully (⌘Q on macOS — closing the window isn't enough) and relaunch.
claude mcp add tcg-mcp -- uvx tcg-mcp
Then export the tokens you have in the shell that runs claude.
Same shape — point the client at:
command: uvx
args: ["tcg-mcp"]
env: PSA_API_TOKEN=... # optional
After wiring up the client, ask it:
"Use tcg-mcp to list providers."
You should see pokemontcg enabled, plus psa enabled if your token is
set, and stubs for the others.
Then try a real lookup:
"Search Pokemon TCG API for Charizard ex from Obsidian Flames."
"Add a 1999 Pokemon Base Set Charizard #4 (raw) to my collection — paid $250 on 2026-04-15."
"Add Charizard ex Surging Sparks to my watchlist with a target buy price of $180."
"What's my collection cost basis?"
+----------------------+
| MCP client | Claude Desktop, Cursor, etc.
+----------+-----------+
| stdio (JSON-RPC)
+----------v-----------+
| server.py | FastMCP — tool registration, validation
+----------+-----------+
|
+-------+-------+----------------+
| | |
+--v--+ +--v--+ +----v----+
| psa | ... |pricing| | storage | SQLite — collection,
+--+--+ +--+----+ +----+----+ watchlist, pop trends,
| httpx | httpx | pricing snapshots
+--v---------------v----+ +----v----+
| PSA / Pokemon TCG | | tcg.db |
| API / PriceCharting | +---------+
+-----------------------+
Provider abstractions (providers/base.py,
pricing/base.py) make adding a new grader
or pricing source a single-file change. See
docs/adding-a-provider.md.
All your personal data — collection, watchlist, pricing snapshots, pop
snapshots — lives in a single SQLite file. Default location is
~/.tcg-mcp/tcg.db. Point TCG_DB_PATH at any path you prefer.
The file format is plain SQLite, so you can inspect or back up the data directly:
sqlite3 ~/.tcg-mcp/tcg.db
.tables
SELECT subject, grade, acquisition_price FROM owned_cards WHERE status='owned';
Schema is in src/tcg_mcp/storage/schema.sql.
Migrations are forward-only and idempotent (safe to run on every startup).
Brand field is the closest thing to a clean "set name" in
their schema. We surface it as set_name; for finer-grained set parsing,
reach into the raw payload.NotSupportedError if called. Implementation depends on either
grader publishing a public API or an explicit decision to support polite
scraping.PRICECHARTING_TOKEN the
provider is registered as disabled and graded-card prices aren't
available — but Pokemon TCG API still gives you raw market prices.tcg_pricing_snapshot_collection (bulk snapshot
with freshness check), tcg_pricing_get_history (time-series query),
rounded per-item valuation, clearer PSA 429 error message,
CHANGELOG.md.See CHANGELOG.md for the full version history.
Contributions welcome. To add a new grading or pricing provider, see
docs/adding-a-provider.md. The contract is
intentionally small: implement a Protocol method, register it conditionally
based on credentials, write a mock-httpx test.
# Run tests + lint locally
pytest
ruff check .
This project is independent. It is not affiliated with PSA, CGC, Beckett, The Pokemon Company, Nintendo, TCGPlayer, Cardmarket, PriceCharting, or any other organization. Each external API call is subject to that provider's Terms of Service.
MIT — see LICENSE.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.