Dnd Oracle

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:

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.