Skip to main content
Glama
D&D 5E MCP Server

D&D 5E MCP Server

by heffrey78

D&D 5E MCP Server

An MCP server that gives AI assistants access to D&D 5th Edition content from the Open5e API: spells, monsters, classes, species, equipment, rules references, plus encounter-building and character-build helpers. It uses Open5e's v2 API.

Requirements

  • Node.js 20 or newer (developed against Node 26)

  • Network access to api.open5e.com

Related MCP server: D&D Knowledge Navigator

Setup

npm install
npm run build

Connecting a client

The server speaks JSON-RPC over stdio. Point your MCP client at the built entry point:

{
  "mcpServers": {
    "dnd-5e": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/absolute/path/to/dnd-mcp"
    }
  }
}

Set cwd to wherever you cloned this repository. A starting point is in mcp.json.

Verify it responds:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | node dist/index.js

Tools

Every tool except get_api_stats also takes two optional arguments that restrict it to some sourcebooks:

  • ruleset: "5e-2014", "5e-2024" or "a5e";

  • sources: Open5e document keys, e.g. ["srd-2014", "toh"].

Without them, searches cover every source Open5e serves. Each result carries a source label (document key, title and ruleset), and lookups by name prefer the 2024 SRD, then the 2014 SRD. Character builds default to the 2024 SRD only (see ADR-008); pass ruleset: "5e-2014" or sources: ["srd-2014"] for the older rules. An unknown ruleset or document is an error. A build that mixes editions, e.g. sources: ["srd-2024", "open5e"], uses 2014 species and backgrounds the way the 2024 Player's Handbook allows: the species keeps its traits, and ability increases come from the background. To add backgrounds without adding anything else, pass background_sources to generate_character_build, e.g. background_sources: ["toh"] for Tome of Heroes' 19 backgrounds.

Tool

Description

Required

unified_search

Search across all D&D content types (spells, monsters, items, races, classes, etc.) with intelligent ranking and filtering

query

Spells

Tool

Description

Required

search_spells

Search spells by name, level, school or class list

-

get_spell_details

Get detailed information about a specific D&D 5E spell

spell_name

get_spell_by_level

Get all spells of a specific level

level

get_spells_by_class

Get the spells on a class's spell list, lowest level first; filter by level or max_level

class_name

Classes and species

Tool

Description

Required

search_classes

List D&D 5E base classes with their features and subclass names

-

get_class_details

Get a class: hit die, proficiencies, features by level, spell slots and subclasses with their features

class_name

search_races

Search species, including subspecies whose names omit the parent (Lightfoot for Halfling)

-

get_race_details

Get a species with what it inherits resolved: size, speed, combined ability increases, parent traits

race_name

Monsters

Tool

Description

Required

search_monsters

Search monsters by name, challenge rating, type or environment

-

get_monsters_by_cr

Get monsters by challenge rating

challenge_rating

get_monsters_by_cr_range

Get monsters within a challenge rating range, optionally by environment and type

min_cr, max_cr

Equipment and items

Tool

Description

Required

search_weapons

Search for D&D 5E weapons with property filtering

-

search_magic_items

Search magic items by name, rarity, category or attunement

-

get_magic_item_details

Get detailed information about a specific D&D 5E magic item

item_name

search_armor

Search for D&D 5E armor with filtering options

-

get_armor_details

Get detailed information about a specific D&D 5E armor

armor_name

Character options

Tool

Description

Required

search_feats

Search for D&D 5E feats with filtering options

-

get_feat_details

Get detailed information about a specific D&D 5E feat

feat_name

search_backgrounds

Search for D&D 5E character backgrounds with filtering options

-

get_background_details

Get detailed information about a specific D&D 5E background

background_name

Rules reference

Tool

Description

Required

search_conditions

Search for D&D 5E conditions and status effects

-

get_condition_details

Get a condition, with its wording for the requested ruleset

condition_name

get_all_conditions

Get all D&D 5E conditions for quick reference

-

search_sections

Search rules sections by name or text

-

get_section_details

Get a rules section by name or key

section_name

get_all_sections

List every rules section by name, key and chapter, without the text

-

DM tools

Tool

Description

Required

build_encounter

Build a balanced encounter for a party, sampling monsters from the whole CR range

party_size, party_level, difficulty

calculate_encounter_difficulty

Calculate the difficulty of a custom encounter with specific monsters

party_size, party_level, monsters

Player tools

Tool

Description

Required

generate_character_build

Generate a build: species, class and subclass, background, ability scores, hit points, spells, feats and a level-by-level plan

-

compare_character_builds

Generate and compare multiple character builds with different options

build_options

get_build_recommendations

Get character build recommendations based on party composition and campaign needs

existing_party, campaign_type

Diagnostics

Tool

Description

Required

get_api_stats

Get API performance and caching statistics

-

Development

npm run dev               # watch mode
npm run build             # compile to dist/
npm run lint              # eslint over src/
npm test                  # unit tests, no network (builds first)
npm run test:integration  # live Open5e API tests
npm run test:all          # both suites

Tests use Node's built-in test runner. test/unit/ mocks fetch, so it runs offline and fast; test/integration/ exercises the real API and the real server process. See docs/testing.md.

Known quirks

  • Duplicate names across books. A search for fireball returns every sourcebook's Fireball, each labelled with its source. Detail lookups pick one (2024 SRD first); pass ruleset or sources to choose another.

  • Uneven upstream filtering. Open5e ignores many filter parameters and returns the whole collection. The client sends only verified parameters and matches the rest locally; see docs/api-filters.md.

  • Gaps in Open5e's data are reported, not guessed. Examples: no 2014 SRD spell lists the Paladin, and some Tome of Heroes heritages have no source for their size. Look in a build's warnings or a species' resolved.unresolved.

  • Builds are opinionated. Game rules (spell slots, hit points, ASIs) come from the SRD, but the scoring choices that pick a class, species or spell are judgment calls, collected in src/character-build/heuristics.ts. Multiclass builds are not supported; allow_multiclass: true is rejected.

  • unified_search count vs items. For classes the reported count can exceed the number of returned items, because classes are listed whole and then ranked against the query.

Documentation

Data source and licence

Content comes from the Open5e API, which serves material published under the OGL and Creative Commons licences. This server is MIT licensed; the game content it returns is governed by its own licences. Each item's source names the document it comes from.

Available Tools

37 tools
build_encounterA

Build a balanced D&D 5E encounter using monsters by CR for specified party

Inputs: party_size (required), party_level (required), difficulty (required), environment, +4 more.

calculate_encounter_difficultyC

Calculate the difficulty of a custom encounter with specific monsters

Inputs: party_size (required), party_level (required), monsters (required).

compare_character_buildsC

Generate and compare multiple character builds with different options

Inputs: build_options (required), campaign_type, focus_level.

generate_character_buildC

Generate an optimized character build combining race, class, background, and feats

Inputs: preferred_class, preferred_race, preferred_background, playstyle, +5 more.

get_all_conditionsB

Get all D&D 5E conditions for quick reference

Inputs: no named parameters.

get_all_sectionsB

Get all available D&D 5E rules sections for quick reference

Inputs: no named parameters.

get_all_spell_listsB

Get all available D&D 5E spell lists for quick reference

Inputs: no named parameters.

get_api_statsB

Get API performance and caching statistics

Inputs: no named parameters.

get_armor_detailsB

Get detailed information about a specific D&D 5E armor

Inputs: armor_name (required).

get_background_detailsC

Get detailed information about a specific D&D 5E background

Inputs: background_name (required).

get_build_recommendationsB

Get character build recommendations based on party composition and campaign needs

Inputs: existing_party (required), campaign_type (required), party_level, missing_roles.

get_class_detailsB

Get detailed information about a specific D&D 5E class

Inputs: class_name (required).

get_condition_detailsB

Get detailed information about a specific D&D 5E condition

Inputs: condition_name (required).

get_feat_detailsB

Get detailed information about a specific D&D 5E feat

Inputs: feat_name (required).

get_magic_item_detailsC

Get detailed information about a specific D&D 5E magic item

Inputs: item_name (required).

get_monsters_by_crC

Get monsters by challenge rating

Inputs: challenge_rating (required).

get_monsters_by_cr_rangeA

Get all monsters within a specific challenge rating range for encounter planning

Inputs: min_cr (required), max_cr (required), environment, monster_types, +1 more.

get_race_detailsB

Get detailed information about a specific D&D 5E race

Inputs: race_name (required).

get_section_detailsC

Get detailed information about a specific D&D 5E rules section

Inputs: section_name (required).

get_spell_by_levelC

Get all spells of a specific level

Inputs: level (required).

get_spell_detailsC

Get detailed information about a specific D&D 5E spell

Inputs: spell_name (required).

get_spell_list_detailsC

Get detailed spell list information for a specific D&D 5E class

Inputs: class_name (required).

get_spells_by_classC

Get all spells available to a specific class

Inputs: class_name (required).

get_spells_for_classB

Get detailed spell information for all spells available to a specific class

Inputs: class_name (required), limit.

search_armorB

Search for D&D 5E armor with filtering options

Inputs: query, category, ac_base, stealth_disadvantage, +1 more.

search_backgroundsC

Search for D&D 5E character backgrounds with filtering options

Inputs: query, limit.

search_classesB

Get all D&D 5E classes with comprehensive details

Inputs: no named parameters.

search_conditionsC

Search for D&D 5E conditions and status effects

Inputs: query, limit.

search_featsC

Search for D&D 5E feats with filtering options

Inputs: query, has_prerequisite, limit.

search_magic_itemsC

Search for D&D 5E magic items with filtering options

Inputs: query, rarity, type, requires_attunement, +1 more.

search_monstersB

Search for D&D 5E monsters with filtering options

Inputs: query, challenge_rating, limit.

search_racesC

Search for D&D 5E races with detailed trait information

Inputs: query.

search_sectionsC

Search D&D 5E rules sections for quick rule lookups

Inputs: query, limit.

search_spell_listsB

Search available D&D 5E spell lists by class

Inputs: query, limit.

search_spellsC

Search for D&D 5E spells with advanced filtering options

Inputs: query, level, school, limit, +1 more.

search_weaponsC

Search for D&D 5E weapons with property filtering

Inputs: query, is_martial, is_finesse, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 37 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap that could cause confusion. For example, get_spells_by_class and get_spells_for_class appear very similar, and get_all_sections vs. search_sections might be ambiguous. However, the majority of tools target specific resources and actions clearly.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, such as get_*_details, search_*, and build_*. There are no deviations in style, making the set predictable and easy to understand at a glance.

    Tool Count3/5

    With 37 tools, the count is borderline high for a D&D 5E server, which might feel heavy and overwhelming. While the domain is broad, some tools could potentially be consolidated or streamlined to reduce complexity without losing functionality.

    Completeness5/5

    The tool surface provides comprehensive coverage of the D&D 5E domain, including CRUD-like operations for characters, encounters, spells, monsters, items, and rules. It supports detailed lookups, searches, and advanced features like encounter building and character optimization, leaving no obvious gaps for agent workflows.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides fast, cached access to comprehensive Dungeons & Dragons 5th Edition data including spells, monsters, classes, races, equipment, and rules through Open5e and D\&D 5e APIs.
      7
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Dungeons & Dragons 5e game information via the Model Context Protocol, enabling queries for spells, monsters, equipment, and more.
      54
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Enables D&D 5e game masters and players to access complete game reference data, search spells, monsters, items, and calculate encounter difficulty, all through natural language.
      46
      8
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to manage D&D Beyond characters, access campaigns, and look up spells, monsters, items, and more through a reverse-engineered API.
      MIT