# gregario/dnd-oracle [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/gregario/dnd-oracle  
**GitHub Stars:** 5  
**npm Downloads (last month):** 264  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gregario-dnd-oracle

## Description
D&D 5e SRD reference and analysis with monster search, spell lookup, encounter building, and loadout analysis. 10 tools, 1198 entities embedded.

## Tools
Capabilities this server exposes over MCP:

- **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.
- **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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What gregario/dnd-oracle MCP server does

The gregario/dnd-oracle MCP server provides MCP tools for querying and analyzing Dungeons & Dragons 5e System Reference Document content. Its reference functions cover monsters, spells, equipment, classes, races, rules, conditions, and SRD random tables. The analytical functions turn that data into planning results for encounters, characters, parties, spell selections, equipment loadouts, travel, rests, and combat.

The included content is stored locally in a SQLite database. The README describes the bundled source as ground-truth SRD data and lists monsters, spells, equipment, magic items, classes, races, conditions, rule sections, and rollable tables. The data is sourced from the 5e-bits/5e-database project and includes material from System Reference Document 5.1 under CC-BY-4.0.

## How it works

An MCP-compatible client starts the package over standard input/output and can invoke the exposed tools as needed. Search tools accept structured filters, such as challenge rating and creature type for monsters, or level, school, class, concentration, ritual, damage type, and saving throw type for spells. Equipment searches can distinguish item categories and filter by properties or rarity.

Analysis tools operate on supplied game data and the embedded SRD records. For example, encounter planning calculates XP budgets and proposes monster groups, while damage simulation estimates average damage, hit and critical results, AC sensitivity, and turns to defeat. Character and party tools derive information such as hit points, saving throws, spell DCs, role balance, languages, and darkvision coverage.

## Setup and configuration

The gregario/dnd-oracle MCP server requires Node.js 18 or newer. Install it through the npm package runner with:

```bash
npx -y dnd-oracle
```

For Claude Desktop, add a server entry using `npx` as the command and `-y dnd-oracle` as its arguments. The supplied setup does not require an API key, OAuth flow, database connection, or other environment variable. Because the database is bundled, normal operation does not depend on internet access.

The project is MIT licensed. Its included SRD material has a separate CC-BY-4.0 attribution requirement described by the project.

## Tools and capabilities

The gregario/dnd-oracle MCP server includes tools for:

- Searching monster stat blocks, spells, equipment, and rules.
- Browsing class features, race traits, ability bonuses, and subraces.
- Building or suggesting encounters based on XP, roles, synergies, and difficulty.
- Planning spells, including slots, concentration, rituals, and component costs.
- Comparing monsters and checking resistance or immunity coverage.
- Building characters and reviewing party composition.
- Analyzing equipment weight, cost, armor class, encumbrance, and magic-item attunement.
- Simulating damage, calculating rests and travel, pacing an adventuring day, and rolling on SRD tables.

## Limitations and notes

The server covers the D&D 5e SRD data bundled with the project, not an unrestricted catalog of all published D&D content. Results and calculations therefore depend on the included records and the rules represented in that dataset. The README identifies the data as SRD 5.1 material, so users should check licensing and attribution requirements when redistributing derived applications or content.

No external API credentials are documented, and the project does not describe live synchronization with other rules databases. Encounter suggestions and analysis outputs are calculations or inferences based on the supplied inputs and embedded data; they should be reviewed against the table's campaign rules and house rules before use.

_Full upstream README: https://allmcps.com/mcp/gregario-dnd-oracle/readme_