# Grimoire Spellbook Server

Grimoire Spellbook Server connects D&D 5th Edition spell data to your coding agent. Look up casting details, school references, and class spells directly in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 305 installs
- Author: linell
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Linell/grimoire-mcp
- Updated: 2025-07-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/grimoire-spellbook-server

## What it does

Grimoire Spellbook Server interfaces with the community D&D 5e API to supply assistants with structured spellcasting data. It exposes five tools: `search_spells`, `get_spell`, `list_schools`, `list_classes`, and `get_class_spells`. The search tool applies filters for spell level, school, character class, ritual requirements, and concentration.

The server can run over HTTP directly via Smithery, removing any need for local compilation. If you build it locally from the source repository, Node.js 18+ and npm or yarn are required. A configuration flag named `debug` defaults to `false` and turns on verbose diagnostics when needed.

## Requirements
- Remote server: `https://grimoire-mcp--linell.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http grimoire-mcp https://grimoire-mcp--linell.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add grimoire-spellbook-server --url https://grimoire-mcp--linell.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "grimoire-spellbook-server": {
            "url": "https://grimoire-mcp--linell.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "grimoire-spellbook-server": {
            "type": "http",
            "url": "https://grimoire-mcp--linell.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http grimoire-spellbook-server https://grimoire-mcp--linell.run.tools
```

## When to use it
- filter 5e spells by level, school, class, ritual, or concentration
- inspect casting times, component rules, and detailed spell text
- retrieve class-specific spell lists at a targeted level
- verify official D&D 5e spellcaster classes and magic schools

## Example prompts
- Find 3rd-level wizard spells that require concentration
- Show the casting components and description for Fireball
- List all 1st-level spells available to a cleric

## Similar
- [grimoire-pendle](https://affpapa.org/en/nevibecode/skills/grimoire-pendle.md) — skill · 1000 installs
- [board-game-design](https://affpapa.org/en/nevibecode/skills/board-game-design.md) — skill · 134 installs
- [spellbook-skills](https://affpapa.org/en/nevibecode/plugins/spellbook-skills.md) — plugin · ★ 1596 repo stars
- [warhammer-oracle](https://affpapa.org/en/nevibecode/mcp/warhammer-oracle.md) — MCP server · ★ 13 repo stars
- [Smithery](https://affpapa.org/en/nevibecode/mcp/smithery.md) — MCP server · 690 installs
- [smithery-ai-cli](https://affpapa.org/en/nevibecode/skills/smithery-ai-cli.md) — skill · 1652 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
