io.github.matthewdtowles/iwantmymtg-mcp

NPM · IWANTMYMTG-MCP · SCANNED AUG 3

Query Magic: The Gathering cards, sets, and prices and manage your I Want My MTG collection.

Available components

+55 this week 79 79 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (97 of 101), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (97 of 101), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to matthewdtowles/iwantmymtg-mcp). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 2 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability79

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 4565 tokens (~76/item across 60 items; 60 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage88

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
63% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · iwantmymtg-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add matthewdtowles-iwantmymtg-mcp -- npx -y iwantmymtg-mcp

# add to Codex CLI

codex mcp add matthewdtowles-iwantmymtg-mcp -- npx -y iwantmymtg-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "matthewdtowles-iwantmymtg-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "iwantmymtg-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add matthewdtowles-iwantmymtg-mcp --command npx --arg -y --arg iwantmymtg-mcp

# ~/.hermes/config.yaml

mcp_servers:
  matthewdtowles-iwantmymtg-mcp:
    command: "npx"
    args: ["-y", "iwantmymtg-mcp"]

// mcp.json

{
  "mcpServers": {
    "matthewdtowles-iwantmymtg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iwantmymtg-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +44
- Known CVEs: unverified → partial ▲ security
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- The attested source repository moved: matthewdtowles/iwantmymtg-mcp security
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Stability: unverified → 0.23 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
2 Aug 26 −3
- Install scripts: pass → unverified ▼ security
- Provenance: pass → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: matthewdtowles/iwantmymtg-mcp security
- Maintenance: pass → unverified ▼ functional
- License: pass → unverified ▼ functional
- Licence: MIT functional
1 Aug 26 −7
- Stability: 0.13 → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
31 Jul 26 0
- Malware scan: pass → unverified ▼ security
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- The attested source repository moved: matthewdtowles/iwantmymtg-mcp security
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- First check of Stability: 0.13 functional
- First check of MCP protocol: pass functional
- Licence: MIT functional
- Package version: 0.6.9 → 0.7.0 functional
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
28 Jul 26 +21
- Tool coverage: unverified → 100 ▲ functional
- First check of Schema quality: unverified functional
- First check of Schema quality: pass functional
- First check of Tool coverage: 62 functional
- First check of Schema quality: fail functional
27 Jul 26 24

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: matthewdtowles/iwantmymtg-mcp
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/matthewdtowles/iwantmymtg-mcp/.github/workflows/ci.yml@refs/heads/main
Rekor log index:: 2305381939
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:8097f74770ee587060d46abaf33384ca9cf1c9fc5064f660597f33a0c953c342156bc72ecb7c4fc5c7b81cb5a4275e5f99967196aac07eb7826ecf52f
Discovery method:: attestation_endpoint

Dependencies 97 packages

97 packages in the resolved dependency tree · 97 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 60 exposed · ~4,565 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

add_buy_list ~126

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.

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	Internal IWMM card UUID. Get from search_cards or get_card.
isFoil	boolean	—	Whether this is the foil variant. Foil and non-foil are separate rows. Defaults to false.
quantity	integer	—	How many to add. Defaults to 1.

No output schema declared.

No examples provided.

add_deck_card ~142

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.

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	Internal IWMM card UUID. Get from search_cards or get_card.
deckId	integer	yes	Deck id. Get from list_decks or create_deck.
isSideboard	boolean	—	Whether the card belongs to the sideboard. Mainboard and sideboard are separate rows. Defaults to false.
quantity	integer	—	How many to add. Defaults to 1.

No output schema declared.

No examples provided.

add_inventory ~66

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.

Input Output Examples

Name	Type	Req	Description
items	array	yes	—

No output schema declared.

No examples provided.

create_deck ~71

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.

Input Output Examples

Name	Type	Req	Description
format	string	—	Target format. Omit for no format.
name	string	yes	Deck name.

No output schema declared.

No examples provided.

create_price_alert ~89

Create a price alert for a card. Supply increasePct, decreasePct, or both (Premium). At least one threshold is required. Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	Internal IWMM card UUID.
decreasePct	number	—	Trigger when price decreases by at least this percent.
increasePct	number	—	Trigger when price increases by at least this percent.

No output schema declared.

No examples provided.

deck_missing_to_buy_list ~76

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.

Input Output Examples

Name	Type	Req	Description
deckId	integer	yes	Deck id. Get from list_decks or create_deck.

No output schema declared.

No examples provided.

delete_deck ~48

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

Input Output Examples

Name	Type	Req	Description
deckId	integer	yes	Deck id. Get from list_decks or create_deck.

No output schema declared.

No examples provided.

delete_price_alert ~29

Delete a price alert by ID. Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

No output schema declared.

No examples provided.

delete_transaction ~27

Delete a transaction by ID. Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

No output schema declared.

No examples provided.

export_inventory ~47

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_card ~95

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.

Input Output Examples

Name	Type	Req	Description
setCode	string	yes	Set code (e.g. 'lea').
setNumber	string	yes	Collector number within the set (e.g. '161'). String, not int - some sets use suffixes like '12a'.

No output schema declared.

No examples provided.

get_card_buylist ~111

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.

Input Output Examples

Name	Type	Req	Description
setCode	string	yes	Set code (e.g. 'lea').
setNumber	string	yes	Collector number within the set (e.g. '1', '234a').

No output schema declared.

No examples provided.

get_card_performance ~56

Get the user's best- or worst-performing cards by P&L. Default: best, top 10. Premium-gated. Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
type	string	—	—

No output schema declared.

No examples provided.

get_card_price_history ~91

Get the 30-day price history for a card printing (normal + foil). Older data is retained on a weekly/monthly cadence beyond 30 days.

Input Output Examples

Name	Type	Req	Description
setCode	string	yes	Set code (e.g. 'lea').
setNumber	string	yes	Collector number within the set (e.g. '161'). String, not int - some sets use suffixes like '12a'.

No output schema declared.

No examples provided.

get_card_prices ~71

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

Input Output Examples

Name	Type	Req	Description
setCode	string	yes	Set code (e.g. 'lea').
setNumber	string	yes	Collector number within the set (e.g. '161'). String, not int - some sets use suffixes like '12a'.

No output schema declared.

No examples provided.

get_card_printings ~159

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.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Page size (max 100).
page	integer	—	1-based page index.
setCode	string	yes	Set code (e.g. 'lea').
setNumber	string	yes	Collector number within the set (e.g. '161'). String, not int - some sets use suffixes like '12a'.

No output schema declared.

No examples provided.

get_cash_flow ~36

Get the user's cash flow (money in vs money out from BUY/SELL transactions). Premium-gated. Requires IWMM_API_KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_cash_vs_credit ~115

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.

Input Output Examples

Name	Type	Req	Description
bonus	number	—	Store-credit bonus as a fraction (0.30 = +30%). Must be in [0, 2]; defaults to 0.30 (Card Kingdom).

No output schema declared.

No examples provided.

get_cost_basis ~75

Get FIFO cost basis for a specific card+finish for the authenticated user. Pass either cardId or (setCode, setNumber). Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
cardId	string	—	—
isFoil	boolean	—	—
setCode	string	—	—
setNumber	string	—	—

No output schema declared.

No examples provided.

get_deck ~48

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

Input Output Examples

Name	Type	Req	Description
deckId	integer	yes	Deck id. Get from list_decks or create_deck.

No output schema declared.

No examples provided.

get_inventory_quantities ~54

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.

Input Output Examples

Name	Type	Req	Description
cardIds	array	yes	—

No output schema declared.

No examples provided.

get_market_sell_value ~71

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_portfolio_breakdown ~136

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.

Input Output Examples

Name	Type	Req	Description
by	string	yes	Dimension to break down by. 'cost-basis' buckets are gain/loss/at-cost; 'color' groups by color identity.
colors	string	—	Only for by=color: comma-separated identity codes (W,U,B,R,G,C; C is colorless) to keep only cards whose color identity contains all of them. Ignored for other dimensions.

No output schema declared.

No examples provided.

get_portfolio_breakdown_cards ~141

Get the cards inside one slice of a portfolio breakdown (the drill-down for get_portfolio_breakdown). Premium-gated. Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
by	string	yes	Dimension the slice belongs to. Must match the get_portfolio_breakdown call.
colors	string	—	Only for by=color: the same superset filter (W,U,B,R,G,C) passed to get_portfolio_breakdown, so the drill-down matches the aggregate row. Ignored for other dimensions.
key	string	yes	Slice key from the breakdown: a set code, rarity, type, cost-basis bucket, or color code.

No output schema declared.

No examples provided.

get_portfolio_history ~49

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

Input Output Examples

Name	Type	Req	Description
days	integer	—	How many days of history. Server default applies if omitted.

No output schema declared.

No examples provided.

get_portfolio_summary ~60

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_realized_gains ~34

Get the user's realized gains from SELL transactions using FIFO cost basis. Premium-gated. Requires IWMM_API_KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_sealed_product ~64

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.

Input Output Examples

Name	Type	Req	Description
uuid	string	yes	Sealed product UUID, e.g. from get_sealed_products.

No output schema declared.

No examples provided.

get_sealed_products ~46

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

Input Output Examples

Name	Type	Req	Description
code	string	yes	—

No output schema declared.

No examples provided.

get_set ~34

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

Input Output Examples

Name	Type	Req	Description
code	string	yes	—

No output schema declared.

No examples provided.

get_set_price_history ~80

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.

Input Output Examples

Name	Type	Req	Description
code	string	yes	Set code (e.g. 'mh3').
days	integer	—	Number of days of history to return.

No output schema declared.

No examples provided.

get_unread_notification_count ~28

Get the count of unread notifications for the authenticated user. Requires IWMM_API_KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

import_buy_list ~87

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.

Input Output Examples

Name	Type	Req	Description
text	string	yes	CSV text including a header row.

No output schema declared.

No examples provided.

import_deck ~93

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.

Input Output Examples

Name	Type	Req	Description
format	string	—	Target format. Omit for no format.
name	string	yes	Deck name.
text	string	yes	Decklist text, one entry per line.

No output schema declared.

No examples provided.

import_inventory_cards ~90

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.

Input Output Examples

Name	Type	Req	Description
text	string	yes	CSV text including a header row.

No output schema declared.

No examples provided.

list_buy_list ~41

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_decks ~33

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_inventory ~48

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

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
page	integer	—	—

No output schema declared.

No examples provided.

list_notifications ~31

List the authenticated user's price alert notifications, newest first. Includes both read and unread. Requires IWMM_API_KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_price_alerts ~45

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_sealed_inventory ~62

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.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
page	integer	—	—

No output schema declared.

No examples provided.

list_set_cards ~87

List all cards in a set, paginated. Supports the same filters as search_cards (rarity, type, format, legality).

Input Output Examples

Name	Type	Req	Description
code	string	yes	Set code.
format	string	—	—
legality	string	—	—
limit	integer	—	—
page	integer	—	—
rarity	string	—	—
type	string	—	—

No output schema declared.

No examples provided.

list_transactions ~106

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.

Input Output Examples

Name	Type	Req	Description
ascend	boolean	—	Sort direction: true for ascending, false for descending.
limit	integer	—	—
page	integer	—	—
sort	string	—	Sort key (e.g. TX_DATE, TX_TYPE, TX_CARD, TX_PRICE).
type	string	—	—

No output schema declared.

No examples provided.

mark_all_notifications_read ~26

Mark every notification for the authenticated user as read. Requires IWMM_API_KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

mark_notification_read ~29

Mark a single notification as read. Requires IWMM_API_KEY.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

No output schema declared.

No examples provided.

record_transaction ~170

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.

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	Internal IWMM card UUID.
date	string	yes	ISO 8601 date (YYYY-MM-DD).
fees	number	—	—
isFoil	boolean	yes	—
notes	string	—	—
pricePerUnit	number	yes	Per-unit price in USD.
quantity	integer	yes	—
skipInventorySync	boolean	—	If true, record the transaction without adjusting inventory. Default false - transactions normally update inventory.
source	string	—	Where the transaction happened (e.g. 'TCGPlayer', 'LGS').
type	string	yes	—

No output schema declared.

No examples provided.

refresh_portfolio ~38

Recalculate the user's portfolio P&L. Use after recording a batch of transactions if you want immediate fresh numbers. Requires IWMM_API_KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

remove_buy_list ~79

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

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	Internal IWMM card UUID. Get from search_cards or get_card.
isFoil	boolean	—	Whether this is the foil variant. Foil and non-foil are separate rows. Defaults to false.

No output schema declared.

No examples provided.

remove_deck_card ~92

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

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	Internal IWMM card UUID. Get from search_cards or get_card.
deckId	integer	yes	Deck id. Get from list_decks or create_deck.
isSideboard	boolean	yes	Which board the row belongs to. Mainboard and sideboard are separate rows.

No output schema declared.

No examples provided.

remove_inventory ~43

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

Input Output Examples

Name	Type	Req	Description
cardId	string	yes	—
isFoil	boolean	yes	—

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug