# Archivist AI

> Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.

- **Type:** MCP server
- **Install:** `agentstack add mcp-astrotomic-mcp-myarchivist-ai`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Astrotomic](https://agentstack.voostack.com/s/astrotomic)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [Astrotomic](https://github.com/Astrotomic)
- **Source:** https://github.com/Astrotomic/mcp.myarchivist.ai
- **Website:** https://developers.myarchivist.ai/mcp

## Install

```sh
agentstack add mcp-astrotomic-mcp-myarchivist-ai
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Archivist AI MCP Server

[](https://github.com/Astrotomic/mcp.myarchivist.ai/blob/master/LICENSE)
[](https://plant.treeware.earth/Astrotomic/mcp.myarchivist.ai)
[](https://www.larabelles.com/)

[](https://github.com/Astrotomic/mcp.myarchivist.ai/actions/workflows/phpunit.yml)
[](https://github.com/Astrotomic/mcp.myarchivist.ai/actions/workflows/phpstan.yml)
[](https://github.com/Astrotomic/mcp.myarchivist.ai/actions/workflows/pint.yml)
[](https://github.com/Astrotomic/mcp.myarchivist.ai/actions/workflows/phpmnd.yml)

[](https://discord.gg/t3yk6AWyg7)
[](https://smithery.ai/servers/me-26lt/archivist-ai)
[](https://glama.ai/mcp/connectors/ai.myarchivist.mcp/mcp-archivist-ai)
[](https://mcp.so/server/archivist-ai/Archivist%20AI)

The official [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Archivist AI](https://www.myarchivist.ai) -- a TTRPG campaign memory platform for game masters and players.

Registry metadata lives in [`server.json`](./server.json). Publishing to the [official MCP Registry](https://modelcontextprotocol.io/registry) is automated on version tags via [`.github/workflows/publish-mcp.yml`](./.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`](https://github.com/geelen/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):
```json
{
  "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](https://app.myarchivist.ai). Restart Claude Desktop after saving.

Cursor

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

Windsurf

Add to your MCP configuration:
```json
{
  "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. |

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Astrotomic](https://github.com/Astrotomic)
- **Source:** [Astrotomic/mcp.myarchivist.ai](https://github.com/Astrotomic/mcp.myarchivist.ai)
- **License:** MIT
- **Homepage:** https://developers.myarchivist.ai/mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-astrotomic-mcp-myarchivist-ai
- Seller: https://agentstack.voostack.com/s/astrotomic
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.