mcpField
D
dnd-oracle

dnd-oracle

Local
github.com/gregarioGames & Entertainment8Updated 6w ago

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

  1. 01Search monsters, spells, and equipment
  2. 02Browse classes, races, and rules
  3. 03Build encounters by difficulty budget
  4. 04Analyze characters, parties, and gear
  5. 05Calculate damage, rests, and travel

Use cases

  1. 01Find monsters or spells by criteria
  2. 02Plan combat encounters within an XP budget
  3. 03Build character data and review party composition
  4. 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.

mcp.json · Universal config
{
"mcpServers": {
"gregario-dnd-oracle": {
"command": "npx",
"args": [
"-y",
"dnd-oracle"
]
}
}
}
Run commandnpx -y dnd-oracle

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmdnd-oracle0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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 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)
ToolDescription
search_monstersFull-text search with CR, type, size, alignment filters. Returns full stat blocks.
search_spellsSearch by level, school, class, concentration, ritual, damage type, save type.
search_equipmentSearch weapons, armor, gear, and magic items. Filter by properties, rarity.
browse_classesView class features at any level. Multiclass feature combination calculator.
browse_racesView race traits, ability bonuses, subraces.
search_rulesSearch rules text and condition references.
Analytical (14)
ToolDescription
build_encounterCalculate XP budgets by difficulty. Suggests monster combinations within budget.
suggest_encounterTactically interesting encounters with monster role inference and synergy notes.
plan_spellsAvailable spells for class/level. Slot tracking, concentration flags, ritual highlights, component costs.
compare_monstersSide-by-side stat comparison of 2-3 monsters.
check_resistancesConsolidated resistance/immunity matrix for a group of monsters. Party damage gap warnings.
analyze_loadoutTotal weight, cost, AC breakdown, encumbrance status from equipment list.
magic_item_attunementAttunement slot analysis with over-limit warnings and restriction checks.
build_characterFull character sheet from race + class + level + ability scores. HP, saves, DC, features.
analyze_partyParty composition audit: saving throw coverage, role balance, darkvision, languages.
simulate_damageAverage DPR calculator with hit probability, crit math, AC sensitivity, turns-to-kill.
rest_calculatorWhat recovers on short vs. long rest for any class at any level.
travel_calculatorOverland travel time with pace, terrain, mounts, and forced march rules.
plan_adventuring_dayDaily XP budget, encounter sequencing, resource pacing, rest placement.
roll_tableRoll 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

Markdown supported

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.