io.github.gregario/dnd-oracle

Official

by gregario · TypeScript

D&D 5e SRD MCP server with monster, spell, equipment search and encounter building tools

D&D 5e reference with searchable monsters, spells, equipment, and encounter building tools.

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 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:

json

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

Claude Code

bash

claude mcp add dnd-oracle -- npx -y dnd-oracle

Data Source

Data sourced from 5e-bits/5e-database.

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "dnd-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "dnd-oracle@0.1.0"
      ]
    }
  }
}