# argo-mcp MCP server

MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-argo-rpg-platform-argo-mcp
- Repository: https://github.com/Argo-RPG-Platform/MCP
- Website: https://app.argo.games/docs/mcp

## Install
- Command: `npx -y argo-mcp`
- Endpoint: https://mcp.argo.games/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm argo-mcp v1.0.3
- Environment variable: OAUTH_TOKEN (required; secret)
- Environment variable: REFRESH_TOKEN (secret)
- Environment variable: ARGO_API_BASE
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.argo.games/mcp

## Tools
- list_campaigns - List all Argo campaigns the current grant token has access to, including the access level ("read" or "read+write") for each. Call this first when the user has not provided a campaign ID. Each entry includes both `campaignName` and `id` (shown inline as `[id: …]` and also in structuredContent.idMap). Use the `id` verbatim for any subsequent tool call that takes a `campaignId`. In prose to the user, refer to campaigns by `campaignName`; do not print the raw `id` unless asked. Endpoint: https://mcp.argo.games/mcp
- get_campaign - Retrieve details of an Argo campaign (name, description, rule system, co-GMs). Endpoint: https://mcp.argo.games/mcp
- create_campaign - Create a new Argo campaign. The current user becomes GM and the calling token gains read+write access to the new campaign immediately (no re-consent needed). Requires the campaign.create OAuth scope, granted at consent time. Endpoint: https://mcp.argo.games/mcp
- update_campaign - Update a campaign's display name and/or description. Both fields optional — only supplied fields are changed; pass an empty string to clear the description. GMs and co-GMs can call this; rule-system swaps remain WebApp-only. Endpoint: https://mcp.argo.games/mcp
- list_co_gms - List the assistant GMs (co-GMs) of a campaign. Endpoint: https://mcp.argo.games/mcp
- add_co_gm - Add a user as an assistant GM (co-GM) of a campaign. Owner-only — the calling user must be the campaign's primary GM. Maximum 5 co-GMs per campaign. Endpoint: https://mcp.argo.games/mcp
- remove_co_gm - Remove a co-GM from a campaign. Owner-only or self-removal. Endpoint: https://mcp.argo.games/mcp
- describe_mnemon_types - Returns a catalog of all mnemon types, their type-specific fields, and the full valid relationship matrix (sourceType → label → targetType). Call this before create_mnemon or create_mnemon_relationship when you are unsure which type or label to use. NPC subtype is strictly FACTION | INDIVIDUAL. Endpoint: https://mcp.argo.games/mcp
- list_mnemons - List mnemon (lore/memory) entries for an Argo campaign. Optional filters: `title` (case-insensitive substring on entry title only) and `type` (e.g. NPC, Location, Quest). Returns all matching entries — pagination is automatic. Each entry includes both `title` and `entryId` (shown inline as `[id: …]` and in structuredContent.idMap). Use the `entryId` verbatim for any tool that takes one; refer to entries by `title` in prose to the user. Endpoint: https://mcp.argo.games/mcp
- get_mnemon - Get the full details of a specific mnemon entry (title, blocks, type properties). Endpoint: https://mcp.argo.games/mcp
- list_mnemon_relationships - List the relationships of a mnemon entry, split into outgoing edges, incoming edges, and a flat list of linked entries (entryId/title/type/relationshipTypes). Use this to find members of a faction, allies/enemies of an NPC, etc. Endpoint: https://mcp.argo.games/mcp
- create_npc_mnemons - Create NPC mnemons (FACTION or INDIVIDUAL). npcType is REQUIRED on each item. Use memberNpcEntryIds (on FACTIONs) and affiliationEntryIds (on INDIVIDUALs) to wire membership; the server projects into MEMBER relationships. Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_location_mnemons - Create Location mnemons (places — cities, dungeons, taverns). Use create_mnemon_relationship with PARENT_OF to nest larger places under one another after creation. Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_quest_mnemons - Create Quest mnemons. questStatus is one of active|completed|failed. Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_lore_mnemons - Create Lore mnemons (world background, factions' beliefs, history). Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_archive_mnemons - Create Archive mnemons (archived lore that is no longer current). Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_journal_mnemons - Create Journal mnemons (log of in-world events). Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_session_summary_mnemons - Create SessionSummary mnemons (structured summaries of game sessions). Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- create_player_mnemons - Create Player mnemons (party root, character notes, party notes). For playerKind=CHARACTER, supply parentEntryId (the PARTY mnemon), partyId (CampaignParty.id), and characterId (SessionCharacter id) or the entry will be auto-detached. Players with campaign.write may call this for a party they belong to; GMs may call for any party. Endpoint: https://mcp.argo.games/mcp
- create_custom_mnemons - Create custom-typed mnemons (any free-form entry that doesn't fit the other types). Players may not call this — GM/co-GM only. Endpoint: https://mcp.argo.games/mcp
- update_npc_mnemons - Update typed/meta fields of NPC mnemons (visibility, tags, npcType, faction membership, etc.). Does NOT modify content blocks — use update_mnemons_content for that. Set visibility=PUBLIC on multiple NPCs in a single call by listing them in items[]. Endpoint: https://mcp.argo.games/mcp
- update_location_mnemons - Update typed/meta fields of Location mnemons. Endpoint: https://mcp.argo.games/mcp
- update_quest_mnemons - Update typed/meta fields of Quest mnemons (status transitions, expiry, related entries). Endpoint: https://mcp.argo.games/mcp
- update_lore_mnemons - Update typed/meta fields of Lore mnemons. Endpoint: https://mcp.argo.games/mcp
- update_archive_mnemons - Update typed/meta fields of Archive mnemons. Endpoint: https://mcp.argo.games/mcp
- update_journal_mnemons - Update typed/meta fields of Journal mnemons. Endpoint: https://mcp.argo.games/mcp
- update_session_summary_mnemons - Update typed/meta fields of SessionSummary mnemons. Endpoint: https://mcp.argo.games/mcp
- update_player_mnemons - Update typed/meta fields of Player mnemons. Endpoint: https://mcp.argo.games/mcp
- update_custom_mnemons - Update typed/meta fields of Custom-typed mnemons. Endpoint: https://mcp.argo.games/mcp
- update_mnemons_content - Edit the content blocks of one or more mnemon entries. Each item carries an entryId and an ordered list of ops (append, insertAfter, replace, remove) applied atomically per entry. Block addressing: get block ids from get_mnemon, then target them in replace/remove/insertAfter. New blocks (append, insertAfter, replace) get fresh server-generated UUIDs. Text in block 'text' is HTML — use <b>, <i>, <a>, <br>, <img>; do NOT use Markdown like '**bold**' or '# heading'. Use blockType for paragraph/heading1/heading2/bullet_list/numbered_list/todo/quote/code/callout/divider/image. Inline <img src="data:..."> or <img src="https://..."> is uploaded to the campaign asset bucket and the src is rewritten to asset:<id>. SSRF-blocked / oversize / failed fetches are stripped with a warning. On a bad op (missing blockId, unknown blockType, etc.) the whole entry's batch is rejected with the failedOpIndex; no partial mutation per entry. Endpoint: https://mcp.argo.games/mcp
- create_mnemon_relationship - Create a relationship between two mnemon entries. All 7 labels: MEMBER (NPC ∈ Faction, bidirectional), ALLY (bidirectional), ENEMY (directional), RIVAL (directional), PARENT_OF (Location hierarchy — sourceEntryId is the outer/larger place, e.g. Region → City → District → Tavern), CONTAINS (Location → NPC present there), LOCATED_IN (NPC → Location; inverse of CONTAINS). sourceEntryId is the 'from' side; targetEntryId is the 'to' side — direction matters. Call describe_mnemon_types for the full valid (sourceType, label, targetType) matrix. For faction membership prefer memberNpcEntryIds / affiliationEntryIds on the NPC itself. Endpoint: https://mcp.argo.games/mcp
- delete_mnemon_relationship - Delete a relationship by id. Endpoint: https://mcp.argo.games/mcp
- create_session - Schedule a campaign session. Provide an ISO-8601 startAt; endAt is optional. Useful for laying out planned arcs or recurring play nights. Endpoint: https://mcp.argo.games/mcp
- list_sessions - List campaign sessions for a given month (defaults to the current month). Endpoint: https://mcp.argo.games/mcp
- get_session - Get details of a single campaign session. Endpoint: https://mcp.argo.games/mcp
- update_session - Reschedule a campaign session or edit its title/description. All fields optional. Owner-only on the backend. Endpoint: https://mcp.argo.games/mcp
- list_guilds - List the guilds the current user belongs to, with role (Owner/Admin/Member), member count, and campaign count. Requires the guild.read scope. Each entry includes both `name` and `guildId` (shown inline as `[id: …]` and in structuredContent.idMap). Use the `guildId` verbatim for any tool that takes one; refer to guilds by `name` in prose to the user. Endpoint: https://mcp.argo.games/mcp
- get_guild - Retrieve full details of a guild (members, campaigns, calendar metadata). Endpoint: https://mcp.argo.games/mcp
- list_guild_members - List the members of a guild (id, role, status, invitedAt, joinedAt). Endpoint: https://mcp.argo.games/mcp
- add_campaign_to_guild - Add a campaign to a guild. Any active member of the guild can do this; the calling user must be the campaign's GM (enforced server-side). Endpoint: https://mcp.argo.games/mcp
- invite_guild_member - Invite a user to join the guild. Owner/Admin only. Endpoint: https://mcp.argo.games/mcp
- remove_guild_member - Remove a member from the guild. Owner/Admin only. Endpoint: https://mcp.argo.games/mcp
- set_guild_member_role - Change a guild member's role to Owner, Admin, or Member. Owner/Admin only. Note that promoting another user to Owner transfers the guild — confirm with the user first. Endpoint: https://mcp.argo.games/mcp
- add_guild_calendar_event - Add a new event to the guild's shared calendar. Owner/Admin only. startDateTime / endDateTime are ISO-8601 (e.g. 2026-06-12T19:00:00). Endpoint: https://mcp.argo.games/mcp
- list_friends - List the current user's accepted friends. Endpoint: https://mcp.argo.games/mcp
- list_sent_friend_requests - List outgoing friend requests that are still pending. Endpoint: https://mcp.argo.games/mcp
- list_received_friend_requests - List incoming friend requests awaiting your response. Endpoint: https://mcp.argo.games/mcp
- send_friend_request - Send a friend request to another Argo user. Endpoint: https://mcp.argo.games/mcp
- accept_friend_request - Accept an incoming friend request from the given user. Endpoint: https://mcp.argo.games/mcp
- reject_friend_request - Reject an incoming friend request from the given user. Endpoint: https://mcp.argo.games/mcp
- cancel_friend_request - Cancel a friend request you previously sent. Endpoint: https://mcp.argo.games/mcp
- invite_user_by_email - Send Argo email invitations to up to 20 addresses on behalf of the current user. Recipients receive a sign-up link. No campaign or guild context is required. Endpoint: https://mcp.argo.games/mcp
- forum_list_categories - List all Discourse forum categories at community.argo.games. Call this first when the user wants to post a bug report or feature request — you need the categoryId to create a topic. Endpoint: https://mcp.argo.games/mcp
- forum_list_topics - List topics in a specific forum category. Use forum_list_categories to get category slugs and IDs. Endpoint: https://mcp.argo.games/mcp
- forum_get_latest_topics - Get the latest active topics across all forum categories. Endpoint: https://mcp.argo.games/mcp
- forum_read_topic - Read the full content of a forum topic including all posts and replies. Endpoint: https://mcp.argo.games/mcp
- forum_search - Search forum topics and posts. Supports Discourse search syntax: #category-slug to filter by category, @username to filter by author. Always search before creating a bug report or feature request to avoid duplicates. Endpoint: https://mcp.argo.games/mcp
- forum_get_user_posts - List topics created by the current user on the forum. Endpoint: https://mcp.argo.games/mcp
- forum_get_notifications - Get the current user's forum notifications (replies, mentions, likes). Endpoint: https://mcp.argo.games/mcp
- forum_create_topic - Create a new forum topic (bug report, feature request, or general discussion). Always call forum_search first to check for duplicates. Call forum_list_categories to get the correct categoryId. Endpoint: https://mcp.argo.games/mcp
- forum_reply - Reply to an existing forum topic. Endpoint: https://mcp.argo.games/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.Argo-RPG-Platform
- Version: 1.0.3
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 14, 2026
- Source: https://registry.modelcontextprotocol.io