Archivist AI MCP Server

The official Model Context Protocol (MCP) server for Archivist AI -- a TTRPG campaign memory platform for game masters and players.

Registry metadata lives in server.json. Publishing to the official MCP Registry is automated on version tags via .github/workflows/publish-mcp.yml (git tag v1.0.0 && git push origin v1.0.0).

Connect AI assistants like Claude, ChatGPT, Cursor, Notion, and Windsurf directly to your campaign data: characters, sessions, locations, factions, items, quests, journals, and more.

Quick Start

MCP Server URL: https://mcp.myarchivist.ai/mcp

Claude Desktop

Claude Desktop requires the mcp-remote proxy (Node.js must be installed).

Add to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "archivist-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.myarchivist.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Archivist AI API key from app.myarchivist.ai. Restart Claude Desktop after saving.

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "archivist-ai": {
      "url": "https://mcp.myarchivist.ai/mcp"
    }
  }
}

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "archivist-ai": {
      "serverUrl": "https://mcp.myarchivist.ai/mcp"
    }
  }
}

ChatGPT

Archivist AI is available as a ChatGPT plugin. Search for "Archivist AI" in the ChatGPT plugin store.

Available Tools

All tools are read-only, non-destructive, and idempotent. Write operations are planned for v2.

Campaigns

Tool	Description
`list_campaigns`	List your campaigns. Returns a paginated list.
`get_campaign`	Get a specific campaign by ID.
`get_campaign_stats`	Get statistics for a campaign: character count, session count, and more.

Sessions

Tool	Description
`list_sessions`	List game sessions. Filter by session type or public-only.
`get_session`	Get a session by ID. Optionally include related beats and moments.
`get_session_cast_analysis`	Get cast analysis: talk-share breakdown and core session metrics.
`get_session_transcript`	Get the cleaned transcript for a game session, including utterances, full text, and aggregate stats.
`get_session_handout`	Get the generated session handout for a game session, including summary, outlines, spotlights, and notable moments.

Story Structure

Tool	Description
`list_beats`	List beats ordered by index. Beats represent story moments (major, minor, step).
`get_beat`	Get a specific beat by ID.
`list_moments`	List moments in a campaign or session. Moments capture memorable quotes and events.
`get_moment`	Get a specific moment by ID.

World Building

Tool	Description
`list_characters`	List characters in a campaign. Filter by name, type (PC/NPC), or approval status.
`get_character`	Get a character by ID including aliases, backstory, and speaker linkage.
`list_factions`	List factions. Factions represent guilds, organisations, or other groups.
`get_faction`	Get a specific faction by ID.
`list_locations`	List locations. Locations can be nested (cities, taverns, dungeons, etc.).
`get_location`	Get a specific location by ID.
`list_items`	List items. Items include weapons, armour, artefacts, and other notable objects.
`get_item`	Get a specific item by ID.

Quests

Tool	Description
`list_quests`	List quests with pagination. Filter by status or category.
`get_quest`	Get a fully expanded quest: objectives, progress log, related entities, session provenance.

Journals

Tool	Description
`list_journals`	List journal entries. Content omitted from list; use get_journal for full content.
`get_journal`	Get a journal entry by ID including full content and permission level.
`list_journal_folders`	List journal folders ordered by path and position for tree rendering.
`get_journal_folder`	Get a specific journal folder by ID.

Relationships

Tool	Description
`list_links`	List links between entities. Filter by source/target entity and relationship alias.