Summary
This is a read-only remote server that connects Claude and other MCP clients to the Archivist AI TTRPG campaign management platform. It exposes 30+ tools for querying campaign data including characters, sessions with transcripts and handouts, story beats and moments, quests, journals, locations, factions, and items. You get list and get operations for each entity type, plus specialized tools like session cast analysis and relationship links between entities. Useful if you're running tabletop campaigns through Archivist AI and want Claude to reference your world building, session notes, or character backstories during conversations. Requires an API key from app.myarchivist.ai. Write operations are planned but not yet available.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
25 tools
list_campaignsList your MyArchivist campaigns. Returns a paginated list of campaigns.2 params
List your MyArchivist campaigns. Returns a paginated list of campaigns.
Parameters* required
pageintegerPage number (default: 1).
sizeintegerPage size (default: 20).
get_campaignGet a specific MyArchivist campaign by its ID.1 params
Get a specific MyArchivist campaign by its ID.
Parameters* required
campaign_idstringCampaign UUID.
get_campaign_statsGet statistics for a specific campaign: character count, session count, and more.1 params
Get statistics for a specific campaign: character count, session count, and more.
Parameters* required
campaign_idstringCampaign UUID.
list_charactersList characters in a campaign. Optionally filter by name search, character type, and approval status.3 params
List characters in a campaign. Optionally filter by name search, character type, and approval status.
Parameters* required
pageintegersizeintegercampaign_idstringget_characterGet a specific character by ID including aliases, backstory, and speaker linkage.1 params
Get a specific character by ID including aliases, backstory, and speaker linkage.
Parameters* required
character_idstringlist_sessionsList game sessions in a campaign. Optionally filter by session type or public-only.3 params
List game sessions in a campaign. Optionally filter by session type or public-only.
Parameters* required
pageintegersizeintegercampaign_idstringget_sessionGet a specific game session by ID. Optionally include related beats and moments.1 params
Get a specific game session by ID. Optionally include related beats and moments.
Parameters* required
session_idstringget_session_cast_analysisGet the cast analysis for a game session, including talk-share breakdown and core session metrics.1 params
Get the cast analysis for a game session, including talk-share breakdown and core session metrics.
Parameters* required
session_idstringlist_beatsList beats in a campaign, ordered by index. Beats represent story moments (major, minor, step).3 params
List beats in a campaign, ordered by index. Beats represent story moments (major, minor, step).
Parameters* required
pageintegersizeintegercampaign_idstringget_beatGet a specific beat by ID.1 params
Get a specific beat by ID.
Parameters* required
beat_idstringlist_momentsList moments in a campaign or session. Moments capture memorable quotes and events.3 params
List moments in a campaign or session. Moments capture memorable quotes and events.
Parameters* required
pageintegersizeintegercampaign_idstringget_momentGet a specific moment by ID.1 params
Get a specific moment by ID.
Parameters* required
moment_idstringlist_factionsList factions in a campaign. Factions represent guilds, organisations, or other groups.3 params
List factions in a campaign. Factions represent guilds, organisations, or other groups.
Parameters* required
pageintegersizeintegercampaign_idstringget_factionGet a specific faction by ID.1 params
Get a specific faction by ID.
Parameters* required
faction_idstringlist_locationsList locations in a campaign. Locations can be nested (cities, taverns, dungeons, etc.).3 params
List locations in a campaign. Locations can be nested (cities, taverns, dungeons, etc.).
Parameters* required
pageintegersizeintegercampaign_idstringget_locationGet a specific location by ID.1 params
Get a specific location by ID.
Parameters* required
location_idstringlist_itemsList items in a campaign. Items include weapons, armour, artefacts, and other notable objects.3 params
List items in a campaign. Items include weapons, armour, artefacts, and other notable objects.
Parameters* required
pageintegersizeintegercampaign_idstringget_itemGet a specific item by ID.1 params
Get a specific item by ID.
Parameters* required
item_idstringlist_questsList quests in a campaign with pagination. Filter by status (planned, in-progress, blocked, failed, done, n/a) or category (main, side, faction, personal, n/a).3 params
List quests in a campaign with pagination. Filter by status (planned, in-progress, blocked, failed, done, n/a) or category (main, side, faction, personal, n/a).
Parameters* required
pageintegersizeintegercampaign_idstringget_questGet a fully expanded quest by ID, including objectives, progress log, related entity refs, and session provenance.1 params
Get a fully expanded quest by ID, including objectives, progress log, related entity refs, and session provenance.
Parameters* required
quest_idstringlist_journalsList journal entries in a campaign. Results are filtered to entries the caller can see. Content is omitted from the list; use get_journal to fetch full content.3 params
List journal entries in a campaign. Results are filtered to entries the caller can see. Content is omitted from the list; use get_journal to fetch full content.
Parameters* required
pageintegersizeintegercampaign_idstringget_journalGet a specific journal entry by ID including full content and the caller's effective permission level.1 params
Get a specific journal entry by ID including full content and the caller's effective permission level.
Parameters* required
journal_idstringlist_journal_foldersList journal folders for a campaign. Folders are ordered by path and position for tree rendering.1 params
List journal folders for a campaign. Folders are ordered by path and position for tree rendering.
Parameters* required
campaign_idstringget_journal_folderGet a specific journal folder by ID.1 params
Get a specific journal folder by ID.
Parameters* required
folder_idstringlist_linksList links between entities in a campaign. Supports filtering by source/target entity and relationship alias.3 params
List links between entities in a campaign. Supports filtering by source/target entity and relationship alias.
Parameters* required
pageintegersizeintegercampaign_idstringArchivist 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. |
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
