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 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.
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"archivist-ai": {
"url": "https://mcp.myarchivist.ai/mcp"
}
}
}
Add to your MCP configuration:
{
"mcpServers": {
"archivist-ai": {
"serverUrl": "https://mcp.myarchivist.ai/mcp"
}
}
}
Archivist AI is available as a ChatGPT plugin. Search for "Archivist AI" in the ChatGPT plugin store.
</details>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. |