{
  "markdown": "# iwantmymtg-mcp\n\n[![npm version](https://img.shields.io/npm/v/iwantmymtg-mcp)](https://www.npmjs.com/package/iwantmymtg-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![smithery badge](https://smithery.ai/badge/matthewdtowles/iwantmymtg-mcp)](https://smithery.ai/servers/matthewdtowles/iwantmymtg-mcp)\n\nAn [MCP](https://modelcontextprotocol.io) server for [I Want My MTG](https://iwantmymtg.net). Exposes IWMM's API as tools so Claude Desktop, Claude Code, Cursor, and other MCP clients can search Magic: The Gathering cards/sets and manage a user's collection conversationally.\n\n> Published on [npm](https://www.npmjs.com/package/iwantmymtg-mcp), the [MCP Registry](https://github.com/modelcontextprotocol/registry), and [Smithery](https://smithery.ai/servers/matthewdtowles/iwantmymtg-mcp). Coverage expands to match the API; see [`docs/TOOLS.md`](docs/TOOLS.md) for the full, always-current tool list.\n\n![Demo: Claude Code answering four collection queries via the iwmm MCP server](assets/four-queries-demo.gif)\n\n## What you can do\n\n- **Anonymous (no key):** search cards, look up a card by set+number, get current prices and 30-day price history, get a card's buylist (sell-to-vendor) offers, list sets and their cards, list sealed products.\n- **Authenticated (with an IWMM API key):** manage your inventory and transactions; build and manage decks (create, import from a decklist, edit cards, add the cards you're missing to your buy-list); view portfolio summaries, history, performance, cash flow, realized gains, and breakdowns (including by color, with per-slice drill-down); manage price alerts and notifications.\n- **Sell tools (with a key):** see your collection's market sell value (best buylist offer per card, grouped by vendor), manage a buy-list (want-list), and get a cash-vs-store-credit recommendation for selling toward your buy list.\n\nSee the [project roadmap](https://github.com/matthewdtowles/i-want-my-mtg/blob/main/ROADMAP.md#43-mcp-server--agentic-ai-integration) for what's next.\n\n## Install\n\nRequires Node 20+.\n\n```bash\nnpx iwantmymtg-mcp\n```\n\nOr install globally if you prefer:\n\n```bash\nnpm install -g iwantmymtg-mcp\niwantmymtg-mcp\n```\n\n## Claude Desktop\n\nAdd to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`; Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"iwmm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"iwantmymtg-mcp\"],\n      \"env\": {\n        \"IWMM_API_KEY\": \"iwm_live_...\"\n      }\n    }\n  }\n}\n```\n\n`IWMM_API_KEY` is optional - read-only tools work without it. Create a key at https://iwantmymtg.net/user/api-keys.\n\n## Claude Code\n\nAdd to `.mcp.json` in your project (or `~/.claude/.mcp.json` globally):\n\n```json\n{\n  \"mcpServers\": {\n    \"iwmm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"iwantmymtg-mcp\"],\n      \"env\": { \"IWMM_API_KEY\": \"iwm_live_...\" }\n    }\n  }\n}\n```\n\n## Cursor\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"iwmm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"iwantmymtg-mcp\"],\n      \"env\": { \"IWMM_API_KEY\": \"iwm_live_...\" }\n    }\n  }\n}\n```\n\nAfter saving, restart Cursor and confirm `iwmm` appears under **Settings -> Features -> MCP Servers**.\n\n## Example prompts\n\n- \"Search for Lightning Bolt printings and show me the cheapest one.\"\n- \"What's the price history of Bloodbraid Elf from Modern Horizons 3?\"\n- \"Add 4 copies of Lightning Bolt LEA to my inventory.\"\n- \"What sealed products are available for MH3?\"\n- \"What's my collection worth to sell right now, and which vendor pays most?\"\n- \"Add these cards to my buy list, then tell me whether cash or store credit is the better deal.\"\n\nSee [`examples/`](https://github.com/matthewdtowles/iwantmymtg-mcp/tree/main/examples) for walkthroughs of common flows, and [`docs/TOOLS.md`](docs/TOOLS.md) for the full tool reference.\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `IWMM_API_KEY` | _(unset)_ | Personal API key. Required only for authenticated tools. |\n| `IWMM_BASE_URL` | `https://iwantmymtg.net` | Override for self-hosted or local-dev IWMM instances. |\n\n## Local development\n\n```bash\nnpm install\nnpm run build\nnode dist/index.js\n```\n\nOr with `tsx` for live reload:\n\n```bash\nnpm install\nnpx tsx src/index.ts\n```\n\n## License\n\nThis project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 4472,
  "sha": "5343fc17acdc16158e169bb5f95cb99bfd98482d28d6e566fd609a9e02919aee",
  "repo_slug": "matthewdtowles/iwantmymtg-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matthewdtowles_iwantmymtg_mcp_5bb266c5/readme"
}