How do I use tcgplayer-api-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tcgplayer-api-mcp Show me the price history for Morpeko ex over the last quarter." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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: mcp-ygoprodeck

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.

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

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

tcgmcp A
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
Pokemon TCG Pocket Catalog A
app.hologallery.pocket
Look up Pokemon TCG Pocket cards, sets, packs, and evaluate decks with battle simulations.
Games & Gamification Search
111
cardmind-mcpOAuth
io.github.nath-abhishek
MTG market data: search 114K+ cards, price signals, AI analysis. Free tier available.
Games & Gamification Search AI & Machine Learning
2
tickermint A
io.github.seankarltonlee
Trading card prices: daily TCGplayer market, history since 2024, sold comps, PSA 10 floors. 6 games.
Finance Games & Gamification E-commerce & Retail
111

Related MCP Servers

Scryfall MCP Server
Search Games & Gamification Developer Tools
latte-chan
A
license
B
quality
D
maintenance
Enables AI assistants to search and retrieve Magic: The Gathering card data through the Scryfall API. Supports card searches, random card generation, autocomplete, set listings, and rulings lookup.
Updated a year ago (2025-09-18 01:13 UTC)
22
1
MIT
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 a day ago (2026-09-19 00:02 UTC)
2 npm
MIT
satorntcg-mcp-serverofficial
E-commerce & Retail Finance
satorntcg
A
license
Not graded
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 13 hours ago (2026-09-19 14:25 UTC)
MIT
mystic-tutor-mcp
Games & Gamification Search
Abbabon
F
license
A
quality
D
maintenance
Provides AI assistants with real-time access to Magic: The Gathering card data, prices, rulings, search, and synergy discovery via the Scryfall API.
Updated 12 days ago (2026-09-08 13:58 UTC)
5
-

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

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Scryfall MCP Server

mcp-ygoprodeck

satorntcg-mcp-serverofficial

mystic-tutor-mcp