iwantmymtg-mcp
This MCP server exposes the I Want My MTG API, letting you search Magic: The Gathering cards, sets, prices, and sealed products, and manage your collection, decks, transactions, buy-list, and price alerts conversationally.
Card & set catalog (no key): search cards with filters (name, set, rarity, type, format/legality), look up a printing by set+number, list all printings of a card, browse sets and set card lists.
Pricing (no key): current normal/foil prices, 30-day price history, set-level price history, and weekly biggest price movers up or down.
Buylist & selling (no key for card offers): get a card's vendor buylist offers; with a key, get market sell value of your collection by vendor and a cash-vs-store-credit recommendation.
Sealed products (no key): list a set's sealed products and get a product's detail and pricing.
Inventory (key): list, add, update, remove cards and sealed products, batch check quantities, bulk CSV import/export.
Buy-list (key): list, add, update, remove, and bulk import wanted cards.
Transactions & portfolio (key): record/update/delete buy/sell transactions, get cost basis, portfolio summary/history, card performance, cash flow, realized gains, and value breakdowns with drill-down.
Decks (key): create, import, rename, delete decks, add/set/remove cards, and push missing cards to your buy-list.
Alerts & notifications (key): manage price alerts and view/mark notifications read.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iwantmymtg-mcp Find Lightning Bolt printings and cheapest price"
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.
iwantmymtg-mcp
An MCP server for I Want My MTG. 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.
Published on npm, the MCP Registry, and Smithery. Coverage expands to match the API; see
docs/TOOLS.mdfor the full, always-current tool list.

What you can do
Anonymous (no key): search cards, look up a card by set+number, get current prices and 30-day price history, find the week's biggest price increases and decreases, get a card's buylist (sell-to-vendor) offers, list sets and their cards, list sealed products.
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.
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.
See the project roadmap for what's next.
Related MCP server: MTG Card Lookup MCP Server
Install
Requires Node 20+.
npx iwantmymtg-mcpOr install globally if you prefer:
npm install -g iwantmymtg-mcp
iwantmymtg-mcpClaude Desktop
Add to 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_..."
}
}
}
}IWMM_API_KEY is optional - read-only tools work without it. Create a key at https://iwantmymtg.net/user/api-keys.
Claude Code
Add 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_..." }
}
}
}Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:
{
"mcpServers": {
"iwmm": {
"command": "npx",
"args": ["-y", "iwantmymtg-mcp"],
"env": { "IWMM_API_KEY": "iwm_live_..." }
}
}
}After saving, restart Cursor and confirm iwmm appears under Settings -> Features -> MCP Servers.
Example prompts
"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 LEA to my inventory."
"What sealed products are available for MH3?"
"What's my collection worth to sell right now, and which vendor pays most?"
"Add these cards to my buy list, then tell me whether cash or store credit is the better deal."
See examples/ for walkthroughs of common flows, and docs/TOOLS.md for the full tool reference.
Configuration
Env var | Default | Purpose |
| (unset) | Personal API key. Required only for authenticated tools. |
|
| Override for self-hosted or local-dev IWMM instances. |
Local development
npm install
npm run build
node dist/index.jsOr with tsx for live reload:
npm install
npx tsx src/index.tsLicense
This project is licensed under the MIT License — see the LICENSE file for details.
Available Tools
61 toolsadd_buy_listA
Add a card to the authenticated user's buy-list, incrementing the quantity (creates the row if absent). This is a real write. Use update_buy_list to set an absolute quantity or remove_buy_list to delete a row. Requires IWMM_API_KEY.
Inputs: cardId (required), isFoil, quantity.
add_deck_cardA
Add a card to a deck, incrementing its quantity (creates the row if absent). Use set_deck_card_quantity to set an absolute quantity or remove_deck_card to delete a row. Requires IWMM_API_KEY.
Inputs: cardId (required), deckId (required), quantity, isSideboard.
add_inventoryA
Add one or more cards to the authenticated user's inventory. Accepts a batch - pass a single-item array for one card. This is a real write. Use update_inventory to change quantities, remove_inventory to delete a row. Requires IWMM_API_KEY.
Inputs: items (required).
create_deckA
Create a new empty deck. This is a real write. Use add_deck_card to fill it, or import_deck to create from pasted text instead. Requires IWMM_API_KEY.
Inputs: name (required), format.
create_price_alertA
Create a price alert for a card. Supply increasePct, decreasePct, or both (Premium). At least one threshold is required. Requires IWMM_API_KEY.
Inputs: cardId (required), decreasePct, increasePct.
deck_missing_to_buy_listA
Add the deck's missing cards (the shortfall vs. the user's inventory) to their buy-list. Returns the count of distinct cards added. This is a real write to the buy-list. Requires IWMM_API_KEY.
Inputs: deckId (required).
delete_deckADestructive
Delete a deck and all of its cards. This is permanent. Requires IWMM_API_KEY.
Inputs: deckId (required).
delete_price_alertBDestructive
Delete a price alert by ID. Requires IWMM_API_KEY.
Inputs: id (required).
delete_transactionADestructive
Delete a transaction by ID. Requires IWMM_API_KEY.
Inputs: id (required).
export_inventoryARead-only
Export the authenticated user's full card inventory as CSV (columns: id, name, set_code, number, quantity, foil). Reimport-compatible with import_inventory_cards. Requires IWMM_API_KEY.
Inputs: no named parameters.
get_cardARead-only
Look up a specific card printing by set code and collector number. Returns full card detail including current prices, rarity, type, and flavor name. For broader catalog search use search_cards.
Inputs: setCode (required), setNumber (required).
get_card_buylistARead-only
Get current buylist (sell-to-vendor) offers for a card printing, by set code and collector number. Returns offers grouped by finish (normal/foil/etched), best first, with the highest offer per finish marked. NM condition only. Use get_card_prices for retail (buy) prices instead.
Inputs: setCode (required), setNumber (required).
get_card_performanceARead-only
Get the user's best- or worst-performing cards by P&L. Default: best, top 10. Premium-gated. Requires IWMM_API_KEY.
Inputs: type, limit.
get_card_price_historyARead-only
Get the 30-day price history for a card printing (normal + foil). Older data is retained on a weekly/monthly cadence beyond 30 days.
Inputs: setCode (required), setNumber (required).
get_card_pricesARead-only
Get current normal and foil prices for a specific card printing.
Inputs: setCode (required), setNumber (required).
get_card_printingsARead-only
List every printing of the card at this set code and collector number, most valuable first. Use this to compare what the same card costs across sets, or to find a cheaper printing. Prefer it over search_cards for that: search_cards matches names by substring, so it also returns unrelated cards whose names merely contain the term. The addressed printing is included in the results.
Inputs: setCode (required), setNumber (required), page, limit.
get_cash_flowARead-only
Get the user's cash flow (money in vs money out from BUY/SELL transactions). Premium-gated. Requires IWMM_API_KEY.
Inputs: no named parameters.
get_cash_vs_creditARead-only
Cash vs. store-credit recommendation for the authenticated user. Compares taking the buylist cash payout for their inventory against taking store credit (worth a bonus %) and spending it on their buy list. Returns the recommendation, the credit advantage, out-of-pocket each way, and the priced buy-list lines. Requires IWMM_API_KEY.
Inputs: bonus.
get_cost_basisARead-only
Get FIFO cost basis for a specific card+finish for the authenticated user. Pass either cardId or (setCode, setNumber). Requires IWMM_API_KEY.
Inputs: cardId, isFoil, setCode, setNumber.
get_deckARead-only
Get one deck with its cards (mainboard + sideboard). Requires IWMM_API_KEY.
Inputs: deckId (required).
get_inventory_quantitiesARead-only
Batch lookup: given a list of card UUIDs, return how many of each (normal + foil) the user owns. Useful before recommending adds. Requires IWMM_API_KEY.
Inputs: cardIds (required).
get_market_sell_valueARead-only
Market sell value of the authenticated user's whole inventory: matches every owned card against current buylist offers, picks the best offer per item (capped by the vendor's buy quantity), groups by vendor, and totals it. Returns vendor groups with per-item payouts plus overall totals. Requires IWMM_API_KEY.
Inputs: no named parameters.
get_portfolio_breakdownARead-only
Get the user's collection value broken down by a dimension into slices (each with value, count, and share). Premium-gated. Use get_portfolio_breakdown_cards to drill into one slice. Requires IWMM_API_KEY.
Inputs: by (required), colors.
get_portfolio_breakdown_cardsARead-only
Get the cards inside one slice of a portfolio breakdown (the drill-down for get_portfolio_breakdown). Premium-gated. Requires IWMM_API_KEY.
Inputs: by (required), key (required), colors.
get_portfolio_historyARead-only
Get portfolio value history. Premium-gated - free tier receives 403. Requires IWMM_API_KEY.
Inputs: days.
get_portfolio_summaryARead-only
Get the authenticated user's portfolio summary - current value, total invested, unrealized P&L, ROI, card/unit counts. Free tier sees current value + total invested only; Premium gets the full P&L set. Requires IWMM_API_KEY.
Inputs: no named parameters.
get_price_moversARead-only
The week's biggest Magic: The Gathering price moves: the cards whose price rose (direction 'up', the default) or fell (direction 'down') the most over the last 7 days, one row per printing and finish, with today's price, the price a week ago, and the change in dollars and percent. Ranked by percent unless by is 'amount'. Cards worth less than minPrice (default $5) both before and after the move are left out, and so are prices that jumped back and forth during the week, which come from a missing vendor price rather than a real move. Narrow it with setCode, rarity, type, format legality or finish.
Inputs: by, page, type, limit, +7 more.
get_realized_gainsARead-only
Get the user's realized gains from SELL transactions using FIFO cost basis. Premium-gated. Requires IWMM_API_KEY.
Inputs: no named parameters.
get_sealed_productARead-only
Get detail for a single sealed product by its UUID, including current pricing and a TCGPlayer purchase URL. List a set's sealed products with get_sealed_products.
Inputs: uuid (required).
get_sealed_productsARead-only
List sealed products (booster boxes, bundles, commander decks, etc.) for a set. Each entry includes a TCGPlayer purchase URL.
Inputs: code (required).
get_setARead-only
Get detail for a single set by code (e.g. 'lea', 'mh3').
Inputs: code (required).
get_set_price_historyARead-only
Get the price history for a whole set by set code - the set's aggregate value over time. Optionally limit the window with days. For a single card's history use get_card_price_history.
Inputs: code (required), days.
get_unread_notification_countBRead-only
Get the count of unread notifications for the authenticated user. Requires IWMM_API_KEY.
Inputs: no named parameters.
import_buy_listA
Bulk-add cards to the authenticated user's buy-list from pasted CSV text. Native format header: name,set_code,number[,quantity][,foil]. External exports (Moxfield, Archidekt, Deckbox, TCGPlayer) are auto-detected. Returns counts and per-row errors. Requires IWMM_API_KEY.
Inputs: text (required).
import_deckA
Create a deck from pasted decklist text, one entry per line (e.g. "4 Lightning Bolt"). Returns the new deck id plus any lines that could not be resolved to a card. Requires IWMM_API_KEY.
Inputs: name (required), text (required), format.
import_inventory_cardsA
Bulk-import cards into the authenticated user's inventory from pasted CSV text. Native header: name,set_code,number[,quantity][,foil]; Moxfield, Archidekt, Deckbox, and TCGPlayer exports are auto-detected. Returns counts of saved/deleted/skipped rows and per-row errors. Requires IWMM_API_KEY.
Inputs: text (required).
list_buy_listARead-only
List the authenticated user's buy-list (want-list): the cards they want to acquire, with quantities, finish, and current prices. Requires IWMM_API_KEY.
Inputs: no named parameters.
list_decksARead-only
List the authenticated user's decks (summaries: id, name, format, card counts). Requires IWMM_API_KEY.
Inputs: no named parameters.
list_inventoryBRead-only
List the authenticated user's card inventory, paginated. Returns cards with quantities, prices, and metadata. Requires IWMM_API_KEY.
Inputs: page, limit.
list_notificationsARead-only
List the authenticated user's price alert notifications, newest first. Includes both read and unread. Requires IWMM_API_KEY.
Inputs: no named parameters.
list_price_alertsARead-only
List the authenticated user's price alerts. Free tier is capped at 5 active alerts and a single threshold direction per alert; Premium removes both limits. Requires IWMM_API_KEY.
Inputs: no named parameters.
list_sealed_inventoryARead-only
List the authenticated user's sealed-product inventory (booster boxes, bundles, precons), paginated, with quantities and prices. For loose cards use list_inventory. Requires IWMM_API_KEY.
Inputs: page, limit.
list_set_cardsARead-only
List all cards in a set, paginated. Supports the same filters as search_cards (rarity, type, format, legality).
Inputs: code (required), page, type, limit, +3 more.
list_transactionsARead-only
List the authenticated user's transactions, paginated. Supports sort/filter query params. Free tier sees the last 30 days only; Premium gets full history. Requires IWMM_API_KEY.
Inputs: page, sort, type, limit, +1 more.
mark_all_notifications_readA
Mark every notification for the authenticated user as read. Requires IWMM_API_KEY.
Inputs: no named parameters.
mark_notification_readC
Mark a single notification as read. Requires IWMM_API_KEY.
Inputs: id (required).
record_transactionA
Record a buy or sell transaction. By default this also adjusts inventory (BUY adds, SELL subtracts). This is a real write. Requires IWMM_API_KEY.
Inputs: date (required), type (required), cardId (required), isFoil (required), +6 more.
refresh_portfolioA
Recalculate the user's portfolio P&L. Use after recording a batch of transactions if you want immediate fresh numbers. Requires IWMM_API_KEY.
Inputs: no named parameters.
remove_buy_listADestructive
Remove a card+finish row from the authenticated user's buy-list entirely. Requires IWMM_API_KEY.
Inputs: cardId (required), isFoil.
remove_deck_cardBDestructive
Remove a card + board row from a deck entirely. Requires IWMM_API_KEY.
Inputs: cardId (required), deckId (required), isSideboard (required).
remove_inventoryADestructive
Remove a card+finish row from the authenticated user's inventory. Requires IWMM_API_KEY.
Inputs: cardId (required), isFoil (required).
remove_sealed_inventoryADestructive
Remove a sealed product from the authenticated user's inventory entirely. Premium-gated. Requires IWMM_API_KEY.
Inputs: sealedProductUuid (required).
search_cardsARead-only
Search Magic: The Gathering cards by name (substring), set code, rarity, type, or format legality. Returns a paginated list with prices and basic metadata. Use this for catalog lookups; for a specific printing prefer get_card with set+number.
Inputs: q, page, type, limit, +4 more.
search_setsBRead-only
List Magic: The Gathering sets, optionally paginated. Returns set code, name, release date, type, and aggregate prices.
Inputs: page, limit.
set_deck_card_quantityA
Set the absolute quantity for a card + board in a deck (not a delta). A quantity of 0 removes the row. Use add_deck_card to increment instead. Requires IWMM_API_KEY.
Inputs: cardId (required), deckId (required), quantity (required), isSideboard (required).
set_sealed_inventoryA
Add or update a sealed product in the authenticated user's inventory by setting its absolute quantity (upserts the row for that product). This is a real write and is Premium-gated. Use remove_sealed_inventory to delete a row. Requires IWMM_API_KEY.
Inputs: quantity (required), sealedProductUuid (required).
update_buy_listA
Set the absolute quantity for a buy-list card+finish (not a delta). A quantity of 0 removes the row. Use add_buy_list to increment instead. Requires IWMM_API_KEY.
Inputs: cardId (required), quantity (required), isFoil.
update_deckA
Rename a deck or change its format. Omitting format clears it. Requires IWMM_API_KEY.
Inputs: name (required), deckId (required), format.
update_inventoryA
Update quantities for one or more existing inventory rows. Accepts a batch. Use remove_inventory to delete a row entirely. Requires IWMM_API_KEY.
Inputs: items (required).
update_price_alertA
Update an existing price alert. Pass null for a threshold to clear it (Premium only - free users must keep exactly one direction). isActive toggles enable/disable without deleting. Requires IWMM_API_KEY.
Inputs: id (required), isActive, decreasePct, increasePct.
update_transactionA
Update an existing transaction by ID. Only the fields supplied are changed. Card identity and type (BUY/SELL) cannot be changed via this endpoint - delete and re-create instead. Requires IWMM_API_KEY.
Inputs: id (required), date, fees, notes, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 61 tools
Despite the large surface, nearly every tool targets a distinct resource+action, and descriptions actively disambiguate near-neighbors (get_card_prices vs get_card_buylist vs get_card_price_history, add_ vs update_ vs import_ variants, get_card vs search_cards vs get_card_printings). The only real clustering is among valuation tools (get_market_sell_value, get_cash_vs_credit, get_portfolio_summary, get_portfolio_history), which are clarified by their descriptions but still require careful reading.
The overwhelming majority follow a snake_case verb_noun pattern (list_inventory, add_buy_list, delete_deck, mark_notification_read). Deviations are minor but present: deck_missing_to_buy_list lacks a leading verb, import_deck/import_buy_list/import_inventory_cards use inconsistent suffixes, and set_sealed_inventory breaks the add/update/remove convention used for loose cards.
61 tools is far past a comfortable set size, even for a broad collection-management domain; the surface sprawls across catalog, pricing, inventory, buy list, decks, transactions, portfolio analytics, alerts, and notifications. Many CRUD families could be collapsed or grouped (e.g. portfolios, alert thresholds) to reduce selection overhead for an agent.
Coverage is genuinely strong: full CRUD on inventory, buy list, decks, transactions, price alerts, and notifications, plus bulk import/export and portfolio analytics. Small gaps remain, such as no get_transaction by ID (only list/update/delete) and no deck duplicate/clone, but these are workable around.
Maintenance
Related MCP Connectors
An MCP server that provides congressional transcripts
Skills, agents and memory in the cloud, plus a gateway to your other MCP servers.
MCP server for searching Airweave collections with natural language queries.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceA comprehensive Model Context Protocol server that integrates with the Scryfall API to provide Magic: The Gathering card data to AI assistants like Claude.1475 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables fuzzy lookup of Magic: The Gathering cards by name using the Scryfall API, returning card details including type, oracle text, mana value, and images.MIT
- AlicenseAqualityDmaintenanceMagic: The Gathering MCP server with card search, rules lookup, deck analysis, and Commander intelligence145MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive Model Context Protocol server that provides AI assistants with rich Magic: The Gathering information, including card data, comprehensive rules, EDHREC recommendations, combo interactions, and intelligent Commander deck generation.34 PyPI1MIT