Magic: The Gathering

by james2037

Not rated
GitHub

About

Integrates Magic: The Gathering data sources to provide unified access for card searches, rules lookup, and set information retrieval.

Details

Author
james2037
Repository
james2037/mcp-gatherer
License
MIT License
Categories
Productivity, Developer Tools, Design, AI, Search, Frontend, Infrastructure, API, Project Management

- Search for Magic cards by name, color, type, and other criteria
- View detailed card information including rulings and foreign language versions
- Access the Magic: The Gathering Comprehensive Rules
- Browse set information and card listings
- View card images (where available)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Magic: The Gathering
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. PHP 8.1 or higher
- Check your version by running: php --version
- If needed, download from php.net

2. Composer (PHP's dependency manager)
- Download from getcomposer.org

1. Clone this repository:

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

2. Navigate to the project directory:

   cd mcp-gatherer

3. Install dependencies:

   composer install

Your MCP client, such as Claude Desktop, can start the server by invoking:

php path/to/mcp_server.php

The server will start and you can begin using the Magic: The Gathering tools through the MCP client. Be sure to specify the STDIO transport if necessary.

An example claude_desktop_config.json for a Windows user might look like:

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "magic: the gathering": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Magic: The Gathering MCP Tool Server

A Model Context Protocol server for accessing Magic: The Gathering card data, rules, and set information. This server provides quick access to card details, rulings, comprehensive rules sections, and more.

Features

- Search for Magic cards by name, color, type, and other criteria
- View detailed card information including rulings and foreign language versions
- Access the Magic: The Gathering Comprehensive Rules
- Browse set information and card listings
- View card images (where available)

Installation Requirements

1. PHP 8.1 or higher
- Check your version by running: php --version
- If needed, download from php.net

2. Composer (PHP's dependency manager)
- Download from getcomposer.org

Setup Instructions

1. Clone this repository:

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

2. Navigate to the project directory:

   cd mcp-gatherer

3. Install dependencies:

   composer install

Running the Server

Your MCP client, such as Claude Desktop, can start the server by invoking:

php path/to/mcp_server.php

The server will start and you can begin using the Magic: The Gathering tools through the MCP client. Be sure to specify the STDIO transport if necessary.

An example claude_desktop_config.json for a Windows user might look like:

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

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

If you'd like to contribute to the development of this tool, feel free to submit issues or pull requests. For major changes, please open an issue first to discuss what you would like to change.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.