English Français العربية

io.github.gregario/dnd-oracle

Official registry Search and web

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package dnd-oracle
Claude Code 
claude mcp add dnd-oracle -- npx -y dnd-oracle@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dnd-oracle": {
            "command": "npx",
            "args": [
                "-y",
                "dnd-oracle@0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. dnd-oracle
  2. What It Does
  3. Tools
  4. Install
  5. Data Source
  6. License

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

Frequently asked questions

What is io.github.gregario/dnd-oracle?

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

How do I install io.github.gregario/dnd-oracle?

It runs on your machine. In Claude Code: claude mcp add dnd-oracle -- npx -y dnd-oracle@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.gregario/dnd-oracle need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.gregario/dnd-oracle open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.gregario/dnd-oracle?

It is published by gregario. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.