Azgaarnoth MCP Server

An MCP (Model Context Protocol) server that provides AI assistants with tools to query the Azgaarnoth D&D world repository (~4,200 markdown files).

Installation

pnpm install

Usage

Run the MCP server

pnpm mcp

Add to Claude Desktop

Command Line:

claude mcp add azgaarnoth -- pnpm --dir ~/path/to/azgaarnoth-mcp mcp

Available Tools

Tool	Description
search_world	Full-text search across all Azgaarnoth content
get_document	Retrieve a specific document by path or name
browse_category	List all items in a category (races, classes, nations, etc.)
get_stat_block	Get D&D creature stat blocks
get_spell	Get spell information
get_related	Find related documents via links/backlinks
explore_region	Get nation/city info with political relations
index_status	Check index statistics

Categories

• races - Playable races and subraces
• classes - Character classes and subclasses
• feats - Character feats
• nations - Political entities
• geography - Geographical regions
• cities - Major cities
• organizations - Mage schools, mercenary companies, guilds
• creatures - Monsters with stat blocks
• magic - Spells, items, runes, tattoos
• people - Named NPCs
• religions - Pantheons and faiths
• history - Timeline and historical events
• conditions - Game conditions
• cultures - Cultural backgrounds
• equipment - Armor, weapons, tools

Configuration

The repository path is configured in src/mcp/server.ts:

const REPO_PATH = '~/path/to/Azgaarnoth'