Grimoire MCP · Bring Your Own AI
Your Campaign, Organized by Magic.
Grimoire MCP gives any AI client you connect a live, structured view of your campaign data and current situation in-game. Flexible by design, Grimoire fits the AI workflow you develop yourself. Not the other way around. Upload and parse notes into structured database entities, query your world by relationship, and more. By giving you the protocol, what you can do with Grimoire is up to your imagination.
Free on Grimoire's free tier. Free on Claude.ai's free tier. End-to-end free to try.
Build your own TTRPG bot.
Tool access from MCP. Canon events from your story. Paired with the frontier model of your choice. Make the Grimoire database the source of truth your AI can't contradict. Any homebrew quirk, any retconned event, any setting rule becomes canon the AI defers to before it answers. Connect with Grimoire MCP and watch AI become a living in-world expert in your unique setting and story.
Three Clicks to Connect
Add Grimoire as a custom connector
In Claude.ai (or any MCP client that supports custom connectors), open Settings → Connectors → Add custom connector and paste https://api.ttrpg.bot/mcp.
Sign in and pick a campaign
Your client opens the Grimoire consent screen. Sign in with the account that owns the campaign, pick which campaign Claude should see, click Approve. Access is scoped to that one campaign, enforced server-side.
Ask it something about your world
"Who knows about the cult?" "What was the queen's reaction in session 4?" "Generate three rumors that fit my current city." Your client reads live and answers from your data.
Flexibility is the feature.
MCP is a protocol. Connect Grimoire to a frontier model and the model has live, structured control over your campaign. Whatever you ask the model to do with it is the workflow.
The fast wins.
Parse a paragraph of session notes into NPCs, factions, and threads. Dig up the location you mentioned three sessions ago. Update a faction's status straight from a recap.
The deeper plays.
Model an NPC reaction grounded in motivations they actually have and a political web they actually sit inside. Project the next move House Vale makes, if it moves at all. Generate three rumors that fit your city, not generic fantasy.
The MC-Possibilities.
Chain Grimoire MCP to other MCPs. Pipe your last session into a slideshow MCP and a voiceover MCP and get an automated play-by-play of what happened, complete with narration. Hook into a calendar MCP and the bot reminds you to prep.
We focus on one thing: making sure Grimoire can capture whatever's unique about your story and hand it to AI in a form the AI respects. You pick which AI and how it works. A baked-in "TTRPG bot AI" would always lag the frontier. This never does.
How Grimoire Structures Your World
Walk through the actual MCP tool calls your client makes — left to right, in sequence, with realistic timing. Switch tabs to see different ways AI clients use Grimoire MCP.
Modeling an NPC reaction. Six tool calls build context before your client answers.
User → AI client
"How would Queen Mira react if her brother betrayed her?"
get_constitution
World truths loaded — magic, gods, founding rules.
get_narrative_state
Where the story is now — recent sessions, open threads, canon facts.
search_campaign
Found Queen Mira and her brother Cyrus.
get_entity
Mira's full record — motivations, secrets, ties to Cyrus.
get_knowledge_graph
Political ties — Crown loyalist, Cyrus turned Opposition.
client models
Combines all of the above to derive how Mira would react.
Result · 2.0s
An in-character reaction grounded in Mira's actual motivations and her established history with Cyrus — not a generic queen-betrayed-by-brother trope. Respects what's canon, what's secret, what's already happened.
Visibility tiers wrap every read above. DM secrets stay DM secrets even when a player is the one talking to your AI client.
Trust by Design
The boring stuff that matters when you're handing your campaign to a robot.
Free on both ends
Grimoire never charges you for AI. Grimoire's free tier covers MCP, and Claude.ai's free tier covers one custom connector. The whole experience can be tried out within free limits.
Visibility-aware
DM secrets stay DM secrets even when your players are the ones querying. Three visibility tiers (DM-only, player-knowledge, common) wrap every layer of context Grimoire exposes.
No training, ever
Your campaign data never enters anyone's training pipeline. Prompts and responses live entirely in your AI client's session — Grimoire only serves data when it's queried.
Switch AI freely
Want voice? Add it to Claude Desktop. Want agents? Use Claude Code. Want a different model? Use any MCP-compatible client. Your campaign doesn't move.
Build your TTRPG bot. Free.
Grimoire's free tier doesn't paywall MCP, and Claude.ai's free tier supports one custom connector. That connector can be Grimoire. End-to-end free to try.
"How Grimoire MCP Works" is a deep-dive explainer for the curious, no setup steps. "Read the MCP Docs" is the technical setup guide.