Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use MTG API with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Magic: The Gathering as an MCP: search 30+ years of cards across 500+ sets by name/color/CMC/type, browse sets, resolve Gatherer ids, check types. and open vir

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 7 capabilities

The complete MTG API capability set.

These are the exact actions your AI can choose when you ask it to work with MTG API.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 7 available through MTG API.

  1. 01

    Get card by multiverseid

    Every Gatherer card URL maps to a multiverseid. Get one MTG card by its official multiverseid (the canonical Gatherer id)

  2. 02

    Find format staples

    Find the most iconic printings of a card across all sets (reprints and price-light alternatives)

  3. 03

    Search cards

    Colors use single letters U/W/B/R/G (e.g. "U" for blue; "blue" also works but only matches some printings). Pagination via page/page_size with the total returned in the response. Example combos: name=bolt; colors=U cmc=5; set=LEA. Search Magic: The Gathering cards by name, color, mana cost, type or set (all 500+ sets)

  4. 04

    List sets

    Paginated. sorted alphabetically by code, so use the name filter mentally or browse pages. List Magic sets: 500+ expansions from Alpha (1993) to today, with codes and release dates

Capability set02 / 02

05-07

3 capabilities in this set.

Part of 7 available through MTG API.

  1. 05

    Get set details

    Use codes from list_sets (e.g. "LEA" = Limited Edition Alpha). Get full details of one Magic set by code (Alpha, Modern Horizons...)

  2. 06

    Open booster pack

    Pure nostalgia dopamine: "open an Alpha pack for me". Works best with classic sets (LEA, 2ED, MMQ, ZEN...). Open a virtual Magic booster pack: 15 random cards from any set (fun gacha simulator)

  3. 07

    List card types

    Includes newer types like Battle and Conspiracy. List all Magic card types (Creature, Instant, Battle, Planeswalker...)

One connector, every AI

MTG API works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put MTG API to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 7 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of MTG API, so you can see the experience inside your AI.

It does not authenticate your account with MTG API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

MTG API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_pHnhpRVg0DMUh7h9j1PPH9eDqolIKUNMYaEmI0k9/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — MTG API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "magic-the-gathering-cards-sets-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_pHnhpRVg0DMUh7h9j1PPH9eDqolIKUNMYaEmI0k9/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? link.label

See all the AI clients this connector works with ↑

FAQ

Questions MTG API owners ask.

  • 01

    Do I need an API key or registration?

    No. api.magicthegathering.io is fully public with a generous rate limit (1000 requests/hour). all capabilities work without authentication.

  • 02

    How do colors work in searches?

    Use single letters: U (blue), W (white), B (black), R (red), G (green). "colors=U&cmc=5" is the reliable form; spelling "blue" only matches a subset of printings. Set codes are three-to-four letters (LEA = Alpha).

Explore

More in Data Analytics

Suggestions