How do I use tcgplayer-api-mcp?

1. Click on "Install 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 Related Servers Score Discussions

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: Sports Trading Card Agent

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 installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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
Sports Trading Card Agent
Sports Finance Research & Data
rjexile
A
license
A
quality
D
maintenance
Real-time sports card pricing, market analysis, arbitrage detection, grading ROI, investment advice, and player stats (NBA/NFL/MLB). 9 tools for AI agents helping collectors and investors.
Updated 5 months ago (2026-03-24 22:25 UTC)
9
2
MIT
Scryfall MCP Server
Games & Gamification Search
JoeMoCode
A
license
A
quality
C
maintenance
Enables Claude to search and retrieve Magic: The Gathering card details, prices, set information, and random cards from Scryfall's database through natural language.
Updated 10 months ago (2025-10-16 22:09 UTC)
4
1
MIT
mcp-ygoprodeck
Games & Gamification Search
pipeworx-io
A
license
-
quality
C
maintenance
Enables querying Yu-Gi-Oh! TCG card data, such as card information, sets, and prices, through natural language.
Updated 7 days ago (2026-08-04 07:31 UTC)
10
MIT

View all related MCP servers

Related MCP Connectors

Scryfall
Scryfall MCP — Magic: The Gathering card database.
Tcgdex
TCGdex MCP — multi-language open trading card game database (Pokémon TCG and more).
Sugra API
Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/deansasek/tcgplayer-api'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

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

Looking for Admin?

Related MCP Servers

Scryfall MCP Server

Sports Trading Card Agent

Scryfall MCP Server

mcp-ygoprodeck

Related MCP Connectors

Latest Blog Posts

MCP directory API