Skip to content

gregario/dnd-oracle

Repository files navigation

dnd-oracle

D&D 5e SRD MCP server — monster search, spell lookup, encounter building, and character tools powered by ground-truth SRD data.

npm version npm downloads Node.js 18+ MCP Compatible MIT License Sponsor dnd-oracle MCP server

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

About

D&D 5e SRD MCP server — monster search, spell lookup, encounter building, and character tools powered by ground-truth SRD data

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors