convez.ai
MCP ServerIntegração & APIsIntermediário
matthewdtowles

I Want My MTG MCP Server

matthewdtowles/iwantmymtg-mcp

Gerenciador de coleção MTG via IA conversacional

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a plataforma I Want My MTG ao Claude e outras ferramentas de IA. Permite buscar cartas Magic: The Gathering, gerenciar coleções, rastrear transações e analisar portfólio de forma conversacional. Suporta consultas anônimas (preços, histórico) e autenticadas (inventário, ganhos realizados, recomendações de venda).

Instalação

$npx convez-ai matthewdtowles/iwantmymtg-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 3 dias
Versão
0.8.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Buscar cartas MTG e comparar preços entre vendors
  • Rastrear portfólio de cartas e analisar ganhos/perdas
  • Gerenciar inventário e buy-list automaticamente
  • Consultar histórico de preços e alertas de valor

Veredito

Integração especializada e bem documentada para colecionadores MTG que usam Claude. A arquitetura MCP é limpa e o suporte multiplataforma (Claude Desktop, Cursor, Claude Code) funciona conforme esperado. Ferramenta nicho mas executada com solidez.

README

A tradução para o português deste README ainda está na fila.

iwantmymtg-mcp

npm version License: MIT smithery badge

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, 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; view portfolio summaries, history, performance, cash flow, realized gains, and breakdowns; 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.

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 varDefaultPurpose
IWMM_API_KEY(unset)Personal API key. Required only for authenticated tools.
IWMM_BASE_URLhttps://iwantmymtg.netOverride 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.

Ver o original no GitHub

Bom para

Relacionados