Realms of Shod logo

Realms of Shod

Overview

  • Getting Started

    • Quickstart
    • Storytelling
    • Using the H.U.B.
    • Sculpting Realms
    • Collaborating
    • Coins

  • Understanding the Interface

    • Navigation
    • Media Controls
    • Story Tools

  • Realms Sandbox

    • Play Modes
    • Gamestream
    • Transcripts
    • Compendium

  • World Building

    • Import / Export
    • Entities

  • Integrations

    • Discord
    • MCP

  • API Reference

    • Authentication
    • Realms API
    • Compendium API
    • Sessions API

  • Support

    • FAQs
    • Contact & Feedback
    • Privacy
MCP

Integrations

MCP

Connect your AI assistant to Realms of Shod using the Model Context Protocol. Once connected, your assistant can read and manage your realms, sessions, and compendium directly. No copy-pasting needed.

The Realms of Shod MCP server uses standard OAuth. When you add the server to your AI client and first make a request, your client will open a browser window and prompt you to sign in to your Realms of Shod account. After that, the connection is managed automatically.

Run the following command in your terminal to register the Realms of Shod MCP server with Claude Code.

claude mcp add --transport http realms-of-shod https://mcp.realmsofshod.com/mcp
1

Run the command

Paste the command above into your terminal and run it. Claude Code will register the server globally.

2

Authenticate

On your next Claude Code session, Claude will prompt you to authorize access. A browser window will open for you to sign in to your Realms of Shod account.

3

Start using it

Ask Claude about your realms, sessions, or compendium and it will query your data directly.

Once connected, your AI assistant has access to the following tools. You do not need to invoke them directly as your assistant will use them automatically when relevant. Most write operations require you to be the realm creator.

list_realms

List all realms you have access to, including id, title, cover image, and creator. Supports cursor pagination.

get_realm

Get details for a single realm by id, including its members and settings.

create_realm

Create a new realm owned by you. Requires a title.

edit_realm

Rename an existing realm by id. You must be the creator of the realm.

list_sessions

List sessions for a realm, including id, title, start and end times, and summaries. Supports cursor pagination.

get_session

Get details for a single session by id, including scenes and summary.

get_session_transcriptions

Get the full spoken transcript for a session, with speaker identity and timestamps. Supports cursor pagination.

list_entities

List compendium entities for a realm, including id, name, type, description, and cover image. Supports cursor pagination.

get_entity

Get full details for a single compendium entity, including description, variants, images, relationships, and your personal notes.

create_entity

Create a new entity in a realm's compendium. Requires a name and a valid entity type. You must be the realm creator.

edit_entity

Update an existing compendium entity's name, type, description, or access. All fields are optional — only the fields you provide are changed. You must be the realm creator.

edit_entity_notes

Update your personal notes for a compendium entity. Notes are private to you and not visible to other realm members.

merge_entities

Merge one or more entities into a single surviving entity. The merged entities are permanently deleted. Notes, relationships, access, and images can each be optionally transferred. You must be the realm creator.

delete_entity

Permanently delete a compendium entity and all of its relationships. This action cannot be undone. You must be the realm creator.

list_relationships

List all compendium relationships in a realm. Each relationship links two entities with a type and the ids of both entities it connects.

create_relationship

Create a directional relationship between two compendium entities. Returns an error if an identical relationship already exists. You must be the realm creator.

delete_relationship

Permanently delete a compendium relationship by id. This action cannot be undone. You must be the realm creator.

← Previous: DiscordNext FAQs →