Skip to main content
Glama
iwantmymtg-mcp

iwantmymtg-mcp

iwantmymtg-mcp

npm version License: MIT LightNow

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.md for the full, always-current tool list.

Demo: Claude Code answering four collection queries via the iwmm MCP server

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-mcp

Or install globally if you prefer:

npm install -g iwantmymtg-mcp
iwantmymtg-mcp

Claude 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

IWMM_API_KEY

(unset)

Personal API key. Required only for authenticated tools.

IWMM_BASE_URL

https://iwantmymtg.net

Override for self-hosted or local-dev IWMM instances.

Local development

npm install
npm run build
node dist/index.js

Or with tsx for live reload:

npm install
npx tsx src/index.ts

License

This project is licensed under the MIT License — see the LICENSE file for details.

Available Tools

61 tools
add_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_deckA
Destructive

Delete a deck and all of its cards. This is permanent. Requires IWMM_API_KEY.

Inputs: deckId (required).

delete_price_alertB
Destructive

Delete a price alert by ID. Requires IWMM_API_KEY.

Inputs: id (required).

delete_transactionA
Destructive

Delete a transaction by ID. Requires IWMM_API_KEY.

Inputs: id (required).

export_inventoryA
Read-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_cardA
Read-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_buylistA
Read-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_performanceA
Read-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_historyA
Read-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_pricesA
Read-only

Get current normal and foil prices for a specific card printing.

Inputs: setCode (required), setNumber (required).

get_card_printingsA
Read-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_flowA
Read-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_creditA
Read-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_basisA
Read-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_deckA
Read-only

Get one deck with its cards (mainboard + sideboard). Requires IWMM_API_KEY.

Inputs: deckId (required).

get_inventory_quantitiesA
Read-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_valueA
Read-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_breakdownA
Read-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_cardsA
Read-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_historyA
Read-only

Get portfolio value history. Premium-gated - free tier receives 403. Requires IWMM_API_KEY.

Inputs: days.

get_portfolio_summaryA
Read-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_moversA
Read-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_gainsA
Read-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_productA
Read-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_productsA
Read-only

List sealed products (booster boxes, bundles, commander decks, etc.) for a set. Each entry includes a TCGPlayer purchase URL.

Inputs: code (required).

get_setA
Read-only

Get detail for a single set by code (e.g. 'lea', 'mh3').

Inputs: code (required).

get_set_price_historyA
Read-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_countB
Read-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_listA
Read-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_decksA
Read-only

List the authenticated user's decks (summaries: id, name, format, card counts). Requires IWMM_API_KEY.

Inputs: no named parameters.

list_inventoryB
Read-only

List the authenticated user's card inventory, paginated. Returns cards with quantities, prices, and metadata. Requires IWMM_API_KEY.

Inputs: page, limit.

list_notificationsA
Read-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_alertsA
Read-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_inventoryA
Read-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_cardsA
Read-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_transactionsA
Read-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_listA
Destructive

Remove a card+finish row from the authenticated user's buy-list entirely. Requires IWMM_API_KEY.

Inputs: cardId (required), isFoil.

remove_deck_cardB
Destructive

Remove a card + board row from a deck entirely. Requires IWMM_API_KEY.

Inputs: cardId (required), deckId (required), isSideboard (required).

remove_inventoryA
Destructive

Remove a card+finish row from the authenticated user's inventory. Requires IWMM_API_KEY.

Inputs: cardId (required), isFoil (required).

remove_sealed_inventoryA
Destructive

Remove a sealed product from the authenticated user's inventory entirely. Premium-gated. Requires IWMM_API_KEY.

Inputs: sealedProductUuid (required).

search_cardsA
Read-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_setsB
Read-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

    A3.6/5.0

    Scored across 61 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 PyPI
      1
      MIT