How do I search for cards by color?

You can use single letter codes in your prompt, such as U for blue, W for white, B for black, R for red, or G for green.

Does this include modern Magic sets?

Yes, the database includes over 500 sets ranging from the original Alpha release in 1993 to the most recent expansions.

Can I use this to find specific card rulings?

Yes, by using the multiverseid capability, your agent can retrieve the exact rules text and official data for a card.

Is there a way to simulate opening packs?

Yes, the open_booster_pack capability allows you to simulate opening a 15-card pack from any set in the database.

Which AI clients can use this MCP?

This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.

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.

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).

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Magic The Gathering Cards Sets to ChatGPT and Claude

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Bring the entire MTG multiverse to your AI client.

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.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 7 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 7 available through MTG API.

01
Get card by multiverseid
This capability retrieves a specific MTG card using its official Gatherer multiverseid. It provides the exact rules text, power, toughness, and artist details for that specific printing.
02
Find format staples
This capability identifies the most iconic printings of a card. It helps you find the versions most commonly used in competitive play or more affordable alternatives.
03
Search cards
This capability searches the entire card database using filters like name, color, mana cost, type, or set. You can use single letter color codes like U for blue or R for red to narrow down results.
04
List sets
This capability provides a paginated list of over 500 Magic expansions. It includes set codes and release dates dating back to 1993.

Capability set02 / 02

05-07

3 capabilities in this set.

Part of 7 available through MTG API.

05
Get set details
This capability pulls full information for a specific Magic set using its unique code. You can use codes like LEA for Alpha to get deep details on a specific expansion.
06
Open booster pack
This capability acts as a virtual gacha simulator. It lets you open a pack containing 15 random cards from any chosen set for a hit of nostalgia.
07
List card types
This capability returns a list of all valid Magic card types. It includes everything from standard Creatures and Instants to newer types like Battles and Conspiracies.

Real work

What teams actually run

Deck Optimization

Ask your agent to find all blue creatures with a mana cost of 3 or less to fill out a specific deck archetype.

Collection Research

Use the capability to see every set a specific card has been printed in to check for rare versions.

Automated Quiz Generation

Have your AI client pull random card types or set details to create trivia for a community.

Nostalgia Simulation

Trigger a virtual pack opening from a classic set like Zendikar to see what you get.

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.

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.

Observed, not estimated

872ms average. Fast in production.

MTG API is checked daily against the live service.

Daily averagePeak 1097ms

Oct 3Today

Fastest day: 727ms
Slowest day: 1097ms
14-day trend: Slowing+7%

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.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
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? Set up MTG API in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work MTG API owners hand off.

This MCP is built for anyone who needs authoritative, real-time Magic: The Gathering data within an AI workflow.

01
Deck Builders
They use the AI to find specific card synergies and mana cost requirements.
02
Collectors
They use the capability to track printing histories and set details.
03
Content Creators
They hand off data retrieval tasks to the AI to build quizzes or research card history.

FAQ

Questions MTG API owners ask.

01
How do I search for cards by color?
You can use single letter codes in your prompt, such as U for blue, W for white, B for black, R for red, or G for green.
02
Does this include modern Magic sets?
Yes, the database includes over 500 sets ranging from the original Alpha release in 1993 to the most recent expansions.
03
Can I use this to find specific card rulings?
Yes, by using the multiverseid capability, your agent can retrieve the exact rules text and official data for a card.
04
Is there a way to simulate opening packs?
Yes, the open_booster_pack capability allows you to simulate opening a 15-card pack from any set in the database.
05
Which AI clients can use this MCP?
This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.
06
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.
07
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

Connect MTG API to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get card by multiverseid

Find format staples

Search cards

List sets

05-07

Get set details

Open booster pack

List card types

What teams actually run

Deck Optimization

Collection Research

Automated Quiz Generation

Nostalgia Simulation

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

MTG API Connector

Claude Desktop

Deck Builders

Collectors

Content Creators

How do I search for cards by color?

Does this include modern Magic sets?

Can I use this to find specific card rulings?

Is there a way to simulate opening packs?

Which AI clients can use this MCP?

Do I need an API key or registration?

How do colors work in searches?

RAWG Video Games Database AI Connector

Scryfall AI Connector

IGDB Global Gaming Database AI Connector

BoardGameGeek AI Connector

Suggestions

Card Collection Counter AI Connector

GamerPower Gaming Giveaways AI Connector

Pokemon TCG AI Connector

itch.io AI Connector