Click on "Deploy 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 Server Create 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.
MCP (Model Context Protocol) server for interfacing with World Anvil API to assist with D&D world development.
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.
Related MCP server: DMCP
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
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
# 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-mcpWithout uv:
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\Activate.ps1
pip install -e .[dev]Create a .env file:
WORLD_ANVIL_APP_KEY=your_application_key_here
WORLD_ANVIL_USER_TOKEN=your_user_token_here# Start MCP server with stdio transport
world-anvil-mcp
# Or run directly with Python
python -m world_anvil_mcp.serverAdd to your MCP settings:
{
"mcpServers": {
"world-anvil": {
"command": "world-anvil-mcp"
}
}
}Design Specification - Complete architecture and design
API Reference - Tool and resource documentation
Usage Examples - Common workflows
🚧 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.md for detailed phase tracking and milestones.
BSD 3-Clause License — See LICENSE file for details
Check World Anvil API connection status.
Returns:
Dictionary with API status information
Inputs: no named parameters. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'get_api_status' has a clear, singular purpose of checking API connection status, so an agent cannot misselect between non-existent alternatives.
A single tool inherently has perfect naming consistency since there is nothing to compare it against. The tool name 'get_api_status' follows a clear verb_noun pattern, which would be consistent if more tools were added.
A single tool is too few for a server named 'World Anvil MCP Server', which suggests a broader domain like world-building or content management. This minimal toolset severely limits functionality and does not match the implied scope, making it inappropriate for typical agent workflows.
The tool surface is severely incomplete for the apparent domain. With only an API status check, there are obvious gaps in core operations such as creating, reading, updating, or deleting world-building content (e.g., articles, characters, timelines). This will cause agent failures as basic CRUD/lifecycle coverage is entirely missing.
Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
Manage your tabletop RPG campaign from any MCP client: worlds, sessions, quests, lore, recaps.
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Remote MCP server for D&D: read and update your CharGen campaigns, generate NPCs and art.
