# archivist-ai

Archivist AI is an AI-powered assistant for tabletop RPG campaigns. Connect your Archivist account to search campaign lore, summarize sessions, retrieve character and faction details, and ask questio…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add me-26lt/archivist-ai

# Browse available tools
npx -y smithery tool list me-26lt/archivist-ai

# Get full schema for a tool
npx -y smithery tool get me-26lt/archivist-ai list_campaigns

# Call a tool
npx -y smithery tool call me-26lt/archivist-ai list_campaigns '{}'
```

## Direct MCP Connection

Endpoint: `https://archivist-ai--me-26lt.run.tools`

## Tools (25)

- `list_campaigns` — List your MyArchivist campaigns. Returns a paginated list of campaigns.
- `get_campaign` — Get a specific MyArchivist campaign by its ID.
- `get_campaign_stats` — Get statistics for a specific campaign: character count, session count, and more.
- `list_characters` — List characters in a campaign. Optionally filter by name search, character type, and approval status.
- `get_character` — Get a specific character by ID including aliases, backstory, and speaker linkage.
- `list_sessions` — List game sessions in a campaign. Optionally filter by session type or public-only.
- `get_session` — Get a specific game session by ID. Optionally include related beats and moments.
- `get_session_cast_analysis` — Get the cast analysis for a game session, including talk-share breakdown and core session metrics.
- `list_beats` — List beats in a campaign, 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.
- `list_factions` — List factions in a campaign. Factions represent guilds, organisations, or other groups.
- `get_faction` — Get a specific faction by ID.
- `list_locations` — List locations in a campaign. Locations can be nested (cities, taverns, dungeons, etc.).
- `get_location` — Get a specific location by ID.
- `list_items` — List items in a campaign. Items include weapons, armour, artefacts, and other notable objects.
- `get_item` — Get a specific item by ID.
- `list_quests` — List quests in a campaign with pagination. Filter by status (planned, in-progress, blocked, failed, done, n/a) or categ…
- `get_quest` — Get a fully expanded quest by ID, including objectives, progress log, related entity refs, and session provenance.
- `list_journals` — List journal entries in a campaign. Results are filtered to entries the caller can see. Content is omitted from the lis…
- `get_journal` — Get a specific journal entry by ID including full content and the caller's effective permission level.
- `list_journal_folders` — List journal folders for a campaign. Folders are ordered by path and position for tree rendering.
- `get_journal_folder` — Get a specific journal folder by ID.
- `list_links` — List links between entities in a campaign. Supports filtering by source/target entity and relationship alias.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get me-26lt/archivist-ai <tool-name>
```