World Anvil

Provides an MCP server that connects to World Anvil API for AI-assisted worldbuilding, campaign tools, and content management.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "datagen24-world-anvil-mcp": {
      "command": "world-anvil-mcp",
      "args": [],
      "env": {
        "WORLD_ANVIL_APP_KEY": "your_application_key_here",
        "WORLD_ANVIL_USER_TOKEN": "your_user_token_here"
      }
    }
  }
}

You run a Model Context Protocol (MCP) server that connects Claude Code with World Anvil to streamline D&D worldbuilding. This server exposes structured tools and prompts so you can manage content, visualize maps, organize campaigns, generate NPCs and locations, track quests, and keep notes—all from your MCP client.

How to use

Connect your MCP client to the World Anvil MCP Server to access worldbuilding tools through a consistent, scriptable interface. You can run the server locally and point your client at the local endpoint, then use the provided tools to manage articles, maps, campaigns, NPCs, locations, and notes.

Key capabilities you can leverage include content management, interactive maps, campaign tools for RPG planning, D&D assistance for NPCs and locations, and a notebook system for organized documentation.

{
  "mcpServers": {
    "world-anvil": {
      "command": "world-anvil-mcp"
    }
  }
}

How to install

Prerequisites you need before installing the MCP server are Python 3.11 or newer, the uv tool, a World Anvil account with Grandmaster guild membership, a World Anvil API application key, and a World Anvil user authentication token.

Clone and enter the project directory, then set up a local Python environment using uv and install dependencies.

# Clone repository and enter it
cd world-anvil

# Recommended: create a local virtualenv with uv
uv venv --python 3.11 .venv

# Activate the environment
# macOS/Linux
source .venv/bin/activate
# Windows (PowerShell)
.venv\\Scripts\Activate.ps1

# Install dependencies (dev extras optional)
uv pip install -e .[dev]

# Tip: you can also run without activating via uv
uv run world-anvil-mcp

If you prefer not to use uv, you can set up a traditional Python virtual environment and install the package manually.

python -m venv .venv
source .venv/bin/activate    # Windows: .venv\\Scripts\Activate.ps1
pip install -e .[dev]

Configuration and usage notes

Create a configuration file to provide your World Anvil credentials to the MCP server.

WORLD_ANVIL_APP_KEY=your_application_key_here
WORLD_ANVIL_USER_TOKEN=your_user_token_here

Running the server

Start the MCP server using the standard IO transport.

# Start MCP server with stdio transport
world-anvil-mcp

# Or run directly with Python
python -m world_anvil_mcp.server

With Claude Code

Configure your MCP settings to point to the World Anvil MCP server so Claude Code can access the tools.

{
  "mcpServers": {
    "world-anvil": {
      "command": "world-anvil-mcp"
    }
  }
}