How do I use tcgplayer-api-mcp?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

tcgplayer-api-mcp

by deansasek

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

TCGplayer API

An SDK and REST API wrapper for TCGplayer providing structured access to trading card data including Pokemon, Magic: The Gathering, and other TCGs — with an MCP server for Claude Code integration.

Disclaimer: This SDK, REST API wrapper, and MCP server is an unofficial tool created for educational purposes only. It is not affiliated with, maintained, or endorsed by TCGplayer. Use of these tools may violate TCGplayer's terms of service.

Installation

npm install @deansasek/tcgplayer-api

Related MCP server: satorntcg-mcp-server

SDK

The SDK provides a typed, class-based interface organized by resource.

import { TCGplayerClient } from '@deansasek/tcgplayer-api/sdk';

const client = new TCGplayerClient();

// Search
const results = await client.search.autocomplete('morpeko');

// Product details
const product = await client.products.details(704874);

// Price history
const history = await client.products.priceHistory(704874, { range: 'quarter' });

SDK Resources

Resource	Methods
`client.products`	`details()`, `listings()`, `sales()`, `priceHistory()`, `volatility()`, `buylistPrice()`, `infinite()`, `recommendations()`
`client.search`	`autocomplete()`, `fullSearch()`, `bestsellers()`, `trending()`
`client.pricing`	`skuMarketPrices()`
`client.catalog`	`productLines()`, `categoryFilters()`, `latestSets()`, `setName()`, `catalogGroups()`, `verticals()`, `countryCodes()`
`client.content`	`articles()`, `trendingArticles()`, `tags()`, `kickbacks()`, `normalizeCardName()`

SDK Example: Card Analysis

import { TCGplayerClient } from '@deansasek/tcgplayer-api/sdk';

const client = new TCGplayerClient();

async function analyzeCard(productId: number) {
  const [details, sales, history] = await Promise.all([
    client.products.details(productId),
    client.products.sales(productId),
    client.products.priceHistory(productId, { range: 'month' }),
  ]);

  console.log(`${details.productName} (${details.setName})`);
  console.log(`Market Price: $${details.marketPrice}`);
  console.log(`Sellers: ${details.sellers}`);

  if (sales.data.length > 0) {
    const last = sales.data[0];
    console.log(`Last Sale: $${last.purchasePrice} (${last.condition})`);
  }

  return { details, sales, history };
}

analyzeCard(704874); // Morpeko ex

REST API (Backward Compatible)

Flat function exports for direct API access.

import { autocomplete, getProduct } from '@deansasek/tcgplayer-api';

autocomplete(query, options?)

Search for products by name.

const results = await autocomplete('charizard', { productLine: 'Pokemon' });

search(options?)

Full search with filters, sorting, and pagination.

const results = await search({
  q: 'charizard',
  productLine: 'Pokemon',
  from: 0,
  size: 24,
});

getProduct(productId)

Convenience function combining details, sales, and price history.

const product = await getProduct(704874);
// Returns: { details, sales, priceHistory }

Other Functions

Function	Description
`getProductDetails(id)`	Full product information
`getLatestSales(id, options?)`	Recent sales with filters
`getPriceHistory(id, options?)`	Historical pricing (`range: week\|month\|quarter\|year`)
`getVolatility(skuId)`	Market volatility for a SKU
`getBuylistPrice(id)`	Buylist/market prices
`getSkuMarketPrices(skuIds)`	Bulk SKU pricing
`getProductListings(id, options?)`	Detailed seller listings
`getProductLines()`	All available product lines
`getCategoryFilters(categoryId?)`	Filter options for a category
`getLatestSets(productLineIds?)`	Latest sets
`getSetName(setId)`	Set information
`getFacetedRecommendations(productIds, options?)`	Related products
`getKickbacks()`	Active promotions
`getTags()`	Product attribute tags
`getVerticals()`	Game verticals
`getBestsellers(options?)`	Best-selling products
`getTrending(options?)`	Trending suggestions
`getCatalogGroups()`	TCG vs Tabletop categories
`getFreeShippingThreshold()`	Free shipping minimum
`getCountryCodes()`	Shipping country list
`getArticles(options?)`	Articles by vertical
`getTrendingArticles(options?)`	Trending articles
`getInfiniteProduct(id)`	Simplified product data
`normalizeCardName(name)`	Normalize card name

Condition Values

Value	Condition
1	Unopened
2	Damaged
3	Heavily Played
4	Moderately Played
5	Lightly Played
6	Near Mint
7	Mint

MCP Server (Claude Code Integration)

The MCP server enables Claude Code to interact with TCGplayer data directly.

Installation

Claude Code automatically detects .mcp.json:

{
  "mcpServers": {
    "tcgplayer-api-mcp": {
      "command": "node",
      "args": ["dist/mcp/server.js"],
      "cwd": "/Users/deansasek/Documents/Projects/tcgplayer"
    }
  }
}

Available MCP Tools

Tool	Description
`tcgplayer_autocomplete`	Search for products by name
`tcgplayer_search`	Search with filters and pagination
`tcgplayer_product`	Full product data (details, sales, price history)
`tcgplayer_product_details`	Detailed product information
`tcgplayer_latest_sales`	Recent sales data
`tcgplayer_price_history`	Historical pricing data
`tcgplayer_volatility`	Market volatility for a SKU
`tcgplayer_buylist_price`	Buylist/market prices
`tcgplayer_category_filters`	Filter options (conditions, languages, variants)
`tcgplayer_product_lines`	All available product lines
`tcgplayer_latest_sets`	Latest sets for product lines
`tcgplayer_product_listings`	Detailed seller listings
`tcgplayer_set_name`	Set information by set ID
`tcgplayer_recommendations`	Faceted product recommendations
`tcgplayer_kickbacks`	Active kickback promotions
`tcgplayer_tags`	Product attribute tags
`tcgplayer_verticals`	Available game verticals
`tcgplayer_bestsellers`	Best-selling products
`tcgplayer_trending`	Trending product suggestions
`tcgplayer_catalog_groups`	Catalog groups (TCG vs Tabletop)
`tcgplayer_free_shipping_threshold`	Free shipping minimum
`tcgplayer_country_codes`	Shipping country codes
`tcgplayer_articles`	Articles for a vertical
`tcgplayer_trending_articles`	Trending articles
`tcgplayer_infinite_product`	Simplified product data
`tcgplayer_normalize_card_name`	Normalize card name
`tcgplayer_render_card`	Render a card as ASCII art

MCP Usage Examples

User: Search for Morpeko cards
Claude uses: tcgplayer_search with q="morpeko"

User: Get latest sales for product 704874
Claude uses: tcgplayer_latest_sales with productId=704874

User: What conditions are available for Pokemon?
Claude uses: tcgplayer_category_filters with categoryId="3"

User: Show me Charizard as ASCII art
Claude uses: tcgplayer_render_card with productId=546343

Development

npm run build    # Compile TypeScript
npm run clean   # Remove dist folder
npm run dev     # Run server.ts directly
npm run mcp     # Run MCP server directly

Environment

Node.js 18+ recommended (uses native fetch)
TypeScript with strict mode
ES Modules (type: "module")

License

This project is dedicated to the public domain under the Unlicense.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

tcgmcpA
com.tcgmcp
Live TCG card and decklist prices for AI assistants. 22+ games, no account, ready-to-buy links.
E-commerce & Retail Finance Games & Gamification
42
https://mcp.tcgmcp.com/mcp
PokéWallet
io.pokewallet
Card prices and data for Pokémon, One Piece and 10 more TCGs, from TCGplayer and Cardmarket.
E-commerce & Retail Games & Gamification
11
https://mcp.pokewallet.io/mcp
Pokemon TCG Pocket CatalogA
app.hologallery.pocket
Look up Pokemon TCG Pocket cards, sets, packs, and evaluate decks with battle simulations.
Games & Gamification Search
111
https://pocket.hologallery.app/mcp
cardmind-mcp
io.github.nath-abhishek
MTG market data: search 114K+ cards, price signals, AI analysis. Free tier available.
Games & Gamification Search AI & Machine Learning
2
https://api.cardmind.app/mcp

Related MCP Servers

mcp-ygoprodeck
Games & Gamification Search
pipeworx-io
A
license
Not graded
quality
C
maintenance
Enables querying Yu-Gi-Oh! TCG card data, such as card information, sets, and prices, through natural language.
Updated 6 days ago (2026-11-06 20:58 UTC)
276 npm
1
MIT
satorntcg-mcp-serverofficial
E-commerce & Retail Finance
satorntcg
A
license
A
quality
B
maintenance
Enables LLM clients to query live TCG inventory, pricing, alerts, profit and loss, and eBay listings directly through natural language tool calls.
Updated 10 days ago (2026-11-02 16:26 UTC)
11
MIT
Midpoint MCP server
Finance E-commerce & Retail Search
kolourr
F
license
Not graded
quality
B
maintenance
Enables 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.
Updated a month ago (2026-10-13 16:43 UTC)
-
@pokemontcgapi/mcpofficial
Games & Gamification Entertainment & Media
pokemontcgapi
A
license
A
quality
B
maintenance
Enables agents to search and query Pokémon TCG cards and sets, retrieve priced card data with provenance, and identify cards from images through eight read-only tools.
Updated 14 days ago (2026-10-30 14:02 UTC)
8
150 npm
MIT

TCGplayer API

Installation

SDK

SDK Resources

SDK Example: Card Analysis

REST API (Backward Compatible)

autocomplete(query, options?)

search(options?)

getProduct(productId)

Other Functions

Condition Values

MCP Server (Claude Code Integration)

Installation

Available MCP Tools

MCP Usage Examples

Development

Environment

License

Tool Schema Changelog

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-ygoprodeck

satorntcg-mcp-serverofficial

Midpoint MCP server

@pokemontcgapi/mcpofficial