Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@World Anvil MCP ServerCreate a new NPC profile for a dwarf blacksmith named Thrain."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
World Anvil MCP Server
MCP (Model Context Protocol) server for interfacing with World Anvil API to assist with D&D world development.
Overview
This MCP server bridges Claude Code with the World Anvil platform, enabling AI-assisted worldbuilding through structured tools, resources, and prompts. Designed specifically for D&D campaign management and creative writing.
Features
Content Management: Articles, blocks, categories, manuscripts
Map Integration: Interactive maps with markers and layers
Campaign Tools: RPG systems, timelines, session notes
D&D Assistance: NPC generation, location design, quest tracking
Notebook System: Organized notes and documentation
Prerequisites
Python 3.11+
uv (fast Python package manager) ā https://docs.astral.sh/uv/
World Anvil account with Grandmaster guild membership
World Anvil API application key
World Anvil user authentication token
Installation
Without uv:
Configuration
Create a .env file:
Usage
Running the Server
With Claude Code
Add to your MCP settings:
Documentation
Design Specification - Complete architecture and design
API Reference - Tool and resource documentation
Usage Examples - Common workflows
Project Status
š§ In Development ā Phase 0.4 (Early Implementation)
Architecture and specifications drafted; initial server scaffolding in place.
Quality gates configured (ruff, mypy, pytest); tests being added.
See
docs/PHASE_0_STATUS.mdfor detailed phase tracking and milestones.
License
BSD 3-Clause License ā See LICENSE file for details