Grimoire MCP Server

Manage TTRPG campaigns: NPCs, locations, factions, quests, sessions, lore, and knowledge graphs.

Remote serverstreamable-http

What is the Grimoire MCP server?

If you already use Grimoire, the grimoire mcp server is the piece that lets your assistant work with it directly. Manage TTRPG campaigns: NPCs, locations, factions, quests, sessions, lore, and knowledge graphs.

What the server does

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.

  • 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

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Grimoire's toolset — Product, Changelog, Support and 4 more — is a fair guide to whether it matches your workflow. It is maintained by bot.ttrpg; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Grimoire's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
Producthttps://www.ttrpg.bot
Changeloghttps://www.ttrpg.bot/changelog
Supportzmanlevelup@gmail.com
Endpointhttps://api.ttrpg.bot/mcp
TransportStreamable HTTP (MCP spec 2025-06-18)
AuthOAuth 2.1, one-click consent flow
Tools48 across 7 groups (20 read, 28 write)

How to install the Grimoire MCP server

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

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Grimoire to Product.
  • Use Grimoire to Changelog.
  • Use Grimoire to Support.

Frequently asked questions

It connects Grimoire to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (Product, Changelog, Support, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Grimoire directly.