D&D Knowledge Navigator

You can connect Claude and other AI assistants to D&D 5e data through an MCP server built with a Python backend. This server acts as a structured bridge, allowing AI agents to query spells, monsters, equipment, classes, races, and more, while benefiting from caching, formatting templates, and clear source attribution.

How to use

You interact with the MCP server using an MCP client. The server exposes tools that let the AI fetch and verify D&D data, check API health, and confirm statements against official data. When you ask questions like “What are the effects of fireball at 3rd level?” or “Show me a dragon’s stat block,” the AI can route the query through the MCP bridge to retrieve structured results, formatted for readability and with explicit sources.

How to install

Prerequisites are Python 3.10 or higher, the uv package manager, and a Claude Desktop client if you intend to use Claude.

Step 1: Clone the project repo and navigate into it.

git clone https://github.com/yourusername/dnd-knowledge-navigator.git
cd dnd-knowledge-navigator

Step 2: Install dependencies. You have two options.

uv pip install -r requirements.txt

Or install in editable mode if you prefer development setup.

pip install .

Step 3: Optional Claude Desktop configuration. Create a Claude Desktop config file and add the MCP server entry to enable integration with Claude.

{
  "mcpServers": {
    "dnd": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/dnd-knowledge-navigator",
        "run",
        "dnd_mcp_server.py"
      ]
    }
  }
}

Step 4: Start the MCP server. Use the following command to run the server with the uv package manager.

uv run python dnd_mcp_server.py

Additional content

Configuration and runtime behavior are designed to be straightforward. The server includes a source attribution system, a template system for presenting monsters, spells, and equipment, and a query enhancement layer that handles D&D terminology, notation, and common misspellings. You can adjust prompt templates and resource endpoints to tailor responses to your needs. The server also caches API responses locally to improve performance and reduce external calls.

Utilities provided by the MCP bridge include checking the D&D 5e API health and verifying statements against official data. You can rely on these tools to ensure data accuracy during conversations with the AI.

Available tools

search_all_categories

Search across all D&D resources for specific terms to locate relevant data quickly.

verify_with_api

Validate D&D statements against official API data to ensure accuracy.

check_api_health

Check the health and status of the D&D 5e API to monitor reliability.