← Developer Portal

Use IWMM from Claude (MCP Server)

The Model Context Protocol (MCP) lets AI assistants like Claude Desktop, Claude Code, and Cursor call out to external tools. The iwantmymtg-mcp server exposes the IWMM API as a set of tools, so you can search cards, look up prices, and manage your collection conversationally.

What you can do

  • Without a key: search cards, look up a card by set and number, fetch current prices and 30-day history, browse sets and sealed products.
  • With your IWMM API key: read and update your inventory, log transactions, query portfolio breakdowns, and manage price alerts and notifications.

1. Create an API key (optional)

Read-only tools work without authentication. To let Claude manage your inventory or portfolio, generate a key at /user/api-keys and copy it - the raw value is only shown once. Free tier limits apply (100 requests/day); see API pricing for higher tiers.

2. Configure your MCP client

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json): 

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": {
        "IWMM_API_KEY": "iwm_live_..."
      }
    }
  }
}

Restart Claude Desktop after saving. The IWMM_API_KEY line is optional - leave it out if you only need read-only tools.

Claude Code

Add the same block to .mcp.json in your project (or ~/.claude/.mcp.json globally): 

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": { "IWMM_API_KEY": "iwm_live_..." }
    }
  }
}

3. Try it out

Ask Claude something like:

  • "Search for Lightning Bolt printings and show me the cheapest one."
  • "What's the price history of Bloodbraid Elf from Modern Horizons 3?"
  • "Add 4 copies of Lightning Bolt from LEA to my inventory."
  • "Break down my collection value by set."
  • "What sealed products are available for MH3?"

Inventory and transaction tools make real changes - there is no dry-run mode in v1. Claude will confirm before writes, but treat it like running a CLI: review what it proposes before approving.

Configuration

  • IWMM_API_KEY - your personal API key. Required for authenticated tools only.
  • IWMM_BASE_URL - defaults to https://iwantmymtg.net. Override for self-hosted or local-dev instances.

Source & feedback

The server is open source at github.com/matthewdtowles/iwantmymtg-mcp. File issues there for bugs and feature requests, or email us for anything account-related.