A list of API tokens named Claude, Session recap script, and Old laptop, with a New Token button

Public API and MCP server

Your campaign shouldn't be locked inside one app. Realms of Shod now has a public API, plus an MCP server so AI assistants like Claude can work with your realm directly.

API tokens

Create a token from User Settings in the H.U.B. You'll see it once, so copy it somewhere safe, and you can give it an expiry date or revoke it at any time. See authentication.

What can the API do?

  • Write a script to pull session transcripts directly into Obsidian.
  • Build custom compendium generators.
  • Pull the latest scene summary from a live session and send it to OBS for streaming.

Connect an AI assistant

The MCP server lets Claude, ChatGPT, and other MCP-compatible assistants read your realm and make changes for you. Ask it to sum up last session, build out a faction, or tidy up duplicate entities. Connecting takes one sign-in, with no token to copy and paste.

The MCP docs list every tool an assistant can use.

What can the MCP server do?

  • Ask questions about your sessions, like how you can improve as a player or GM.
  • Worldbuild with an agent, and generate compendium entities, their relationships to others, and even private notes.
  • Find the exact scene where an important moment occurred.
  • Ask an agent to find any duplicate entities and merge them automatically.