D&D Oracle MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add dnd-oracle -- npx -y dnd-oracle
README.md

D&D 5e SRD MCP server for monster search, spell lookup, and encounter building

dnd-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 10 tools operate on ground-truth SRD data bundled as a SQLite database.

1,198 entities: 334 monsters, 319 spells, 237 equipment items, 239 magic items, 12 classes, 9 races, 15 conditions, 33 rule sections.

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 (4)

Tool Description
build_encounter Calculate XP budgets by difficulty. Suggests monster combinations within budget.
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.
analyze_loadout Total weight, cost, AC breakdown, encumbrance status from equipment list.

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

Tools (10)

search_monstersFull-text search with CR, type, size, alignment filters returning full stat blocks.
search_spellsSearch by level, school, class, concentration, ritual, damage type, and save type.
search_equipmentSearch weapons, armor, gear, and magic items filtered by properties or rarity.
browse_classesView class features at any level and calculate multiclass feature combinations.
browse_racesView race traits, ability bonuses, and subraces.
search_rulesSearch rules text and condition references.
build_encounterCalculate XP budgets by difficulty and suggest monster combinations.
plan_spellsCheck available spells for class/level with slot tracking and component costs.
compare_monstersSide-by-side stat comparison of 2-3 monsters.
analyze_loadoutCalculate total weight, cost, AC breakdown, and encumbrance status from equipment list.

Configuration

claude_desktop_config.json
{"mcpServers": {"dnd-oracle": {"command": "npx", "args": ["-y", "dnd-oracle"]}}}

Try it

Find a CR 5 monster that is undead and medium-sized.
Build an encounter for a party of four level 3 players that is considered 'hard' difficulty.
What are the class features for a level 5 Wizard?
Compare the stats of a Goblin and a Kobold side-by-side.
List all level 1 evocation spells available to a Sorcerer.

Frequently Asked Questions

What are the key features of D&D Oracle?

Offline access to 1,198 D&D 5e SRD entities. Full-text search for monsters, spells, and equipment. Encounter building with XP budget calculations. Character loadout analysis for weight and AC. Multiclass feature combination calculator.

What can I use D&D Oracle for?

Dungeon Masters planning combat encounters during game sessions. Players looking up spell details or class features quickly. Character builders calculating equipment weight and encumbrance. Comparing monster stat blocks for balanced homebrew encounters.

How do I install D&D Oracle?

Install D&D Oracle by running: npx -y dnd-oracle

What MCP clients work with D&D Oracle?

D&D Oracle works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep D&D Oracle docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare