TCG MCP

Name: TCG MCP
Author: seanlok

von seanlokVersion 0.4.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.seanlok/tcg-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu↓ 26/Wo. · ★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Spiele, Sport, Essen & Lernen
Das musst du eintragen: PSA_API_TOKEN, POKEMONTCG_API_KEY, PRICECHARTING_TOKEN

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: PSA_API_TOKEN, POKEMONTCG_API_KEY, PRICECHARTING_TOKEN, TCG_DB_PATH

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "tcg": {
      "command": "uvx",
      "args": [
        "tcg-mcp"
      ],
      "env": {
        "PSA_API_TOKEN": "your-value",
        "POKEMONTCG_API_KEY": "your-value",
        "PRICECHARTING_TOKEN": "your-value",
        "TCG_DB_PATH": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add tcg --env PSA_API_TOKEN=your-value --env POKEMONTCG_API_KEY=your-value --env PRICECHARTING_TOKEN=your-value --env TCG_DB_PATH=your-value -- uvx tcg-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "tcg": {
      "command": "uvx",
      "args": [
        "tcg-mcp"
      ],
      "env": {
        "PSA_API_TOKEN": "your-value",
        "POKEMONTCG_API_KEY": "your-value",
        "PRICECHARTING_TOKEN": "your-value",
        "TCG_DB_PATH": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "tcg": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tcg-mcp"
      ],
      "env": {
        "PSA_API_TOKEN": "your-value",
        "POKEMONTCG_API_KEY": "your-value",
        "PRICECHARTING_TOKEN": "your-value",
        "TCG_DB_PATH": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

PSA_API_TOKEN geheim env
PSA Public API bearer token. Get one at https://www.psacard.com/publicapi. If unset, PSA tools are disabled but other tools (Pokemon TCG API, collection, watchlist) still work.
POKEMONTCG_API_KEY geheim env
Pokemon TCG API key (optional). Without it the provider still works at a lower rate limit. Free key: https://dev.pokemontcg.io/
PRICECHARTING_TOKEN geheim env
PriceCharting API token (paid subscription required). Enables graded-card pricing.
TCG_DB_PATH env
Where to put the local SQLite database. Default: ~/.tcg-mcp/tcg.db

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 9. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto seanlok bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni

Mehr Sterne als 0 % der anderen 1311 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 7 % der anderen 1311 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1311 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist TCG MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: PSA_API_TOKEN, POKEMONTCG_API_KEY, PRICECHARTING_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.4.0) kam vor 6 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: ThinkerNotes, Tandoor Recipe MCP, Slotlock

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

ThinkerNotes

Search and read your own notes: insights, drafts, book and podcast notes. Read-only, OAuth.

von thinkernotes.comGanz neuAktualisiert heute

Läuft in der Cloud✓ thinkernotes.com

Installieren

Tandoor Recipe MCP

Recipes, meal plans, shopping lists and more for your local or self-hosted Tandoor instance.

von CliftonzAm Anfang↓ 789/Wo.Aktualisiert heute

Läuft auf deinem Computer

Installieren

Slotlock

Calendars for AI agents: free/busy, next free slot, and bookings PostgreSQL never double-books.

von PILOTAAIGanz neuAktualisiert heute

Läuft auf deinem Computer

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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 (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.

Prerequisites

Python 3.10 or newer (3.13 recommended).
An MCP client — Claude Desktop, Claude Code, Cursor, Continue, etc.
*(Optional, for PSA tools only)* A PSA Public API token — free, sign up at psacard.com/publicapi.

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

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`

Wire it into your MCP client

Claude Desktop

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 Code

claude mcp add tcg-mcp -- uvx tcg-mcp

Then export the tokens you have in the shell that runs claude.

Cursor / Continue / etc.

Same shape — point the client at:

command: uvx

args: ["tcg-mcp"] env: PSA_API_TOKEN=... # optional

Smoke-test it

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?"

Architecture, briefly

+----------------------+

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.

Local SQLite database

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).

Known limits

PSA images only exist for cards graded after October 2021. Older slabs return an empty image list — that's the upstream API, not a bug.
PSA's `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.
CGC / BGS providers are stubs in v0.2. They're listed for discovery but raise NotSupportedError if called. Implementation depends on either grader publishing a public API or an explicit decision to support polite scraping.
Rate limits on the PSA free tier aren't publicly documented. If you see "PSA API rate limit exceeded", wait or upgrade your plan.
PriceCharting is paid-only. Without a 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.

Roadmap

Standing constraint: every milestone below has a free path as the

default. Paid providers (GemRate, eBay Marketplace Insights, etc.) stay

optional add-ons that activate only when their key is configured.

✅ v0.3 — shipped: tcg_pricing_snapshot_collection, tcg_pricing_get_history, rounded per-item valuation, clearer PSA 429 error message, CHANGELOG.md.
✅ v0.4 — shipped: Catalog tools (tcg_catalog_*) backed by Pokemon TCG API, tcg_collection_set_completion with watchlist intersection, richer tcg_collection_search, smart-routed tcg_pricing_get_card.
v0.5 — CGC support (free path: polite scraping; optional paid GemRate).
v0.6 — BGS support (free path: polite scraping; optional paid GemRate).
v0.7 — eBay sold comps (free path: eBay Browse API + scraping; optional paid Marketplace Insights API).

See CHANGELOG.md for the full version history.

Contributing

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 .

Disclaimers

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.

License

MIT — see LICENSE.

Sources / further reading

Model Context Protocol — official site
MCP Registry — discovery
Pokemon TCG API — pricing + catalog
PSA Public API
PriceCharting API

TCG MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni

Häufige Fragen

Alternativen

ThinkerNotes

Tandoor Recipe MCP

Slotlock

README vom Entwickler

tcg-mcp

What it does — 25 tools, namespaced

Prerequisites

Install

Option A — uvx (recommended, zero install)

run the server (auto-installs the package on first use)

Option B — pipx

Option C — pip

Option D — from source (for contributors)

Configure

Wire it into your MCP client

Claude Desktop

Claude Code

Cursor / Continue / etc.

Smoke-test it

Architecture, briefly

Local SQLite database

Known limits

Roadmap

Contributing

Disclaimers

License

Sources / further reading

Option A — `uvx` (recommended, zero install)

Option B — `pipx`

Option C — `pip`