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., "@Azgaarnoth MCP Serversearch for fire spells available to wizards"
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.
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 installUsage
Run the MCP server
pnpm mcpAdd to Claude Desktop
Command Line:
claude mcp add azgaarnoth -- pnpm --dir ~/path/to/azgaarnoth-mcp mcpAvailable Tools
Tool | Description |
| Full-text search across all Azgaarnoth content |
| Retrieve a specific document by path or name |
| List all items in a category (races, classes, nations, etc.) |
| Get D&D creature stat blocks |
| Get spell information |
| Find related documents via links/backlinks |
| Get nation/city info with political relations |
| Check index statistics |
Categories
races- Playable races and subracesclasses- Character classes and subclassesfeats- Character featsnations- Political entitiesgeography- Geographical regionscities- Major citiesorganizations- Mage schools, mercenary companies, guildscreatures- Monsters with stat blocksmagic- Spells, items, runes, tattoospeople- Named NPCsreligions- Pantheons and faithshistory- Timeline and historical eventsconditions- Game conditionscultures- Cultural backgroundsequipment- Armor, weapons, tools
Configuration
The repository path is configured in src/mcp/server.ts:
const REPO_PATH = '~/path/to/Azgaarnoth'This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.