MCP server
Give your AI agentlive card prices.
Connect Claude Code, Cursor, VS Code or Claude Desktop to TcgPriceApi through the Model Context Protocol. Your agent can search cards, read prices for every condition and pull sold history while it writes your code.
you Find the five most valuable cards in the newest Pokémon set and show their Near Mint prices. agent list_sets(game: "Pokemon") most_valuable_cards(game: "Pokemon", set: "...", limit: 5) get_card_prices(card_ids: [...], condition: "Near Mint") agent Here are the five cards, with their market price and the cheapest live listing for each.
Same API key
The MCP server uses the key from your dashboard. There is nothing new to sign up for.
No extra cost
Each tool call counts as one request on your plan, the same as the REST endpoint it uses.
Read only
Every tool only reads prices. Nothing an agent does can change your account or your data.
Run this in your terminal. Add --scope user to use it in every project.
claude mcp add --transport http tcgpriceapi https://tcgpriceapi.com/mcp \ --header "X-API-Key: YOUR_API_KEY"
Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.
{
"mcpServers": {
"tcgpriceapi": {
"url": "https://tcgpriceapi.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}Add this to .vscode/mcp.json in your project.
{
"servers": {
"tcgpriceapi": {
"type": "http",
"url": "https://tcgpriceapi.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}Add this to claude_desktop_config.json. It uses the mcp-remote bridge, so Node.js must be installed.
{
"mcpServers": {
"tcgpriceapi": {
"command": "npx",
"args": ["mcp-remote", "https://tcgpriceapi.com/mcp",
"--header", "X-API-Key:YOUR_API_KEY"]
}
}
}Any client that supports Streamable HTTP can connect. Send your key in the X-API-Key header, or as a Bearer token.
URL: https://tcgpriceapi.com/mcp Header: X-API-Key: YOUR_API_KEY Method: POST, JSON-RPC 2.0
Tools
What your agent can call
| Tool | What it does |
|---|---|
list_sets | Lists every game and set, or the sets of one game. Use the exact names it returns in search_cards. |
search_cards | Finds cards by part of their name, set or game. Returns card_id, name, set, number, rarity, game and image, without prices. Pass the card_id values to get_card_prices. |
get_card_prices | Current prices for one or more cards, per SKU (printing, condition and language): market price, cheapest and highest listings with shipping, recent sold low and high, and how many copies and sellers are listed. |
get_price_history | Daily or weekly sold history for one card: market price, low and high sale prices, and quantity sold per date. |
most_valuable_cards | The cards with the highest Near Mint market price in a game, or in one set of it. |
get_usage | The plan's limits and how many requests have been used today and this month. Free: it does not count. |
Try asking
Example prompts
- Price this deck list in Near Mint and tell me the total.
- Which One Piece cards in OP-18 have the biggest gap between the cheapest listing and recent sales?
- Chart Charizard's Near Mint market price over the last 30 days.
- Write a script that reprices my store's inventory CSV with current market prices.
Troubleshooting
If it doesn't connect
The agent says my key is missing
Check the header is spelled X-API-Key and that the key has no spaces around it.
The tools don't show up
Restart the agent after adding the server. In Claude Code, run claude mcp list to see its status.
I hit my limit
Agents can make many calls. Ask for many cards in one get_card_prices call, or move to a bigger plan.
Get started