MCP Server

Beta

Manage your CTCGX inventory by talking to Claude. The MCP (Model Context Protocol) server lets AI assistants like Claude Desktop and Claude Code interact directly with your store.

What is MCP?

MCP (Model Context Protocol) is Anthropic's standard for connecting AI assistants to external tools and data sources. With the CTCGX MCP server, you can:

  • Manage inventory by describing what you want in plain English
  • Query your orders and listings without writing code
  • Bulk update prices based on market conditions
  • Automate repetitive inventory tasks through conversation
Example Conversations
You

Show me my current Magic inventory

Claude

I'll check your inventory... You have 142 Magic: The Gathering cards listed across 47 unique products. Your highest value item is a Near Mint Black Lotus listed at $12,500.

You

Add 4 copies of every mythic from Foundations at $5 below market price

Claude

I'll get the Foundations set, find all mythic rares, and add them to your inventory. Done! Added 15 mythic rares (4 copies each, 60 total cards) with prices set to $5 below current market rates.

You

What orders came in today that need shipping?

Claude

You have 3 orders awaiting shipment today: Order #1234 (2 cards, $45.00), Order #1235 (1 card, $299.99), and Order #1236 (5 cards, $23.50). Total value: $368.49.

You

Set all my Lightly Played cards to 15% off Near Mint price

Claude

I'll update all LP listings... Updated 89 Lightly Played listings. Each is now priced at 85% of your NM price for the same card.

Available Tools

The MCP server exposes these tools to Claude:

lookup_product

Find a product by external ID (TCGPlayer, Scryfall, etc.)

list_sets

List all sets, optionally filtered by game

list_products

List products by set, game, or search query

get_inventory

Get your current inventory listings

sync_inventory

Add or replace inventory items

update_inventory

Update specific inventory items

get_orders

Get orders with optional status/date filters

get_order

Get details for a specific order

Setup Instructions

1. Install the MCP Server

The MCP server will be installed automatically when you configure Claude Desktop.

2. Configure Claude Desktop

Add this to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ctcgx": {
      "command": "npx",
      "args": ["@ctcgx/mcp-server"],
      "env": {
        "CTCGX_API_KEY": "ctcgx_sk_live_your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the config, restart Claude Desktop. You should see CTCGX tools available in your conversations.

Security Note

Your API key is stored locally on your machine in the MCP configuration. It is never sent to Anthropic's servers—the MCP server runs locally and makes direct API calls to CTCGX. However, you should still treat your API key as sensitive and never share your configuration file.

Troubleshooting

Claude doesn't see CTCGX tools

Make sure you've restarted Claude Desktop/Code after adding the configuration. Check that the JSON syntax is valid.

API errors when using tools

Verify your API key is correct and has the necessary permissions. Check that your store is active on CTCGX.

"Command not found" error

Make sure you have Node.js 20+ installed. Try running npx @ctcgx/mcp-server manually to see if it works.

API Playground

Select an endpoint from the documentation to try it out here.