mnehmos.open5e.mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mnehmos.open5e.mcp Search for fireball spell"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mnehmos.open5e.mcp
MCP server for Open5e - Query D&D 5e game data and contribute to the open-source database
A dual-mode MCP server that provides:
Consumer Mode: Query spells, monsters, items, conditions, and more from 22+ source books
Contributor Mode: Validate entries, check for collisions, diff against live API, and generate PR-ready JSON
RAG Developer Chatbot: Search and chat with Open5e repository documentation
Features
Category | Tools | What It Does |
Consumer | 6 tools | Search, get, list, batch fetch D&D 5e content |
Contributor | 5 tools | Validate schemas, check slugs, diff entries, generate PRs |
RAG | 5 tools | Search repo docs, chat with AI about contributing |
Meta | 3 tools | Health checks, list documents/endpoints |
Related MCP server: D&D 5E MCP Server
Installation
npm
npm install -g mnehmos.open5e.mcpFrom Source
git clone https://github.com/Mnehmos/mnehmos.open5e.mcp.git
cd mnehmos.open5e.mcp
npm install
npm run buildClaude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"mnehmos.open5e.mcp": {
"command": "node",
"args": ["path/to/mnehmos.open5e.mcp/dist/index.js"]
}
}
}Or if installed globally:
{
"mcpServers": {
"mnehmos.open5e.mcp": {
"command": "mnehmos-open5e-mcp"
}
}
}Quick Start
Search for Spells
Search: "fireball"
→ Returns Fireball, Delayed Blast Fireball from multiple sourcesGet a Monster
Get: monsters/goblin
→ Full stat block with AC, HP, abilities, actions, environmentsValidate a Contribution
Validate: { name: "Custom Spell", level: 3, school: "Evocation", ... }
→ Errors for missing required fields
→ Suggestions for slug format
→ Warnings for unusual valuesTool Reference
Consumer Tools
search
Search across all Open5e resources with optional filters.
search({
query: "fireball",
resource_type: "spells", // optional: spells, monsters, items, etc.
document_slug: "srd-2014", // optional: filter by source book
limit: 10 // optional: max results (default 20)
})Returns results with slug, key (for v2 resources), name, excerpt, and web_url.
get
Fetch a single resource by slug. Auto-tries common document prefixes for v2 resources.
// Simple slug - auto-discovers the full key
get({ resource_type: "spells", slug: "fireball" })
// → Finds srd-2024_fireball or srd-2014_fireball
// Full key - direct lookup
get({ resource_type: "spells", slug: "srd-2014_fireball" })list
List resources with filters (pagination supported).
list({
resource_type: "monsters",
cr: 3, // Challenge Rating
document_slug: "wotc-srd", // Source book
type: "Dragon", // Creature type
limit: 20,
offset: 0
})
list({
resource_type: "spells",
level: 3, // Spell level (0-9)
school: "Evocation", // Spell school
document_slug: "srd-2014"
})batch_get
Fetch multiple resources in parallel (max 50).
batch_get({
requests: [
{ resource_type: "monsters", slug: "goblin" },
{ resource_type: "monsters", slug: "kobold" },
{ resource_type: "conditions", slug: "blinded" }
]
})list_documents
List all available source books.
list_documents()
// → srd-2014, srd-2024, tob, tob2, tob3, a5e-ag, bfrd, etc.list_endpoints
List all API endpoints with version info.
list_endpoints()
// → spells (v2), monsters (v1), conditions (v2), etc.Contributor Tools
validate_entry
Validate a draft entry against Open5e schema.
validate_entry({
resource_type: "spells",
data: {
name: "Test Spell",
slug: "test-spell",
level: 3,
school: "Evocation",
// ... other fields
},
strict: false // optional: fail on warnings
})Returns:
valid: booleanerrors: Array of schema violationswarnings: Unusual but valid valuessuggestions: Helpful hints (slug format, valid enums)
check_slug
Check if a slug exists or would collide.
check_slug({
resource_type: "monsters",
slug: "goblin",
document_slug: "wotc-srd", // optional
original_slug: "goblin-old" // optional: detect mutations
})Returns:
exists: booleanis_mutation: boolean (slug changed from original)collision_risk: "none" | "same_document" | "different_document"existing_entry: Details if exists
diff
Compare a draft entry against the live API version.
diff({
resource_type: "monsters",
slug: "goblin",
draft: {
name: "Goblin",
hit_points: 10, // Changed from 7
// ... partial or full entry
},
ignore_fields: ["page_no"] // optional
})Returns field-by-field diff with type: "added" | "removed" | "modified".
normalize
Clean up and standardize entry data.
normalize({
resource_type: "spells",
data: {
name: "test spell",
desc: "A spell with bad spacing.\n\nAnd extra newlines."
},
options: {
fix_whitespace: true,
fix_markdown: true,
standardize_names: true,
generate_slug: true
}
})generate_pr_json
Generate PR-ready JSON with file path and checklist.
generate_pr_json({
resource_type: "spells",
document_slug: "srd-2014",
operation: "add", // or "modify"
data: { /* validated entry */ }
})Returns:
json_output: Formatted JSON stringfile_path: Where to place the file (e.g.,data/srd-2014/spells/test-spell.json)validation: Pre-flight validation resultschecklist: PR submission checklist
RAG Tools
The RAG tools connect to the Open5e Developer Chatbot, which indexes the entire open5e-api and open5e (frontend) repositories.
rag_health
Check RAG service status.
rag_health()
// → { healthy: true, chunks: 484, vectors: 484, sources: 214 }rag_stats
Get index statistics.
rag_stats()
// → Project info, chunk/vector counts, embedding statusrag_sources
List all indexed sources with GitHub URLs.
rag_sources()
// → README.md, CONTRIBUTING.md, AGENTS.md, models/*.py, views/*.py, etc.rag_search
Search repository documentation.
rag_search({
query: "how to add a new monster",
mode: "hybrid", // semantic, keyword, or hybrid
top_k: 5
})Returns chunks with scores, source URLs, and positions.
rag_chat
Chat with AI about Open5e development.
rag_chat({
message: "How do I add a new monster to the Open5e database?",
history: [], // optional: conversation history
top_k: 5 // optional: context chunks
})Returns detailed answer with source citations.
Meta Tools
health_check
Check API connectivity and cache status.
health_check()
// → { api_reachable: true, api_latency_ms: 628, cache_status: {...}, version: "0.1.0" }Available Source Books
Slug | Name | Publisher |
| System Reference Document 5.1 | Wizards of the Coast |
| System Reference Document 5.2 | Wizards of the Coast |
| Tome of Beasts | Kobold Press |
| Tome of Beasts (2023) | Kobold Press |
| Tome of Beasts 2 | Kobold Press |
| Tome of Beasts 3 | Kobold Press |
| Adventurer's Guide (A5E) | EN Publishing |
| Monstrous Menagerie (A5E) | EN Publishing |
| Black Flag Reference Document | Kobold Press |
| Deep Magic | Kobold Press |
... | 22 total sources |
Use list_documents() for the complete list.
Resource Types
Type | API Version | Filters Available |
| v2 | level, school, document_slug |
| v1 | cr, type, document_slug |
| v2 | document_slug |
| v1 | document_slug |
| v1 | document_slug |
| v2 | document_slug |
| v2 | document_slug |
| v2 | document_slug |
| v2 | document_slug |
| v2 | document_slug |
| v1 | document_slug |
Usage Patterns
Game Master: Building an Encounter
// Find CR 3 monsters from the SRD
const monsters = await list({
resource_type: "monsters",
cr: 3,
document_slug: "wotc-srd"
});
// Get full details for selected monsters
const details = await batch_get({
requests: monsters.results.slice(0, 5).map(m => ({
resource_type: "monsters",
slug: m.slug
}))
});Contributor: Adding a New Spell
// 1. Draft the spell
const draft = {
name: "Arcane Bolt",
slug: "arcane-bolt",
level: 0,
school: "Evocation",
casting_time: "1 action",
range: "120 feet",
verbal: true,
somatic: true,
material: false,
concentration: false,
ritual: false,
duration: "Instantaneous",
desc: "You hurl a bolt of arcane energy at a creature...",
document__slug: "homebrew"
};
// 2. Validate
const validation = await validate_entry({
resource_type: "spells",
data: draft
});
// 3. Check for collisions
const slugCheck = await check_slug({
resource_type: "spells",
slug: "arcane-bolt"
});
// 4. Generate PR JSON
const prData = await generate_pr_json({
resource_type: "spells",
document_slug: "homebrew",
operation: "add",
data: draft
});Learning: Understanding the Codebase
// Search for how monsters are modeled
const results = await rag_search({
query: "Monster model fields actions abilities",
top_k: 5
});
// Ask the chatbot
const answer = await rag_chat({
message: "What fields are required for a monster entry in v1?"
});Integration
rpg-mcp
This server is designed to integrate with rpg-mcp for live creature lookups during gameplay:
// Replace hardcoded creature presets with Open5e lookups
const creature = await open5e.get({
resource_type: "monsters",
slug: "adult-red-dragon"
});Quest Keeper AI
Surface contributor workflows in the Quest Keeper AI frontend for community content creation.
Development
Setup
npm install
npm run buildTesting
npm test # Run all tests
npm run test:watch # Watch mode
npm run test:coverage # Coverage reportScripts
Command | Description |
| Compile TypeScript |
| Watch mode compilation |
| Run the server |
| Run tests |
| Lint source files |
| Type check without emit |
Project Structure
src/
├── index.ts # MCP server entry point, tool registration
├── types.ts # Shared TypeScript types
├── api/ # Open5e API client
├── cache/ # Response caching
├── contributor/ # Validation, diff, PR generation
├── schema/ # Zod schemas for all resource types
└── utils/ # Helpers, slug handlingAPI Reference
Open5e API: https://api.open5e.com
API Documentation: https://open5e.com/api-docs
GitHub Repository: https://github.com/open5e/open5e-api
Discord: https://discord.gg/9RNE2rY
Contributing
Fork the repository
Create a feature branch
Run tests:
npm testSubmit a pull request
License
MIT © Mnehmos
Part of the Mnehmos MCP ecosystem
mnehmos.ooda.mcp - File system and shell operations
mnehmos.synch.mcp - Agent memory and handoffs
rpg-mcp - RPG game engine
Available Tools
18 toolsbatch_getB
Retrieve multiple resources in a single call. Supports mixed resource types.
Inputs: requests (required).
check_slugC
Check if a slug exists, would collide, or has been modified from an existing entry.
Inputs: slug (required), resource_type (required), document_slug, original_slug.
diffC
Compare a draft entry against the live API version.
Inputs: slug (required), draft (required), resource_type (required), ignore_fields.
generate_pr_jsonC
Generate PR-ready JSON output for a new or modified entry, suitable for submitting to open5e-api.
Inputs: data (required), operation (required), document_slug (required), resource_type (required).
getB
Get a single resource by slug with full details and frontend web URL.
Inputs: slug (required), resource_type (required).
health_checkB
Check API connectivity and cache status.
Inputs: no named parameters.
listB
List resources of a type with optional filters. All results include frontend web URLs.
Inputs: resource_type (required), cr, type, level, +4 more.
list_documentsB
List all available source documents (books) with their metadata and resource counts.
Inputs: no named parameters.
list_endpointsA
List all available API endpoints with their versions and URLs.
Inputs: no named parameters.
normalizeC
Normalize markdown formatting and standardize field values. Also generates chunks for RAG indexing.
Inputs: data (required), resource_type (required), options.
rag_chatA
Chat with the Open5e RAG Developer Chatbot. Ask questions about Open5e API development and get answers with citations.
Inputs: message (required), top_k, history.
rag_chunkB
Get a specific chunk from the RAG index by ID.
Inputs: chunk_id (required).
rag_healthB
Check the Open5e RAG Developer Chatbot service health.
Inputs: no named parameters.
rag_searchA
Search the Open5e developer documentation RAG index. Returns relevant code chunks with citations.
Inputs: query (required), mode, top_k.
rag_sourcesB
List all indexed sources in the RAG index with their GitHub URLs.
Inputs: no named parameters.
rag_statsA
Get statistics about the Open5e RAG index (source count, chunk count, embedding model).
Inputs: no named parameters.
searchB
Search across Open5e resources (spells, monsters, etc.) with filters. Returns results with frontend web URLs.
Inputs: query (required), limit, offset, document_slug, +1 more.
validate_entryC
Validate a draft entry against the Open5e schema for its resource type.
Inputs: data (required), resource_type (required), strict.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
The generic retrieval tools get, list, and search have some conceptual overlap, but descriptions clarify slug-based lookup vs. type listing vs. cross-resource search. The rag_* group, contribution workflow tools, and metadata tools are clearly distinct from the core API tools.
The set mixes bare verbs (get, search, list, diff, normalize), verb_noun tools (health_check, list_documents, validate_entry, generate_pr_json), and a rag_ prefixed subgroup. The rag_* cluster is consistent, but the overall surface does not follow a single predictable convention.
At 18 tools, the server is slightly above the ideal range, but the tools are divided into three coherent clusters: core Open5e API access, contribution preparation, and RAG chatbot access. No cluster appears bloated for its purpose.
The surface covers read/search/list/batch access, document and endpoint discovery, contribution validation and normalization, PR JSON generation, and comprehensive RAG operations. Minor gaps include no direct document-content fetch and no actual PR submission tool, though generate_pr_json prepares the output.
Maintenance
Related MCP Connectors
D&D 5e MCP — wraps the D&D 5th Edition API (free, no auth)
Characters, campaigns, adventures & worlds for D&D 5e/5.5e, Pathfinder, Savage Worlds, Fate, & more.
D&D and TTRPG campaign manager for GMs: your AI reads and writes a live, typed campaign database.
Your tabletop campaign's journal, wiki, map, character sheets and combat tracker.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides 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.72MIT
- AlicenseBqualityBmaintenanceProvides comprehensive access to Dungeons & Dragons 5th Edition content through the Open5e API. It enables users to search for game mechanics, generate character builds, and create balanced encounters via natural language.3722MIT
- AlicenseAqualityBmaintenanceD\&D 5e SRD MCP server - monster search, spell lookup, encounter building, and character tools powered by ground-truth SRD data2095 npm8MIT
- FlicenseAqualityBmaintenanceEnables 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.468-