iwantmymtg-mcp 0.0.1

package/README.md

@@ -0,0 +1,91 @@
+# iwantmymtg-mcp
+
+An [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.
+
+> Status: v0 scaffold. The set of tools below is the v1 surface; coverage will expand to match the API.
+
+## What you can do
+
+- **Anonymous (no key):** search cards, look up a card by set+number, get current prices and 30-day price history, list sets and their cards, list sealed products.
+- **Authenticated (with an IWMM API key):** list and update your inventory.
+
+More authenticated tools (transactions, portfolio breakdowns, price alerts, notifications) are coming - see the [project roadmap](https://github.com/matthewdtowles/i-want-my-mtg/blob/main/ROADMAP.md#43-mcp-server--agentic-ai-integration).
+
+## Install
+
+Requires Node 20+.
+
+```bash
+npx iwantmymtg-mcp
+```
+
+(Until published to npm, use the local install instructions below.)
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`; Windows: `%APPDATA%\Claude\claude_desktop_config.json`):
+
+```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):
+
+```json
+{
+  "mcpServers": {
+    "iwmm": {
+      "command": "npx",
+      "args": ["-y", "iwantmymtg-mcp"],
+      "env": { "IWMM_API_KEY": "iwm_live_..." }
+    }
+  }
+}
+```
+
+## 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?"
+
+## 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
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+Or with `tsx` for live reload:
+
+```bash
+npm install
+npx tsx src/index.ts
+```
+
+## License
+
+MIT

package/dist/api-client.js

@@ -0,0 +1,51 @@
+import { config } from "./config.js";
+export class ApiError extends Error {
+    status;
+    body;
+    rateLimit;
+    constructor(status, body, rateLimit) {
+        super(`IWMM API ${status}: ${body}`);
+        this.status = status;
+        this.body = body;
+        this.rateLimit = rateLimit;
+        this.name = "ApiError";
+    }
+}
+export async function apiFetch(req) {
+    const url = new URL(req.path, config.baseUrl);
+    if (req.query) {
+        for (const [k, v] of Object.entries(req.query)) {
+            if (v !== undefined && v !== null && v !== "") {
+                url.searchParams.set(k, String(v));
+            }
+        }
+    }
+    const headers = {
+        Accept: "application/json",
+        "User-Agent": "iwantmymtg-mcp/0.0.1",
+    };
+    if (req.authenticated) {
+        const { requireApiKey } = await import("./config.js");
+        headers["Authorization"] = `Bearer ${requireApiKey()}`;
+    }
+    if (req.body !== undefined) {
+        headers["Content-Type"] = "application/json";
+    }
+    const res = await fetch(url, {
+        method: req.method ?? "GET",
+        headers,
+        body: req.body !== undefined ? JSON.stringify(req.body) : undefined,
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new ApiError(res.status, text, {
+            limit: res.headers.get("X-RateLimit-Limit") ?? undefined,
+            remaining: res.headers.get("X-RateLimit-Remaining") ?? undefined,
+            reset: res.headers.get("X-RateLimit-Reset") ?? undefined,
+        });
+    }
+    if (res.status === 204)
+        return undefined;
+    return (await res.json());
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IACA;IACA;IAHlB,YACkB,MAAc,EACd,IAAY,EACZ,SAIf;QAED,KAAK,CAAC,YAAY,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QARrB,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAIxB;QAGD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,GAAe;IACzD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC9C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,kBAAkB;QAC1B,YAAY,EAAE,sBAAsB;KACrC,CAAC;IAEF,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,aAAa,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;QAC3B,OAAO;QACP,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KACpE,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE;YACnC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS;YACxD,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,SAAS;YAChE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS;SACzD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAC;IAC9C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;AACjC,CAAC"}

package/dist/config.js

@@ -0,0 +1,18 @@
+// Reads env lazily so callers and tests see live values rather than a snapshot
+// taken at import time.
+export const config = {
+    get baseUrl() {
+        return process.env.IWMM_BASE_URL ?? "https://iwantmymtg.net";
+    },
+    get apiKey() {
+        return process.env.IWMM_API_KEY;
+    },
+};
+export function requireApiKey() {
+    if (!config.apiKey) {
+        throw new Error("This tool requires an API key. Set IWMM_API_KEY in your MCP client config. " +
+            "Create a key at https://iwantmymtg.net/user/api-keys.");
+    }
+    return config.apiKey;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wBAAwB;AACxB,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,OAAO;QACT,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,wBAAwB,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAClC,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,6EAA6E;YAC3E,uDAAuD,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { startServer } from "./server.js";
+startServer().catch((err) => {
+    // stderr - stdout is reserved for the MCP transport
+    console.error("[iwantmymtg-mcp] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC1B,oDAAoD;IACpD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.js

@@ -0,0 +1,66 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { tools, toolsByName } from "./tools/index.js";
+import { ApiError } from "./api-client.js";
+export async function startServer() {
+    const server = new Server({
+        name: "iwantmymtg-mcp",
+        version: "0.0.1",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.inputSchema, { target: "openApi3" }),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const tool = toolsByName[req.params.name];
+        if (!tool) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }],
+            };
+        }
+        const args = tool.inputSchema.safeParse(req.params.arguments ?? {});
+        if (!args.success) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid arguments for ${tool.name}: ${args.error.message}`,
+                    },
+                ],
+            };
+        }
+        try {
+            const result = await tool.handler(args.data);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: "text", text: formatError(err) }] };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function formatError(err) {
+    if (err instanceof ApiError) {
+        const rl = err.rateLimit;
+        const rateNote = rl?.remaining !== undefined
+            ? ` (rate limit: ${rl.remaining}/${rl.limit} remaining, resets ${rl.reset ?? "?"})`
+            : "";
+        return `IWMM API responded ${err.status}${rateNote}: ${err.body}`;
+    }
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/alerts.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+const thresholdRefinement = (v) => v.increasePct != null || v.decreasePct != null;
+export const listAlertsTool = {
+    name: "list_price_alerts",
+    description: "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.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/price-alerts", authenticated: true }),
+};
+export const createAlertTool = {
+    name: "create_price_alert",
+    description: "Create a price alert for a card. Supply increasePct, decreasePct, or both (Premium). At least one threshold is required. Requires IWMM_API_KEY.",
+    inputSchema: z
+        .object({
+        cardId: z.string().uuid().describe("Internal IWMM card UUID."),
+        increasePct: z.number().min(0.01).optional().describe("Trigger when price increases by at least this percent."),
+        decreasePct: z.number().min(0.01).optional().describe("Trigger when price decreases by at least this percent."),
+    })
+        .refine(thresholdRefinement, { message: "Provide at least one of increasePct or decreasePct." }),
+    handler: (input) => apiFetch({ path: "/api/v1/price-alerts", method: "POST", body: input, authenticated: true }),
+};
+export const updateAlertTool = {
+    name: "update_price_alert",
+    description: "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.",
+    inputSchema: z.object({
+        id: z.string().describe("Alert ID from list_price_alerts."),
+        increasePct: z.number().min(0.01).nullable().optional(),
+        decreasePct: z.number().min(0.01).nullable().optional(),
+        isActive: z.boolean().optional(),
+    }),
+    handler: ({ id, ...patch }) => apiFetch({ path: `/api/v1/price-alerts/${encodeURIComponent(id)}`, method: "PATCH", body: patch, authenticated: true }),
+};
+export const deleteAlertTool = {
+    name: "delete_price_alert",
+    description: "Delete a price alert by ID. Requires IWMM_API_KEY.",
+    inputSchema: z.object({ id: z.string() }),
+    handler: ({ id }) => apiFetch({ path: `/api/v1/price-alerts/${encodeURIComponent(id)}`, method: "DELETE", authenticated: true }),
+};
+//# sourceMappingURL=alerts.js.map

package/dist/tools/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,mBAAmB,GAAG,CAAC,CAA+D,EAAE,EAAE,CAC9F,CAAC,CAAC,WAAW,IAAI,IAAI,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,oLAAoL;IACtL,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAC/E,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,iJAAiJ;IACnJ,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAC/G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KAChH,CAAC;SACD,MAAM,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC;IAClG,OAAO,EAAE,CAAC,KAAqE,EAAE,EAAE,CACjF,QAAQ,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,6MAA6M;IAC/M,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACvD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAA4C,EAAE,EAAE,CACtE,QAAQ,CAAC,EAAE,IAAI,EAAE,wBAAwB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAC1H,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,oDAAoD;IACjE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACzC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAkB,EAAE,EAAE,CAClC,QAAQ,CAAC,EAAE,IAAI,EAAE,wBAAwB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAC9G,CAAC"}

package/dist/tools/get-card.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+export const getCardInputSchema = {
+    setCode: z.string().describe("Set code (e.g. 'lea')."),
+    setNumber: z.string().describe("Collector number within the set (e.g. '161'). String, not int - some sets use suffixes like '12a'."),
+};
+export async function getCard(input) {
+    return apiFetch({
+        path: `/api/v1/cards/${encodeURIComponent(input.setCode)}/${encodeURIComponent(input.setNumber)}`,
+    });
+}
+export const getCardTool = {
+    name: "get_card",
+    description: "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.",
+    inputSchema: z.object(getCardInputSchema),
+    handler: getCard,
+};
+export const getCardPricesTool = {
+    name: "get_card_prices",
+    description: "Get current normal and foil prices for a specific card printing.",
+    inputSchema: z.object(getCardInputSchema),
+    handler: async (input) => apiFetch({
+        path: `/api/v1/cards/${encodeURIComponent(input.setCode)}/${encodeURIComponent(input.setNumber)}/prices`,
+    }),
+};
+export const getCardPriceHistoryTool = {
+    name: "get_card_price_history",
+    description: "Get the 30-day price history for a card printing (normal + foil). Older data is retained on a weekly/monthly cadence beyond 30 days.",
+    inputSchema: z.object(getCardInputSchema),
+    handler: async (input) => apiFetch({
+        path: `/api/v1/cards/${encodeURIComponent(input.setCode)}/${encodeURIComponent(input.setNumber)}/price-history`,
+    }),
+};
+//# sourceMappingURL=get-card.js.map

package/dist/tools/get-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-card.js","sourceRoot":"","sources":["../../src/tools/get-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;CACrI,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAA6C;IACzE,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;KAClG,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,mMAAmM;IACrM,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;IACzC,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,kEAAkE;IAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;IACzC,OAAO,EAAE,KAAK,EAAE,KAA6C,EAAE,EAAE,CAC/D,QAAQ,CAAC;QACP,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS;KACzG,CAAC;CACL,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,sIAAsI;IACxI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;IACzC,OAAO,EAAE,KAAK,EAAE,KAA6C,EAAE,EAAE,CAC/D,QAAQ,CAAC;QACP,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB;KAChH,CAAC;CACL,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,51 @@
+import { searchCardsTool } from "./search-cards.js";
+import { getCardTool, getCardPricesTool, getCardPriceHistoryTool } from "./get-card.js";
+import { searchSetsTool, getSetTool, listSetCardsTool, getSealedProductsTool } from "./sets.js";
+import { listInventoryTool, addInventoryTool, updateInventoryTool, removeInventoryTool, getInventoryQuantitiesTool, } from "./inventory.js";
+import { listTransactionsTool, recordTransactionTool, updateTransactionTool, deleteTransactionTool, getCostBasisTool, } from "./transactions.js";
+import { getPortfolioSummaryTool, getPortfolioHistoryTool, getCardPerformanceTool, getCashFlowTool, getRealizedGainsTool, getPortfolioBreakdownTool, refreshPortfolioTool, } from "./portfolio.js";
+import { listAlertsTool, createAlertTool, updateAlertTool, deleteAlertTool, } from "./alerts.js";
+import { listNotificationsTool, getUnreadCountTool, markNotificationReadTool, markAllNotificationsReadTool, } from "./notifications.js";
+export const tools = [
+    // Read-only (no auth)
+    searchCardsTool,
+    getCardTool,
+    getCardPricesTool,
+    getCardPriceHistoryTool,
+    searchSetsTool,
+    getSetTool,
+    listSetCardsTool,
+    getSealedProductsTool,
+    // Inventory (auth)
+    listInventoryTool,
+    getInventoryQuantitiesTool,
+    addInventoryTool,
+    updateInventoryTool,
+    removeInventoryTool,
+    // Transactions (auth)
+    listTransactionsTool,
+    recordTransactionTool,
+    updateTransactionTool,
+    deleteTransactionTool,
+    getCostBasisTool,
+    // Portfolio (auth; most are Premium-gated)
+    getPortfolioSummaryTool,
+    getPortfolioHistoryTool,
+    getCardPerformanceTool,
+    getCashFlowTool,
+    getRealizedGainsTool,
+    getPortfolioBreakdownTool,
+    refreshPortfolioTool,
+    // Price alerts (auth)
+    listAlertsTool,
+    createAlertTool,
+    updateAlertTool,
+    deleteAlertTool,
+    // Notifications (auth)
+    listNotificationsTool,
+    getUnreadCountTool,
+    markNotificationReadTool,
+    markAllNotificationsReadTool,
+];
+export const toolsByName = Object.fromEntries(tools.map((t) => [t.name, t]));
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAS5B,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC,sBAAsB;IACtB,eAAe;IACf,WAAW;IACX,iBAAiB;IACjB,uBAAuB;IACvB,cAAc;IACd,UAAU;IACV,gBAAgB;IAChB,qBAAqB;IACrB,mBAAmB;IACnB,iBAAiB;IACjB,0BAA0B;IAC1B,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,sBAAsB;IACtB,oBAAoB;IACpB,qBAAqB;IACrB,qBAAqB;IACrB,qBAAqB;IACrB,gBAAgB;IAChB,2CAA2C;IAC3C,uBAAuB;IACvB,uBAAuB;IACvB,sBAAsB;IACtB,eAAe;IACf,oBAAoB;IACpB,yBAAyB;IACzB,oBAAoB;IACpB,sBAAsB;IACtB,cAAc;IACd,eAAe;IACf,eAAe;IACf,eAAe;IACf,uBAAuB;IACvB,qBAAqB;IACrB,kBAAkB;IAClB,wBAAwB;IACxB,4BAA4B;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAmC,MAAM,CAAC,WAAW,CAC3E,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC9B,CAAC"}

package/dist/tools/inventory.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+const inventoryItem = z.object({
+    cardId: z.string().uuid().describe("Internal IWMM card UUID. Get from search_cards or get_card."),
+    quantity: z.number().int().min(0).describe("Total quantity for this card+finish. 0 removes the row."),
+    isFoil: z.boolean().describe("Whether this is the foil variant. Foil and non-foil are tracked as separate rows."),
+});
+export const listInventoryTool = {
+    name: "list_inventory",
+    description: "List the authenticated user's card inventory, paginated. Requires IWMM_API_KEY. Returns cards with quantities, prices, and metadata.",
+    inputSchema: z.object({
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    }),
+    handler: (input) => apiFetch({
+        path: "/api/v1/inventory",
+        query: input,
+        authenticated: true,
+    }),
+};
+export const addInventoryTool = {
+    name: "add_inventory",
+    description: "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.",
+    inputSchema: z.object({ items: z.array(inventoryItem).min(1) }),
+    handler: (input) => apiFetch({ path: "/api/v1/inventory", method: "POST", body: input.items, authenticated: true }),
+};
+export const updateInventoryTool = {
+    name: "update_inventory",
+    description: "Update quantities for one or more existing inventory rows. Accepts a batch. Use remove_inventory to delete a row entirely. Requires IWMM_API_KEY.",
+    inputSchema: z.object({ items: z.array(inventoryItem).min(1) }),
+    handler: (input) => apiFetch({ path: "/api/v1/inventory", method: "PATCH", body: input.items, authenticated: true }),
+};
+export const removeInventoryTool = {
+    name: "remove_inventory",
+    description: "Remove a card+finish row from the authenticated user's inventory. Requires IWMM_API_KEY.",
+    inputSchema: z.object({
+        cardId: z.string().uuid(),
+        isFoil: z.boolean(),
+    }),
+    handler: (input) => apiFetch({ path: "/api/v1/inventory", method: "DELETE", body: input, authenticated: true }),
+};
+export const getInventoryQuantitiesTool = {
+    name: "get_inventory_quantities",
+    description: "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.",
+    inputSchema: z.object({
+        cardIds: z.array(z.string().uuid()).min(1).max(200),
+    }),
+    handler: ({ cardIds }) => apiFetch({
+        path: "/api/v1/inventory/quantities",
+        query: { cardIds: cardIds.join(",") },
+        authenticated: true,
+    }),
+};
+//# sourceMappingURL=inventory.js.map

package/dist/tools/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../src/tools/inventory.ts"],"names":[],"mappings":"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"}

package/dist/tools/notifications.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+export const listNotificationsTool = {
+    name: "list_notifications",
+    description: "List the authenticated user's price alert notifications, newest first. Includes both read and unread. Requires IWMM_API_KEY.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/notifications", authenticated: true }),
+};
+export const getUnreadCountTool = {
+    name: "get_unread_notification_count",
+    description: "Get the count of unread notifications for the authenticated user. Requires IWMM_API_KEY.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/notifications/unread-count", authenticated: true }),
+};
+export const markNotificationReadTool = {
+    name: "mark_notification_read",
+    description: "Mark a single notification as read. Requires IWMM_API_KEY.",
+    inputSchema: z.object({ id: z.string() }),
+    handler: ({ id }) => apiFetch({ path: `/api/v1/notifications/${encodeURIComponent(id)}/read`, method: "PATCH", authenticated: true }),
+};
+export const markAllNotificationsReadTool = {
+    name: "mark_all_notifications_read",
+    description: "Mark every notification for the authenticated user as read. Requires IWMM_API_KEY.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/notifications/read-all", method: "PATCH", authenticated: true }),
+};
+//# sourceMappingURL=notifications.js.map

package/dist/tools/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/tools/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,8HAA8H;IAChI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAChF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,0FAA0F;IACvG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,oCAAoC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAC7F,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,4DAA4D;IACzE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACzC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAkB,EAAE,EAAE,CAClC,QAAQ,CAAC,EAAE,IAAI,EAAE,yBAAyB,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CACnH,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,oFAAoF;IACjG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,gCAAgC,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;CAC1G,CAAC"}

package/dist/tools/portfolio.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+export const getPortfolioSummaryTool = {
+    name: "get_portfolio_summary",
+    description: "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.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/portfolio", authenticated: true }),
+};
+export const getPortfolioHistoryTool = {
+    name: "get_portfolio_history",
+    description: "Get portfolio value history. Premium-gated - free tier receives 403. Requires IWMM_API_KEY.",
+    inputSchema: z.object({
+        days: z.number().int().min(1).max(3650).optional().describe("How many days of history. Server default applies if omitted."),
+    }),
+    handler: ({ days }) => apiFetch({ path: "/api/v1/portfolio/history", query: { days }, authenticated: true }),
+};
+export const getCardPerformanceTool = {
+    name: "get_card_performance",
+    description: "Get the user's best- or worst-performing cards by P&L. Default: best, top 10. Premium-gated. Requires IWMM_API_KEY.",
+    inputSchema: z.object({
+        type: z.enum(["best", "worst"]).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    }),
+    handler: (input) => apiFetch({ path: "/api/v1/portfolio/performance", query: input, authenticated: true }),
+};
+export const getCashFlowTool = {
+    name: "get_cash_flow",
+    description: "Get the user's cash flow (money in vs money out from BUY/SELL transactions). Premium-gated. Requires IWMM_API_KEY.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/portfolio/cash-flow", authenticated: true }),
+};
+export const getRealizedGainsTool = {
+    name: "get_realized_gains",
+    description: "Get the user's realized gains from SELL transactions using FIFO cost basis. Premium-gated. Requires IWMM_API_KEY.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/portfolio/realized-gains", authenticated: true }),
+};
+export const getPortfolioBreakdownTool = {
+    name: "get_portfolio_breakdown",
+    description: "Get the user's collection value broken down by a dimension. Premium-gated. Requires IWMM_API_KEY.",
+    inputSchema: z.object({
+        by: z
+            .enum(["set", "rarity", "type", "format", "cost-basis"])
+            .describe("Dimension to break down by. 'cost-basis' buckets are gain/loss/at-cost."),
+    }),
+    handler: ({ by }) => apiFetch({ path: "/api/v1/portfolio/breakdown", query: { by }, authenticated: true }),
+};
+export const refreshPortfolioTool = {
+    name: "refresh_portfolio",
+    description: "Recalculate the user's portfolio P&L. Use after recording a batch of transactions if you want immediate fresh numbers. Requires IWMM_API_KEY.",
+    inputSchema: z.object({}),
+    handler: () => apiFetch({ path: "/api/v1/portfolio/refresh", method: "POST", authenticated: true }),
+};
+//# sourceMappingURL=portfolio.js.map

package/dist/tools/portfolio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.js","sourceRoot":"","sources":["../../src/tools/portfolio.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-cards.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+export const searchCardsInputSchema = {
+    q: z
+        .string()
+        .optional()
+        .describe("Substring to search card name + flavor name. Optional; omit to filter purely by setCode/rarity/type/format."),
+    setCode: z.string().optional().describe("3-5 character set code (e.g. 'lea', 'mh3')."),
+    rarity: z
+        .enum(["common", "uncommon", "rare", "mythic"])
+        .optional()
+        .describe("Filter by rarity."),
+    type: z
+        .string()
+        .optional()
+        .describe("Substring match against card type line (e.g. 'Goblin', 'Instant')."),
+    format: z
+        .string()
+        .optional()
+        .describe("Filter to cards with a legality entry in this format (e.g. 'modern', 'commander')."),
+    legality: z
+        .enum(["legal", "banned", "restricted"])
+        .optional()
+        .describe("Used with 'format'. Defaults to 'legal' when format is set."),
+    page: z.number().int().min(1).optional().describe("1-based page index."),
+    limit: z.number().int().min(1).max(100).optional().describe("Page size (max 100)."),
+};
+export async function searchCards(input) {
+    return apiFetch({
+        path: "/api/v1/cards",
+        query: input,
+    });
+}
+export const searchCardsTool = {
+    name: "search_cards",
+    description: "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.",
+    inputSchema: z.object(searchCardsInputSchema),
+    handler: searchCards,
+};
+//# sourceMappingURL=search-cards.js.map

package/dist/tools/search-cards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-cards.js","sourceRoot":"","sources":["../../src/tools/search-cards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6GAA6G,CAAC;IAC1H,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACtF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SAC9C,QAAQ,EAAE;SACV,QAAQ,CAAC,mBAAmB,CAAC;IAChC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oFAAoF,CAAC;IACjG,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACpF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAA8B;IAC9D,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,KAAoD;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,oPAAoP;IACtP,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,OAAO,EAAE,WAAW;CACrB,CAAC"}

package/dist/tools/sets.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+export const searchSetsTool = {
+    name: "search_sets",
+    description: "List Magic: The Gathering sets, optionally paginated. Returns set code, name, release date, type, and aggregate prices.",
+    inputSchema: z.object({
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    }),
+    handler: (input) => apiFetch({ path: "/api/v1/sets", query: input }),
+};
+export const getSetTool = {
+    name: "get_set",
+    description: "Get detail for a single set by code (e.g. 'lea', 'mh3').",
+    inputSchema: z.object({ code: z.string() }),
+    handler: ({ code }) => apiFetch({ path: `/api/v1/sets/${encodeURIComponent(code)}` }),
+};
+export const listSetCardsTool = {
+    name: "list_set_cards",
+    description: "List all cards in a set, paginated. Supports the same filters as search_cards (rarity, type, format, legality).",
+    inputSchema: z.object({
+        code: z.string().describe("Set code."),
+        rarity: z.enum(["common", "uncommon", "rare", "mythic"]).optional(),
+        type: z.string().optional(),
+        format: z.string().optional(),
+        legality: z.enum(["legal", "banned", "restricted"]).optional(),
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    }),
+    handler: ({ code, ...rest }) => apiFetch({
+        path: `/api/v1/sets/${encodeURIComponent(code)}/cards`,
+        query: rest,
+    }),
+};
+export const getSealedProductsTool = {
+    name: "get_sealed_products",
+    description: "List sealed products (booster boxes, bundles, commander decks, etc.) for a set. Each entry includes a TCGPlayer purchase URL.",
+    inputSchema: z.object({ code: z.string() }),
+    handler: ({ code }) => apiFetch({ path: `/api/v1/sets/${encodeURIComponent(code)}/sealed-products` }),
+};
+//# sourceMappingURL=sets.js.map

package/dist/tools/sets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sets.js","sourceRoot":"","sources":["../../src/tools/sets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,yHAAyH;IAC3H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACnD,CAAC;IACF,OAAO,EAAE,CAAC,KAA8B,EAAE,EAAE,CAC1C,QAAQ,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAoD,EAAE,CAAC;CAClG,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,0DAA0D;IACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAoB,EAAE,EAAE,CACtC,QAAQ,CAAC,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;CACjE,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,iHAAiH;IACnH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;QACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACnD,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAA8C,EAAE,EAAE,CACzE,QAAQ,CAAC;QACP,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,QAAQ;QACtD,KAAK,EAAE,IAAmD;KAC3D,CAAC;CACL,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,+HAA+H;IACjI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAoB,EAAE,EAAE,CACtC,QAAQ,CAAC,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;CACjF,CAAC"}

package/dist/tools/transactions.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { apiFetch } from "../api-client.js";
+const transactionCreate = z.object({
+    cardId: z.string().describe("Internal IWMM card UUID."),
+    type: z.enum(["BUY", "SELL"]),
+    quantity: z.number().int().min(1),
+    pricePerUnit: z.number().min(0).describe("Per-unit price in USD."),
+    isFoil: z.boolean(),
+    date: z.string().describe("ISO 8601 date (YYYY-MM-DD)."),
+    source: z.string().optional().describe("Where the transaction happened (e.g. 'TCGPlayer', 'LGS')."),
+    fees: z.number().min(0).optional(),
+    notes: z.string().optional(),
+    skipInventorySync: z
+        .boolean()
+        .optional()
+        .describe("If true, record the transaction without adjusting inventory. Default false - transactions normally update inventory."),
+});
+const transactionUpdate = z.object({
+    quantity: z.number().int().min(1).optional(),
+    pricePerUnit: z.number().min(0).optional(),
+    date: z.string().optional(),
+    source: z.string().optional(),
+    fees: z.number().min(0).optional(),
+    notes: z.string().optional(),
+});
+export const listTransactionsTool = {
+    name: "list_transactions",
+    description: "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.",
+    inputSchema: z.object({
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+        sort: z.string().optional().describe("Sort key (e.g. TX_DATE, TX_TYPE, TX_CARD, TX_PRICE)."),
+        order: z.enum(["asc", "desc"]).optional(),
+        type: z.enum(["BUY", "SELL"]).optional(),
+    }),
+    handler: (input) => apiFetch({
+        path: "/api/v1/transactions",
+        query: input,
+        authenticated: true,
+    }),
+};
+export const recordTransactionTool = {
+    name: "record_transaction",
+    description: "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.",
+    inputSchema: transactionCreate,
+    handler: (input) => apiFetch({ path: "/api/v1/transactions", method: "POST", body: input, authenticated: true }),
+};
+export const updateTransactionTool = {
+    name: "update_transaction",
+    description: "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.",
+    inputSchema: z.object({
+        id: z.number().int().min(1).describe("Transaction ID from list_transactions."),
+        patch: transactionUpdate,
+    }),
+    handler: ({ id, patch }) => apiFetch({ path: `/api/v1/transactions/${id}`, method: "PATCH", body: patch, authenticated: true }),
+};
+export const deleteTransactionTool = {
+    name: "delete_transaction",
+    description: "Delete a transaction by ID. Requires IWMM_API_KEY.",
+    inputSchema: z.object({ id: z.number().int().min(1) }),
+    handler: ({ id }) => apiFetch({ path: `/api/v1/transactions/${id}`, method: "DELETE", authenticated: true }),
+};
+export const getCostBasisTool = {
+    name: "get_cost_basis",
+    description: "Get FIFO cost basis for a specific card+finish for the authenticated user. Pass either cardId or (setCode, setNumber). Requires IWMM_API_KEY.",
+    inputSchema: z
+        .object({
+        cardId: z.string().optional(),
+        setCode: z.string().optional(),
+        setNumber: z.string().optional(),
+        isFoil: z.boolean().default(false),
+    })
+        .refine((v) => !!v.cardId || (!!v.setCode && !!v.setNumber), {
+        message: "Provide either cardId, or both setCode and setNumber.",
+    }),
+    handler: (input) => {
+        const query = { isFoil: input.isFoil };
+        const path = input.cardId
+            ? `/api/v1/transactions/cost-basis/${encodeURIComponent(input.cardId)}`
+            : `/api/v1/transactions/cost-basis/${encodeURIComponent(input.setCode)}/${encodeURIComponent(input.setNumber)}`;
+        return apiFetch({ path, query, authenticated: true });
+    },
+};
+//# sourceMappingURL=transactions.js.map

package/dist/tools/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/tools/transactions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "iwantmymtg-mcp",
+  "version": "0.0.1",
+  "description": "MCP server for I Want My MTG - query cards/sets and manage your collection from Claude Desktop, Claude Code, Cursor, and other MCP clients.",
+  "type": "module",
+  "bin": {
+    "iwantmymtg-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "node --test --import tsx test/*.test.ts",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "magic-the-gathering",
+    "mtg",
+    "claude"
+  ],
+  "author": "matthewdtowles",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/matthewdtowles/iwantmymtg-mcp.git"
+  },
+  "homepage": "https://iwantmymtg.net",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0"
+  }
+}