Dnd Oracle

io.github.gregarioPublished by GitHub account gregariov0.1.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop only

Overview

AI-generated overview

Local MCP server that lets an assistant search D&D 5e SRD monsters, spells, equipment and rules, and build encounters, characters and party analyses.

What you can do
  • Search and browse monsters, spells, equipment, magic items, classes, races, rules and conditions
  • Build and suggest encounters with XP budgets and monster synergy notes
  • Plan spells, compare monsters, check resistances and analyze loadouts and attunement
  • Build characters, audit party composition, simulate damage, and calculate rests and travel
  • Roll on SRD random tables such as madness, poisons and diseases
When to use it
Useful when running or preparing a D&D 5e game and you want rules-accurate lookups and encounter, character or party math from bundled SRD data instead of model recall. Also handy for quick stat-block comparisons and damage estimates during session prep.
Requirements
Runs as a local process via npx from the npm package dnd-oracle; Node.js is needed. No accounts, API keys, environment variables or internet access are required, since the SRD data is bundled as a SQLite database.
Before you install
Read-only reference and calculation tools; the input shows no credentials, payments or data-writing actions. Content is limited to the SRD 5.1 subset, so non-SRD monsters, spells and options are not covered.

Installation

In SourceWeft

  1. Open Dnd Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

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

Claude Code

bash
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

Source: README.md at commit a97d741

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts