Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"mtg-oracle": {
"args": [
"-y",
"mtg-oracle"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Magic: The Gathering MCP server. Card search, rules lookup, deck analysis, and Commander intelligence.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'mtg-oracle' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked mtg-oracle against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in entertainment
The official MCP Server for the Mux API
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, animation, MPPM multiplayer & more. Free & open source by AnkleBreaker Studio.
A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.
MCP Security Weekly
Get CVE alerts and security updates for io.github.gregario/mtg-oracle and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Magic: The Gathering MCP server. Card search, rules lookup, deck analysis, and Commander intelligence.
Provides 14 tools for AI assistants to answer questions about Magic cards, game rules, combos, synergies, and format meta via the Model Context Protocol.
Not just another Scryfall wrapper. mtg-oracle downloads card data, comprehensive rules, and combo databases locally into SQLite for fast offline queries, and ships with curated MTG knowledge (archetypes, format primers, commander strategies, mana base guidelines) that makes LLMs genuinely competent at Magic.
npm install -g mtg-oracle
Or run directly with npx:
npx mtg-oracle
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"mtg-oracle": {
"command": "npx",
"args": ["-y", "mtg-oracle"]
}
}
}
Or if installed globally:
{
"mcpServers": {
"mtg-oracle": {
"command": "mtg-oracle"
}
}
}
claude mcp add mtg-oracle -- npx -y mtg-oracle
On first run, mtg-oracle downloads card data from Scryfall and rules data from Academy Ruins. Data is stored in ~/.mtg-oracle/ and updated automatically on subsequent runs. No card data is bundled in the npm package.
| Tool | Description |
|---|---|
search_cards | Search cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text. |
get_card | Get complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching. |
get_rulings | Get official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications). |
check_legality | Check format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more. |
search_by_mechanic | Find cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition. |
get_prices | Look up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall. |
| Tool | Description |
|---|---|
analyze_deck | Analyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check. |
| Tool | Description |
|---|---|
lookup_rule | Look up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context. |
get_glossary | Look up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.). |
get_keyword | Get the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.). |
| Tool | Description |
|---|---|
analyze_commander | Analyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding. |
| `find_combo |