Grimoire MCP

Your campaign, organized by magic.

What is Grimoire?

Grimoire is a campaign manager for D&D and tabletop RPG gamemasters with a hosted MCP server built in. A campaign in Grimoire is structured data, not pages: typed NPCs, factions, locations, quests, items, sessions, and lore, connected by relationships and knowledge graphs. This MCP gives any AI client you connect a live, structured view of that database and your current situation in-game, so the AI answers from your actual canon instead of guessing. Upload and parse notes into structured database entities, query your world by relationship, drive prep and recaps from the conversation you're already having.

How to use Grimoire?

Three clicks, nothing to install:

1. Add the connector. In Claude.ai or ChatGPT (or any MCP client that supports custom connectors), open Settings → Connectors → Add custom connector and paste https://api.ttrpg.bot/mcp.
2. 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 the AI should see, click Approve. Access is scoped to that one campaign, enforced server-side.
3. 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." The client reads live and answers from your data.

Full setup walkthrough with client-specific instructions: https://www.ttrpg.bot/docs/mcp/

For clients configured by JSON file instead of a connectors UI:

{
  "mcpServers": {
    "grimoire": {
      "type": "streamable-http",
      "url": "https://api.ttrpg.bot/mcp"
    }
  }
}

Auth is OAuth 2.1 with PKCE; the client opens a browser sign-in on first connect. A free Grimoire account at https://www.ttrpg.bot provides the campaign the server reads.

Key features of Grimoire

• 48 tools (20 read, 28 write) over a typed campaign database with 14 entity schemas
• Knowledge graph queries: political, timeline, and geography projections with visibility filtering
• Narrative state in one call: recent sessions, open plot threads, active arcs, and canon facts
• Full write path: create and update entities, log thread progressions, edit wiki pages and blocks
• GM secrets enforced server-side with three visibility tiers (common knowledge, player knowledge, GM secrets)
• Remote streamable HTTP with OAuth 2.1; nothing to install or self-host
• Free tier includes full MCP access, and Grimoire never charges for AI tokens

Use cases of Grimoire

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 for an automated play-by-play. Hook a calendar MCP and the bot reminds you to prep.

The pitch is flexibility, not a baked-in workflow. MCP is a protocol; once Grimoire is connected to a frontier model, what you ask the model to do with it is the workflow.

The toolbox

48 tools across seven groups.

Entities (10): search_campaign, get_entity, list_entities, get_field_options, get_tag_options, get_entity_schema, create_entity, update_entity, delete_entity, batch_create_entities. Covers all 14 entity types: NPCs, Locations, Factions, Quests, Items, Player Char

... View full README on GitHub