Log inSubmit server
Dnd Oracle logo

Dnd Oracle

by gregario

D&D 5e SRD MCP tools for rules lookup, character analysis, encounter planning, and game calculations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Dnd Oracle

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gregario-dnd-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "dnd-oracle"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y dnd-oracle

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The gregario/dnd-oracle MCP server exposes D&D 5e SRD reference and analysis tools through MCP. It bundles SRD data in a local SQLite database, so searches and calculations do not require an internet connection or external API credentials. Use it to look up monsters, spells, equipment, classes, races, and rules, or to analyze encounters, characters, parties, rests, travel, and combat damage. It fits tabletop assistants that need structured D&D 5e reference data and rules-based planning.

Use cases

  • Search SRD monsters by challenge rating and type
  • Plan encounters within an XP budget
  • Build characters from race, class, level, and ability scores
  • Analyze party coverage and equipment loadouts
  • Calculate travel, rests, damage, and adventuring-day resources

Key features

  • Local SQLite SRD reference data
  • Monster, spell, equipment, class, race, and rules search
  • Encounter construction and tactical encounter suggestions
  • Character, party, loadout, and attunement analysis
  • Combat, rest, travel, and resource calculations
  • SRD random-table rolls

Tools20

What Dnd Oracle lets your agent do. Expand a tool for its parameters.

Self-reported~448 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · dnd-oracle (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads259Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed20Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Dnd Oracle works

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

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

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Dnd Oracle

Run `npx -y dnd-oracle`. The project requires Node.js 18 or newer.

Yes. The README provides a Claude Desktop configuration that starts `npx` with `-y dnd-oracle`.

No API key or other credential is documented. Its SRD data is bundled in a local SQLite database.

It can calculate encounter XP budgets, spell and resource planning, loadouts, attunement, character values, party coverage, damage estimates, rests, travel, and adventuring-day pacing.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDnd Oracle AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gregario-dnd-oracle?style=directory)](https://allmcps.com/mcp/gregario-dnd-oracle)
HTML Embed
<a href="https://allmcps.com/mcp/gregario-dnd-oracle"><img src="https://allmcps.com/api/badge/gregario-dnd-oracle?style=directory" alt="Dnd Oracle on AllMCPs" /></a>