About dnd-oracle
dnd-oracle is an MCP server for D&D 5e players and game masters, offering search and analysis over bundled SQLite SRD data without internet access.
Key features
- 01Search monsters, spells, and equipment
- 02Browse classes, races, and rules
- 03Build encounters by difficulty budget
- 04Analyze characters, parties, and gear
- 05Calculate damage, rests, and travel
Use cases
- 01Find monsters or spells by criteria
- 02Plan combat encounters within an XP budget
- 03Build character data and review party composition
- 04Schedule an adventuring day and travel time
MCP support
The MCP server exposes SRD search, character and party analysis, encounter building, and other rules-calculation tools to clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEdnd-oracle
D&D 5e SRD MCP server — monster search, spell lookup, encounter building, and character tools powered by ground-truth SRD data.
What It Does
Search, browse, and analyze D&D 5e System Reference Document content — no internet required, no hallucination risk. All 20 tools operate on ground-truth SRD data bundled as a SQLite database.
1,207 entities: 334 monsters, 319 spells, 237 equipment items, 239 magic items, 12 classes, 9 races, 15 conditions, 33 rule sections, 9 rollable tables.
Tools
Reference (6)
| Tool | Description |
|---|---|
search_monsters | Full-text search with CR, type, size, alignment filters. Returns full stat blocks. |
search_spells | Search by level, school, class, concentration, ritual, damage type, save type. |
search_equipment | Search weapons, armor, gear, and magic items. Filter by properties, rarity. |
browse_classes | View class features at any level. Multiclass feature combination calculator. |
browse_races | View race traits, ability bonuses, subraces. |
search_rules | Search rules text and condition references. |
Analytical (14)
| Tool | Description |
|---|---|
build_encounter | Calculate XP budgets by difficulty. Suggests monster combinations within budget. |
suggest_encounter | Tactically interesting encounters with monster role inference and synergy notes. |
plan_spells | Available spells for class/level. Slot tracking, concentration flags, ritual highlights, component costs. |
compare_monsters | Side-by-side stat comparison of 2-3 monsters. |
check_resistances | Consolidated resistance/immunity matrix for a group of monsters. Party damage gap warnings. |
analyze_loadout | Total weight, cost, AC breakdown, encumbrance status from equipment list. |
magic_item_attunement | Attunement slot analysis with over-limit warnings and restriction checks. |
build_character | Full character sheet from race + class + level + ability scores. HP, saves, DC, features. |
analyze_party | Party composition audit: saving throw coverage, role balance, darkvision, languages. |
simulate_damage | Average DPR calculator with hit probability, crit math, AC sensitivity, turns-to-kill. |
rest_calculator | What recovers on short vs. long rest for any class at any level. |
travel_calculator | Overland travel time with pace, terrain, mounts, and forced march rules. |
plan_adventuring_day | Daily XP budget, encounter sequencing, resource pacing, rest placement. |
roll_table | Roll on SRD random tables: madness, poisons, diseases, Acolyte personality traits. |
Install
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"dnd-oracle": {
"command": "npx",
"args": ["-y", "dnd-oracle"]
}
}
}
Claude Code
claude mcp add dnd-oracle -- npx -y dnd-oracle
Data Source
This product includes material from the System Reference Document 5.1, Copyright 2016, Wizards of the Coast, Inc. Licensed under CC-BY-4.0.
Data sourced from 5e-bits/5e-database.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.