benjadrejer/MTG_MCP

3.2

If you are the rightful owner of MTG_MCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

A Model Context Protocol (MCP) server designed to interact with the Magic the Gathering API, offering various tools for card and set information retrieval.

Tools

5

Resources

0

Prompts

0

MTG MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with the Magic the Gathering API.

Features

Search for MTG cards by name with partial matching
Filter cards by various attributes (color, type, mana cost, etc.)
Retrieve detailed card information
Get information about MTG sets
Discover random cards

Installation

Development Setup

Create and activate a virtual environment:

python -m venv mtg-mcp-env
source mtg-mcp-env/bin/activate  # On Windows: mtg-mcp-env\Scripts\activate

Install the package in development mode:

pip install -e ".[dev]"

Usage

As an MCP Server

The server can be used with any MCP-compatible client. Add the following to your MCP client configuration:

{
  "mcpServers": {
    "mtg-mcp-server": {
      "command": "mtg-mcp-server",
      "args": []
    }
  }
}

Available Tools

search_cards: Search for cards by name
get_card_details: Get detailed information for a specific card
filter_cards: Filter cards by attributes
get_sets: Retrieve MTG set information
get_random_cards: Get random cards for discovery

Development

Running Tests

pytest

Code Formatting

black mtg_mcp_server tests
isort mtg_mcp_server tests

Type Checking

mypy mtg_mcp_server

License

MIT License