Claude Desktop

\n\nClaude Desktop requires the [`mcp-remote`](https://github.com/geelen/mcp-remote) proxy (Node.js must be installed).\n\nAdd to your `claude_desktop_config.json` (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n```json\n{\n \"mcpServers\": {\n \"archivist-ai\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.myarchivist.ai/mcp\",\n \"--header\",\n \"Authorization:${AUTH_HEADER}\"\n ],\n \"env\": {\n \"AUTH_HEADER\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your Archivist AI API key from [app.myarchivist.ai](https://app.myarchivist.ai). Restart Claude Desktop after saving.\n

\n\n

Cursor

\n\nAdd to `.cursor/mcp.json` in your project:\n```json\n{\n \"mcpServers\": {\n \"archivist-ai\": {\n \"url\": \"https://mcp.myarchivist.ai/mcp\"\n }\n }\n}\n```\n

\n\n

Windsurf

\n\nAdd to your MCP configuration:\n```json\n{\n \"mcpServers\": {\n \"archivist-ai\": {\n \"serverUrl\": \"https://mcp.myarchivist.ai/mcp\"\n }\n }\n}\n```\n

\n\n

ChatGPT

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

\n\n## Available Tools\n\nAll tools are **read-only**, **non-destructive**, and **idempotent**. Write operations are planned for v2.\n\n### Campaigns\n\n| Tool | Description |\n|------|-------------|\n| `list_campaigns` | List your campaigns. Returns a paginated list. |\n| `get_campaign` | Get a specific campaign by ID. |\n| `get_campaign_stats` | Get statistics for a campaign: character count, session count, and more. |\n\n### Sessions\n\n| Tool | Description |\n|------|-------------|\n| `list_sessions` | List game sessions. Filter by session type or public-only. |\n| `get_session` | Get a session by ID. Optionally include related beats and moments. |\n| `get_session_cast_analysis` | Get cast analysis: talk-share breakdown and core session metrics. |\n| `get_session_transcript` | Get the cleaned transcript for a game session, including utterances, full text, and aggregate stats. |\n| `get_session_handout` | Get the generated session handout for a game session, including summary, outlines, spotlights, and notable moments. |\n\n### Story Structure\n\n| Tool | Description |\n|------|-------------|\n| `list_beats` | List beats ordered by index. Beats represent story moments (major, minor, step). |\n| `get_beat` | Get a specific beat by ID. |\n| `list_moments` | List moments in a campaign or session. Moments capture memorable quotes and events. |\n| `get_moment` | Get a specific moment by ID. |\n\n### World Building\n\n| Tool | Description |\n|------|-------------|\n| `list_characters` | List characters in a campaign. Filter by name, type (PC/NPC), or approval status. |\n| `get_character` | Get a character by ID including aliases, backstory, and speaker linkage. |\n| `list_factions` | List factions. Factions represent guilds, organisations, or other groups. |\n| `get_faction` | Get a specific faction by ID. |\n| `list_locations` | List locations. Locations can be nested (cities, taverns, dungeons, etc.). |\n| `get_location` | Get a specific location by ID. |\n| `list_items` | List items. Items include weapons, armour, artefacts, and other notable objects. |\n| `get_item` | Get a specific item by ID. |\n\n### Quests\n\n| Tool | Description |\n|------|-------------|\n| `list_quests` | List quests with pagination. Filter by status or category. |\n| `get_quest` | Get a fully expanded quest: objectives, progress log, related entities, session provenance. |\n\n### Journals\n\n| Tool | Description |\n|------|-------------|\n| `list_journals` | List journal entries. Content omitted from list; use get_journal for full content. |\n| `get_journal` | Get a journal entry by ID including full content and permission level. |\n| `list_journal_folders` | List journal folders ordered by path and position for tree rendering. |\n| `get_journal_folder` | Get a specific journal folder by ID. |\n\n### Relationships\n\n| Tool | Description |\n|------|-------------|\n| `list_links` | List links between entities. Filter by source/target entity and relationship alias. |\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106],"license","MIT","language","PHP","registryName","io.github.Astrotomic/archivist-ai","homepage","https://developers.myarchivist.ai/mcp","mcp","mcp-server","ENV",{"_109":110,"_111":112,"_113":114},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]