home / mcp / magic: the gathering mcp tool server

Magic: The Gathering MCP Tool Server

Provides fast access to MTG card data, rulings, sets, and images through an MCP server.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "james2037-mcp-gatherer": {
      "command": "php",
      "args": [
        "path/to/mcp_server.php"
      ]
    }
  }
}

You can run a dedicated MCP server that gives you fast access to Magic: The Gathering card data, rulings, and set information. This server lets your MCP client query cards by name, color, type, or other criteria and view card details, rulings, foreign language versions, comprehensive rules, and card images when available.

How to use

Start the server locally and connect your MCP client to it. You will use a local stdio connection via your PHP runtime, which lets the client send requests to the server and receive MTG data, rulings, and set information. Use the client to search for cards, view card details, browse sets, and access the Comprehensive Rules as needed.

Typical usage patterns include starting the server once on your machine and then keeping it running while you perform searches, card lookups, and set explorations from your MCP client. If you need to run multiple MCP servers for testing, use separate configurations for each server and ensure ports or stdio transports do not conflict.

How to install

Prerequisites you need before installing are PHP 8.1 or higher and Composer, PHP’s dependency manager.

Check your PHP version to ensure it meets the minimum requirement.

php --version

Install Composer to manage PHP dependencies.

# Follow the installation instructions from getcomposer.org
php -v
composer --version

Clone the project repository to your local machine, navigate into the project directory, and install dependencies.

git clone https://github.com/james2037/mcp-gatherer.git
cd mcp-gatherer
composer install

Start the MCP server using PHP. This runs the server so your MCP client can communicate with it via STDIO.

php path/to/mcp_server.php

Example configuration for a Windows client to connect to the local server using the STDIO transport.

{
  "mcpServers": {
    "mcp_gatherer": {
      "command": "php",
      "args": ["C:\\mcp-gatherer\\mcp_server.php"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Available tools

search_cards

Search MTG cards by name, color, type, and other criteria to locate cards quickly.

card_details

Retrieve detailed information for a specific card, including rulings and foreign language versions.

rulings

Access individual card rulings and rule references to understand interactions and edge cases.

comprehensive_rules

Browse the full Magic: The Gathering Comprehensive Rules through the MCP interface.

set_browse

Explore set information and related card listings to navigate card collections.

card_images

View available card images to help with quick identification and verification.