Archivist AI

Add to your AI

Remote MCP server (streamable HTTP). Most clients sign you in with the provider on first use.

Claude Code

claude mcp add --transport http archivist-ai https://mcp.myarchivist.ai/mcp

Claude Desktop, Cursor, Windsurf (mcp config)

{
  "mcpServers": {
    "archivist-ai": {
      "url": "https://mcp.myarchivist.ai/mcp"
    }
  }
}

ChatGPT: Settings → Connectors → add a custom connector with the URL above.

How to call Archivist AI from code (MCP)

Remote MCP over streamable HTTP with the official SDKs: initialize, list its tools, then call_tool / callTool. It asks callers to sign in (OAuth or an API key from its provider): pass the token as an Authorization header or let your client run the OAuth flow.

Python

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://mcp.myarchivist.ai/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

TypeScript

// npm i @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://mcp.myarchivist.ai/mcp")));
console.log((await client.listTools()).tools.map((t) => t.name));

A2A vs MCP: which one to use

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "archivist-ai" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="archivist-ai")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls via Rooms (30 days)

0

No calls through Rooms in the last 30 days yet. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Tools (40)

• List Campaigns Tool list-campaigns-tool
  List your MyArchivist campaigns. Returns a paginated list of campaigns.
• Get Campaign Tool get-campaign-tool
  Get a specific MyArchivist campaign by its ID.
• Get Campaign Stats Tool get-campaign-stats-tool
  Get statistics for a specific campaign: character count, session count, and more.
• Ask Campaign Tool ask-campaign-tool
  RAG ask endpoint for campaign questions.
• Create Campaign Tool create-campaign-tool
  Create a new MyArchivist campaign. Title is required; description, system (e.g. "D&D 5e"), summary, language, and tone fields are optional. Campaign creation is limited by the account's subscription tier; if the tier limit is exceeded the…
• Update Campaign Tool update-campaign-tool
  Partially update a MyArchivist campaign. Only the campaign owner can update; only fields included in the request are changed. Cannot be used on archived campaigns.
• List Characters Tool list-characters-tool
  List characters in a campaign. Optionally filter by name search, character type, and approval status.
• Get Character Tool get-character-tool
  Get a specific character by ID including aliases, backstory, and speaker linkage.
• Create Character Tool create-character-tool
  Create a new character (PC or NPC) in a campaign. After drafting description (and backstory for characters), before calling create: for each entity name referenced in the text, run list_characters/list_factions/list_locations/list_items wi…
• Update Character Tool update-character-tool
  Partially update a character. Only the fields you include are changed. When editing description or backstory, follow this order: (1) fetch the entity with with_links: true; (2) list_links with from_id set to this entity's id and from_type…
• Delete Character Tool delete-character-tool
  Delete a character. The API cleans up all outgoing and inbound Link rows and unbrackets [[alias]] markup in every referring text field (Character descriptions, session summaries, beat descriptions, moment content, journal entries) so no da…
• List Sessions Tool list-sessions-tool
  List game sessions in a campaign. Optionally filter by session type or public-only.
• Get Session Tool get-session-tool
  Get a specific game session by ID. Optionally include related beats and moments.
• Get Session Cast Analysis Tool get-session-cast-analysis-tool
  Get the cast analysis for a game session, including talk-share breakdown and core session metrics.
• Get Session Handout Tool get-session-handout-tool
  Get the generated session handout for a game session, including summary, outlines, spotlights, and notable moments.
• Get Session Transcript Tool get-session-transcript-tool
  Get the cleaned transcript for a game session, including utterances, full text, and aggregate stats.
• Patch Session Tool patch-session-tool
  Partially update a game session (limited fields: title, session_date, summary, notes, type, public, image). Omitted fields are left unchanged. notes holds the user-supplied content of rawNotes sessions. IMPORTANT: Sessions use the explicit…
• List Beats Tool list-beats-tool
  List beats in a campaign, ordered by index. Beats represent story moments (major, minor, step).
• Get Beat Tool get-beat-tool
  Get a specific beat by ID.
• Create Beat Tool create-beat-tool
  Create a new story beat in a campaign. Beats organize the campaign timeline (major/minor/step) and can be attached to one or more sessions or nested under a parent beat. IMPORTANT: Like sessions, beat descriptions use the explicit-link con…
• Update Beat Tool update-beat-tool
  Partially update a story beat. IMPORTANT: Beats use the explicit-link contract. On write, [[alias]] markup in description is only preserved if a Link row already exists for this beat with that alias; new wikilinks are silently dropped. To…
• Delete Beat Tool delete-beat-tool
  Delete a story beat. Child beats have their parent_id cleared. Any Link rows sourced from this beat are removed.
• List Moments Tool list-moments-tool
  List Key Moments (Moments) in a campaign or session. These are the same Moment records; the product now calls them Key Moments and they can carry an image plus presentation metadata (style, customTheme, variant). Filter by label search, co…
• Get Moment Tool get-moment-tool
  Get a Key Moment (Moment) by ID, including image URL, categories, kind, and presentation metadata. Pass with_links=true before editing content. Attach or replace the card image with init_image_upload (entity_type=moment) then complete_imag…
• Create Moment Tool create-moment-tool
  Create a Key Moment (Moment) attached to a session. For a Key Moment card, set categories=["key-moment"] and approved=true, pending=false. Optional image is a URL; to upload a file, create first then use init_image_upload with entity_type=…
• Update Moment Tool update-moment-tool
  Partially update a Key Moment (Moment), including image, categories, kind, and presentation metadata (merged into existing metadata so provenance keys are kept). IMPORTANT: Moments use the explicit-link contract, not the auto-resolve contr…
• Delete Moment Tool delete-moment-tool
  Delete a Key Moment (Moment). Any inbound/outbound Link rows for this moment are removed. Note: as a source of wikilinks, moments only appear as [[…]] in their own content (not in other entities' text), so no cross-record text rewriting is…
• List Hero Awards Tool list-hero-awards-tool
  List hero awards in a campaign or session. Hero awards are player achievement cards (title, description, character, optional player name, card style). Filter by title/description/character search.
• Get Hero Award Tool get-hero-award-tool
  Get a hero award by ID, including title, description, character/player names, card style, variant, and custom theme.
• Create Hero Award Tool create-hero-award-tool
  Create a hero award attached to a session. Requires title and description. Optional character_name, player_name, style (default verdant), variant (default square-v2), tone_mode (default), award_mode (moment or theme), and custom_theme. Her…

Automated check: 80/100

Last run 2026-10-12 22:35 UTC. What we measured, not a guarantee.

• 10/10Every URL is https.
• 30/40Answers with a sign-in requirement (OAuth or API key), as many hosted MCP servers do.
• 15/1540 tools listed in its server card.
• 10/10MCP server card at https://mcp.myarchivist.ai/.well-known/mcp/server-card.json.
• 10/10Has a homepage or documentation link.
• 5/5Answered in 146 ms.
• 0/10Not claimed with a domain proof yet.