Summary
Connects to the D&D 5e API to give Claude spell lookup tools for tabletop gaming sessions. Exposes search_spells with filters for level, school, class, ritual, and concentration requirements, plus get_spell for full stat blocks including casting time and components. Also provides get_class_spells to see what's available to specific classes at given levels. Useful when you're running a game and need quick spell references without breaking flow to flip through books, or when helping players understand spell options during character creation. The author built it as a learning project on Smithery, so it's self described as the "world's okayest" spellbook, but the API coverage looks solid for standard play.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Grimoire
"World's okayest MCP-powered D&D 5e spellbook"
A Model Context Protocol (MCP) server that provides D&D 5e spell information through a set of tools. Built as a learning project to explore the Smithery MCP deployment platform.
Features
- Spell search with filters (level, school, class, name, ritual, concentration)
- Detailed spell information including casting time, components, and descriptions
- Class-specific spell lists by level
- Spell school and character class references
Powered by D&D 5e API
This project is entirely powered by the D&D 5e API - a comprehensive, community-driven API that provides detailed information about D&D 5e spells, monsters, and more.
Quick Start
Prerequisites
- Node.js 18+
- npm or yarn
Installation
- Clone the repository:
git clone https://github.com/yourusername/grimoire.git
cd grimoire
- Install dependencies:
npm install
- Start the development server:
npm run dev
Available Tools
search_spells- Search for spells with various filtersget_spell- Get detailed information about a specific spelllist_schools- List all available D&D 5e spell schoolslist_classes- List all available spellcasting character classesget_class_spells- Get spells available to a specific class at a given level
Built with Smithery
This project is deployed using Smithery, a platform for deploying MCP servers that makes it easy to deploy, scale, and manage MCP servers with zero configuration.
Development
Project Structure
grimoire/
├── src/
│ └── index.ts # Main MCP server implementation
├── package.json # Dependencies and scripts
├── smithery.yaml # Smithery deployment configuration
└── README.md # This file
Local Development
Start the development server:
npm run dev
The server will be available at the local endpoint provided by Smithery CLI.
Configuration
debug(boolean): Enable debug logging (default: false)
Contributing
Contributions are welcome! This is a learning project, so feel free to:
- Add new spell-related tools
- Improve error handling
- Enhance the documentation
- Add tests
- Suggest new features
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- D&D 5e API for providing comprehensive spell data
- Smithery for the MCP deployment platform
- The D&D 5e community for maintaining comprehensive game data
Links
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
