Back to search
C
61.4 /100

TCG MCP

Author seanlok
Scanned 1d ago

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

Versions

0.2.1scored
first seen Jun 5, 2026

Trust breakdown

PermissionsTool SafetyAuthAnnotationsCode QualityStabilitySpecVuln HistoryAuthorTransparencyCommunity

Tools 33

tcg_psa_get_cert
annotations: none low

Look up a single graded card by its PSA cert number. Returns card metadata (year, brand, set, card number, subject, variety), grade (label + numeric), and population data (count at this grade, count graded higher) when PSA exposes them.

params PSAGetCertInput
tcg_psa_get_images
annotations: none low

Fetch front/back image URLs for a PSA graded card. NOTE: PSA only attaches images to cards graded after October 2021 — older slabs return an empty list with no error.

params PSAGetImagesInput
tcg_psa_add_to_collection
annotations: none low

Look up a PSA cert AND record it in your local collection in one step. Workflow tool — combines `tcg_psa_get_cert` with `tcg_collection_add_card`. Looks up the cert at PSA, normalizes the response, and writes a row into the local SQLite DB with your cost basis. Returns the new card_id. If you've already added this exact cert, returns an error rather than duplicating — use `tcg_collection_update` to change cost basis.

params PSAAddToCollectionInput
tcg_cgc_get_cert
annotations: none low

CGC cert lookup — stubbed. CGC has no official public API. Returns a clear "not supported" error. Implementation deferred.

params CGCGetCertInput
tcg_bgs_get_cert
annotations: none low

BGS cert lookup — stubbed. Beckett has no official public API. Returns a clear "not supported" error. Implementation deferred.

params BGSGetCertInput
tcg_collection_add_card
annotations: none low

Record a card as owned in the local SQLite DB. Returns the new card_id (a UUID) on success.

params CollectionAddCardInput
tcg_collection_list
annotations: none low

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

params CollectionListInput
tcg_collection_get
annotations: none low

Fetch a single owned card by its card_id.

params CollectionGetInput
tcg_collection_update
annotations: none low

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

params CollectionUpdateInput
tcg_collection_remove
annotations: none low

Remove a card. Default is a soft-delete: status -> 'sold' and the row stays. Pair with sold_price + sold_date to capture the disposition.

params CollectionRemoveInput
tcg_collection_value
annotations: none low

Cost-basis summary across the collection. Returns counts (owned / graded / raw / sold) and total cost basis. For live market valuation that joins against pricing snapshots, see `tcg_collection_value_with_market`.

params CollectionValueInput
tcg_collection_add_sealed
annotations: none low

Record sealed product as owned. Behind the scenes, sealed product lives in the same `owned_cards` table as singles, distinguished by `product_type != 'single'`. We insert one row per quantity unit so cost basis and disposition track per-unit. Returns a list of new card_ids (one per unit).

params CollectionAddSealedInput
tcg_collection_attach_pricing
annotations: none low

Map an owned card to a pricing listing for live valuation. After attaching, `tcg_pricing_snapshot` calls (using the same listing_id) will let `tcg_collection_value_with_market` compute live market value for this card.

params CollectionAttachPricingInput
tcg_collection_value_with_market
annotations: none low

Cost basis + live market value across the collection. For each owned card with an attached pricing listing, we look up the most recent pricing snapshot (matching the card's grade for graded cards). Cards without an attachment or without a snapshot land in `unpriced_count` so you know what's missing. Run `tcg_pricing_snapshot` periodically to keep the join fresh.

params CollectionValueWithMarketInput
tcg_watchlist_add
annotations: none low

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

params WatchlistAddInput
tcg_watchlist_list
annotations: none low

List watchlist entries with optional horizon filter.

params WatchlistListInput
tcg_watchlist_get
annotations: none low

Fetch a single watchlist entry by id.

params WatchlistGetInput
tcg_watchlist_update
annotations: none low

Update mutable fields on a watchlist entry.

params WatchlistUpdateInput
tcg_watchlist_close
annotations: none low

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

params WatchlistCloseInput
tcg_psa_snapshot_pop
annotations: none low

Capture today's PSA pop data for the spec backing this cert. Looks up the cert via PSA, extracts (SpecID, grade, total_at_grade, population_higher), and inserts a row into pop_snapshots. Repeat over time and `tcg_psa_pop_trend` will surface the trajectory.

params PSASnapshotPopInput
tcg_psa_pop_trend
annotations: none low

Return the time series of pop snapshots we've captured for a card spec. Useful for answering "Has PSA 10 pop for this card grown a lot?" — but only works for specs you've snapshotted via `tcg_psa_snapshot_pop`.

params PSAPopTrendInput
tcg_pricing_search
annotations: none low

Search a pricing provider for matching products. Returns a list of CardListing rows. Use `tcg_pricing_get` afterward with one of the `listing_id`s to fetch full price data.

params PricingSearchInput
tcg_pricing_get
annotations: none low

Fetch the full PriceQuote for one listing on the chosen provider. Returns top-level market/low/high (USD or EUR depending on provider), a `variants` map (Pokemon TCG API), and a `graded_levels` list (PriceCharting). The full provider payload lives in `raw`.

params PricingGetInput
tcg_pricing_snapshot
annotations: none low

Fetch a price quote and write it as a row in the pricing_snapshots table. For graded providers (PriceCharting), every graded_level becomes its own snapshot row (so you can later track PSA 10 vs PSA 9 separately). The raw provider payload is stored on the FIRST row only to avoid bloat.

params PricingSnapshotInput
tcg_pricing_snapshot_collection
annotations: none low

Walk the collection and snapshot every owned card with an attached pricing listing, respecting per-provider rate limits. Skips cards whose most recent snapshot is younger than `max_age_hours` so repeated calls don't burn API quota redundantly. One card failing does not abort the rest — failures are reported per-card. Returns a summary with counts (snapshotted / skipped_recent / failed) and a per-provider breakdown.

params PricingSnapshotCollectionInput
tcg_pricing_get_history
annotations: none low

Return the time series of pricing snapshots saved for one listing. Useful for answering "is PSA 10 trending up?" or "what was Charizard ex SIR worth a month ago?" — but only works for listings you've snapshotted via `tcg_pricing_snapshot` or `tcg_pricing_snapshot_collection`. Returned snapshots are oldest-first.

params PricingHistoryInput
tcg_catalog_get_set
annotations: none low

Fetch a Pokemon TCG set's metadata (name, total cards, release date, …). Free — no API key required (Pokemon TCG API).

params CatalogGetSetInput
tcg_catalog_search_set
annotations: none low

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

params CatalogSearchSetInput
tcg_catalog_list_cards_in_set
annotations: none low

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.

params CatalogListCardsInSetInput
tcg_collection_set_completion
annotations: none low

Compute set-completion progress for a Pokemon TCG set. For each card in the set (optionally filtered by rarity): * Owned? Match owned_cards either by attached `pricing_listing_id` equal to the catalog card's `id` (precise), or as a fallback by case-insensitive subject match + card_number exact match. * Watchlist hit? Cross-reference `watchlist.card_descriptor` for substring matches against the card name + set name. * Missing? Sum current Pokemon TCG API market price for the gap. Returns owned/missing counts, completion percentage, gap cost in USD, and per-card breakdown.

params CollectionSetCompletionInput
tcg_collection_search
annotations: none low

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

params CollectionSearchInput
tcg_pricing_get_card
annotations: none low

Smart-routed price lookup. One call, the right provider(s) under the hood. Strategy: * Always queries Pokemon TCG API (free) — gives raw/ungraded market. * If `grade` is provided AND PriceCharting is enabled (token set), ALSO queries PriceCharting for the graded price level. * `prefer_provider` overrides routing entirely. Designed so an agent can ask "what's Charizard ex Surging Sparks worth" without knowing which provider to call first.

params PricingGetCardInput
tcg_list_providers
annotations: none low

Show which grading / pricing providers are enabled in this process. Useful as a first call when introspecting the server's capabilities.

params ListProvidersInput

Permissions 3

network Server uses network capabilities via: httpx
medium
filesystem Server uses filesystem capabilities via: os, pathlib
low
database Server uses database capabilities via: sqlite3
medium

Scan Findings 85

low
Tool 'tcg_psa_get_cert' has no annotations annotation_checker · 100%
low
Tool 'tcg_psa_get_images' has no annotations annotation_checker · 100%
low
Tool 'tcg_psa_add_to_collection' has no annotations annotation_checker · 100%
low
Tool 'tcg_cgc_get_cert' has no annotations annotation_checker · 100%
low
Tool 'tcg_bgs_get_cert' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_add_card' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_list' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_get' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_update' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_remove' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_value' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_add_sealed' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_attach_pricing' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_value_with_market' has no annotations annotation_checker · 100%
low
Tool 'tcg_watchlist_add' has no annotations annotation_checker · 100%
low
Tool 'tcg_watchlist_list' has no annotations annotation_checker · 100%
low
Tool 'tcg_watchlist_get' has no annotations annotation_checker · 100%
low
Tool 'tcg_watchlist_update' has no annotations annotation_checker · 100%
low
Tool 'tcg_watchlist_close' has no annotations annotation_checker · 100%
low
Tool 'tcg_psa_snapshot_pop' has no annotations annotation_checker · 100%
low
Tool 'tcg_psa_pop_trend' has no annotations annotation_checker · 100%
low
Tool 'tcg_pricing_search' has no annotations annotation_checker · 100%
low
Tool 'tcg_pricing_get' has no annotations annotation_checker · 100%
low
Tool 'tcg_pricing_snapshot' has no annotations annotation_checker · 100%
low
Tool 'tcg_pricing_snapshot_collection' has no annotations annotation_checker · 100%
low
Tool 'tcg_pricing_get_history' has no annotations annotation_checker · 100%
low
Tool 'tcg_catalog_get_set' has no annotations annotation_checker · 100%
low
Tool 'tcg_catalog_search_set' has no annotations annotation_checker · 100%
low
Tool 'tcg_catalog_list_cards_in_set' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_set_completion' has no annotations annotation_checker · 100%
low
Tool 'tcg_collection_search' has no annotations annotation_checker · 100%
low
Tool 'tcg_pricing_get_card' has no annotations annotation_checker · 100%
low
Tool 'tcg_list_providers' has no annotations annotation_checker · 100%
info
Sandbox failed to start for behavioral verification behavioral_verifier · 100%
medium
Vulnerable dependency: mcp@1.2.0 (GHSA-3qhf-m339-9g5v) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (GHSA-9h52-p55h-vw2f) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (GHSA-j975-95f5-7wqh) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (GHSA-jpw9-pfvf-9f58) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (GHSA-vj7q-gjh5-988w) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (PYSEC-2026-1616) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (PYSEC-2026-1617) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (PYSEC-2026-1618) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (PYSEC-2026-3482) dependency_analyzer · 95%
medium
Vulnerable dependency: mcp@1.2.0 (PYSEC-2026-3483) dependency_analyzer · 95%
info
pyproject.toml metadata manifest_parser · 100%
info
Tool: tcg_psa_get_cert manifest_parser · 90%
info
Tool: tcg_psa_get_images manifest_parser · 90%
info
Tool: tcg_psa_add_to_collection manifest_parser · 90%
info
Tool: tcg_cgc_get_cert manifest_parser · 90%
info
Tool: tcg_bgs_get_cert manifest_parser · 90%
info
Tool: tcg_collection_add_card manifest_parser · 90%
info
Tool: tcg_collection_list manifest_parser · 90%
info
Tool: tcg_collection_get manifest_parser · 90%
info
Tool: tcg_collection_update manifest_parser · 90%
info
Tool: tcg_collection_remove manifest_parser · 90%
info
Tool: tcg_collection_value manifest_parser · 90%
info
Tool: tcg_collection_add_sealed manifest_parser · 90%
info
Tool: tcg_collection_attach_pricing manifest_parser · 90%
info
Tool: tcg_collection_value_with_market manifest_parser · 90%
info
Tool: tcg_watchlist_add manifest_parser · 90%
info
Tool: tcg_watchlist_list manifest_parser · 90%
info
Tool: tcg_watchlist_get manifest_parser · 90%
info
Tool: tcg_watchlist_update manifest_parser · 90%
info
Tool: tcg_watchlist_close manifest_parser · 90%
info
Tool: tcg_psa_snapshot_pop manifest_parser · 90%
info
Tool: tcg_psa_pop_trend manifest_parser · 90%
info
Tool: tcg_pricing_search manifest_parser · 90%
info
Tool: tcg_pricing_get manifest_parser · 90%
info
Tool: tcg_pricing_snapshot manifest_parser · 90%
info
Tool: tcg_pricing_snapshot_collection manifest_parser · 90%
info
Tool: tcg_pricing_get_history manifest_parser · 90%
info
Tool: tcg_catalog_get_set manifest_parser · 90%
info
Tool: tcg_catalog_search_set manifest_parser · 90%
info
Tool: tcg_catalog_list_cards_in_set manifest_parser · 90%
info
Tool: tcg_collection_set_completion manifest_parser · 90%
info
Tool: tcg_collection_search manifest_parser · 90%
info
Tool: tcg_pricing_get_card manifest_parser · 90%
info
Tool: tcg_list_providers manifest_parser · 90%
info
Sandbox failed to start for output poisoning scan output_poisoning · 100%
medium
Permission: network access detected permission_analyzer · 90%
low
Permission: filesystem access detected permission_analyzer · 70%
medium
Permission: database access detected permission_analyzer · 90%
critical
Tool poisoning in 'tcg_list_providers': Cross-tool prerequisite: 'first call/use' poisoning · 85%
info
No dependency files found for SBOM generation sbom_generator · 100%
medium
No build provenance detected (SLSA L0) slsa_assessor · 90%