
Argo Mcp
If you're running tabletop campaigns in Argo and want your AI assistant to pull character sheets, update lore, or prep sessions without switching windows, this is the bridge. It wraps Argo's campaign API behind OAuth2 and surfaces read/write tools for lore entries, character lookups, and session data. You can wire it into Claude Desktop, VS Code, or ChatGPT via stdio or the hosted HTTP endpoint at mcp.argo.games. The repo includes a companion skill pack (argo-agent-skills) with workflows for session prep, NPC generation, and post-game recaps. Auth is handled either through a local token store (npx argo-mcp auth login) or by environment variables for CI and Docker. One-click install buttons use VS Code's vscode:mcp/install protocol with dynamic client registration.
- tools
- 65
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 3
- last updated
- May 14, 2026
Install
From registry metadata$ npx add-mcp https://mcp.argo.games/mcp --name argo-mcpRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http argo-mcp https://mcp.argo.games/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 65 toolsVerified live against the running server on Nov 6, 2026.
list_campaignsList 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 st...
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 st...
No parameters. Call it with no arguments.
get_campaignRetrieve details of an Argo campaign (name, description, rule system, co-GMs).1 params
Retrieve details of an Argo campaign (name, description, rule system, co-GMs).
campaignId*stringcreate_campaignCreate 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.4 params
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.
campaignName*stringdescription*stringgameSystemSlugstringruleSystem*stringupdate_campaignUpdate 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.3 params
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.
campaignDescriptionstringcampaignId*stringcampaignNamestringlist_co_gmsList the assistant GMs (co-GMs) of a campaign.1 params
List the assistant GMs (co-GMs) of a campaign.
campaignId*stringadd_co_gmSend a user an assistant GM (co-GM) offer for a campaign. This does NOT add them immediately: the target must accept the offer before they become an assistant GM. Owner-only — the calling user must be the campaign's primary GM. Maximum 5 co-GMs per campaign.2 params
Send a user an assistant GM (co-GM) offer for a campaign. This does NOT add them immediately: the target must accept the offer before they become an assistant GM. Owner-only — the calling user must be the campaign's primary GM. Maximum 5 co-GMs per campaign.
campaignId*stringuserId*stringremove_co_gmRemove a co-GM from a campaign. Owner-only or self-removal.2 params
Remove a co-GM from a campaign. Owner-only or self-removal.
campaignId*stringuserId*stringdescribe_mnemon_typesReturns 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. A person is an NPC and a fa...
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. A person is an NPC and a fa...
No parameters. Call it with no arguments.
list_mnemonsList 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). To find entries by what they CONTAIN, use search_mnemons instead. Returns up to `limit` entries (default 1...5 params
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). To find entries by what they CONTAIN, use search_mnemons instead. Returns up to `limit` entries (default 1...
campaignId*stringlimitintegeroffsetintegertitlestringtypestringsearch_mnemonsFull-text search across mnemon titles, tags, and body content (case-insensitive substring). Prefer this over list_mnemons when looking for entries by what they contain — e.g. "what do we know about the Red Oracle?". Each hit reports which fields matched (title/tags/content) an...4 params
Full-text search across mnemon titles, tags, and body content (case-insensitive substring). Prefer this over list_mnemons when looking for entries by what they contain — e.g. "what do we know about the Red Oracle?". Each hit reports which fields matched (title/tags/content) an...
campaignId*stringlimitintegerquery*stringtypestringget_mnemonGet the full details of a specific mnemon entry (title, blocks, type properties). For a quest, `quest` holds its status, kind, playersCanTick, objectives and reward chips (with their ids), progress and reward totals, as the current user may see them — read objectives and rewar...2 params
Get the full details of a specific mnemon entry (title, blocks, type properties). For a quest, `quest` holds its status, kind, playersCanTick, objectives and reward chips (with their ids), progress and reward totals, as the current user may see them — read objectives and rewar...
campaignId*stringentryId*stringlist_mnemon_relationshipsList 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.2 params
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.
campaignId*stringentryId*stringcreate_npc_mnemonsCreate NPC mnemons (individual people). role is an optional free-text role or occupation. Use affiliationEntryIds to name the factions each NPC belongs to; the server projects them into MEMBER relationships. For a faction, guild or cult use create_faction_mnemons. Players may...2 params
Create NPC mnemons (individual people). role is an optional free-text role or occupation. Use affiliationEntryIds to name the factions each NPC belongs to; the server projects them into MEMBER relationships. For a faction, guild or cult use create_faction_mnemons. Players may...
campaignId*stringitems*arraycreate_faction_mnemonsCreate Faction mnemons (factions, guilds, cults, companies). Use memberNpcEntryIds to name each faction's NPC members; the server projects them into MEMBER relationships. Players may not call this — GM/co-GM only.2 params
Create Faction mnemons (factions, guilds, cults, companies). Use memberNpcEntryIds to name each faction's NPC members; the server projects them into MEMBER relationships. Players may not call this — GM/co-GM only.
campaignId*stringitems*arraycreate_location_mnemonsCreate 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.2 params
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.
campaignId*stringitems*arraycreate_quest_mnemonsCreate Quest mnemons: a header (status, kind, playersCanTick, hook, and giverId / locationId / parentQuestId links) and a body of objectives (with sub-objectives), reward chips, a Markdown background and GM-only gmNotes. The server builds the quest the Argo app shows from thes...2 params
Create Quest mnemons: a header (status, kind, playersCanTick, hook, and giverId / locationId / parentQuestId links) and a body of objectives (with sub-objectives), reward chips, a Markdown background and GM-only gmNotes. The server builds the quest the Argo app shows from thes...
campaignId*stringitems*arraycreate_lore_mnemonsCreate Lore mnemons (world background, factions' beliefs, history). Players may not call this — GM/co-GM only.2 params
Create Lore mnemons (world background, factions' beliefs, history). Players may not call this — GM/co-GM only.
campaignId*stringitems*arraycreate_archive_mnemonsCreate Archive mnemons (archived lore that is no longer current). Players may not call this — GM/co-GM only.2 params
Create Archive mnemons (archived lore that is no longer current). Players may not call this — GM/co-GM only.
campaignId*stringitems*arraycreate_journal_mnemonsCreate Journal mnemons (log of in-world events). Players may not call this — GM/co-GM only.2 params
Create Journal mnemons (log of in-world events). Players may not call this — GM/co-GM only.
campaignId*stringitems*arraycreate_session_summary_mnemonsCreate SessionSummary mnemons (the memory of one played session): the story as the Markdown body, plus a short recap shown as "Previously on". Players may not call this — GM/co-GM only.2 params
Create SessionSummary mnemons (the memory of one played session): the story as the Markdown body, plus a short recap shown as "Previously on". Players may not call this — GM/co-GM only.
campaignId*stringitems*arraycreate_custom_mnemonsCreate custom-typed mnemons (any free-form entry that doesn't fit the other types). Players may not call this — GM/co-GM only.2 params
Create custom-typed mnemons (any free-form entry that doesn't fit the other types). Players may not call this — GM/co-GM only.
campaignId*stringitems*arrayupdate_npc_mnemonsUpdate typed/meta fields of NPC mnemons (visibility, tags, role, faction membership, etc.). An entry that is not an NPC fails its item; use update_faction_mnemons for a faction. Does NOT modify content blocks — use update_mnemons_content for that. Set visibility=PUBLIC on mult...2 params
Update typed/meta fields of NPC mnemons (visibility, tags, role, faction membership, etc.). An entry that is not an NPC fails its item; use update_faction_mnemons for a faction. Does NOT modify content blocks — use update_mnemons_content for that. Set visibility=PUBLIC on mult...
campaignId*stringitems*arrayupdate_faction_mnemonsUpdate typed/meta fields of Faction mnemons (visibility, tags, members). An entry that is not a Faction fails its item. Does NOT modify content blocks — use update_mnemons_content for that.2 params
Update typed/meta fields of Faction mnemons (visibility, tags, members). An entry that is not a Faction fails its item. Does NOT modify content blocks — use update_mnemons_content for that.
campaignId*stringitems*arrayupdate_location_mnemonsUpdate typed/meta fields of Location mnemons.2 params
Update typed/meta fields of Location mnemons.
campaignId*stringitems*arrayupdate_quest_mnemonsUpdate Quest mnemons. A field left out is left as it is: status, kind, playersCanTick, hook, the giverId / locationId / parentQuestId links (an empty string removes one), and objectives, rewards, background or gmNotes, each of which replaces its part of the quest and keeps the...2 params
Update Quest mnemons. A field left out is left as it is: status, kind, playersCanTick, hook, the giverId / locationId / parentQuestId links (an empty string removes one), and objectives, rewards, background or gmNotes, each of which replaces its part of the quest and keeps the...
campaignId*stringitems*arrayupdate_lore_mnemonsUpdate typed/meta fields of Lore mnemons.2 params
Update typed/meta fields of Lore mnemons.
campaignId*stringitems*arrayupdate_archive_mnemonsUpdate typed/meta fields of Archive mnemons.2 params
Update typed/meta fields of Archive mnemons.
campaignId*stringitems*arrayupdate_journal_mnemonsUpdate typed/meta fields of Journal mnemons.2 params
Update typed/meta fields of Journal mnemons.
campaignId*stringitems*arrayupdate_session_summary_mnemonsUpdate the recap, date, number and meta fields of SessionSummary mnemons. To change the story, use update_mnemons_content.2 params
Update the recap, date, number and meta fields of SessionSummary mnemons. To change the story, use update_mnemons_content.
campaignId*stringitems*arrayupdate_player_mnemonsUpdate typed/meta fields of Player mnemons — one per character in a party. Player mnemons cannot be created: the server makes one for each character that joins a party. Who may edit an entry is decided by its own permissions.2 params
Update typed/meta fields of Player mnemons — one per character in a party. Player mnemons cannot be created: the server makes one for each character that joins a party. Who may edit an entry is decided by its own permissions.
campaignId*stringitems*arrayupdate_party_mnemonsUpdate typed/meta fields of PlayerParty mnemons — one per party in the campaign. PlayerParty mnemons cannot be created: the server makes one for each party. Who may edit an entry is decided by its own permissions.2 params
Update typed/meta fields of PlayerParty mnemons — one per party in the campaign. PlayerParty mnemons cannot be created: the server makes one for each party. Who may edit an entry is decided by its own permissions.
campaignId*stringitems*arrayupdate_custom_mnemonsUpdate typed/meta fields of Custom-typed mnemons.2 params
Update typed/meta fields of Custom-typed mnemons.
campaignId*stringitems*arrayset_quest_objective_stateTick, fail or reopen one objective of a quest by its id (get_mnemon's quest.objectives[].id), at any depth, without rewriting the quest. A GM sets any state. A player may only tick an objective they can see done, or undo that, and only while the quest's playersCanTick is on. R...4 params
Tick, fail or reopen one objective of a quest by its id (get_mnemon's quest.objectives[].id), at any depth, without rewriting the quest. A GM sets any state. A player may only tick an objective they can see done, or undo that, and only while the quest's playersCanTick is on. R...
campaignId*stringentryId*stringobjectiveId*stringstate*stringopen · done · failedupdate_mnemons_contentEdit the body content 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. Op content is authored as Markdown (headings, lists, quotes, code fences, bold/italic, links) — do...2 params
Edit the body content 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. Op content is authored as Markdown (headings, lists, quotes, code fences, bold/italic, links) — do...
campaignId*stringitems*arraycreate_mnemon_relationshipCreate a relationship between two mnemon entries. The label decides everything: its kind (containment or association) and how it reads (one_way or mutual) belong to the word itself — never send a per-edge override. All 16 labels: MEMBER (NPC ∈ Faction, mutual), ALLY (mutual),...6 params
Create a relationship between two mnemon entries. The label decides everything: its kind (containment or association) and how it reads (one_way or mutual) belong to the word itself — never send a per-edge override. All 16 labels: MEMBER (NPC ∈ Faction, mutual), ALLY (mutual),...
campaignId*stringcolorstringdirectionstringlabel*stringMEMBER · ALLY · ENEMY · RIVAL · PARENT_OF · CONTAINSsourceEntryId*stringtargetEntryId*stringdelete_mnemon_relationshipDelete a relationship by id.2 params
Delete a relationship by id.
campaignId*stringrelationshipId*stringdelete_mnemonPermanently delete a mnemon entry and every relationship that touches it. GM-only on the backend. This cannot be undone — confirm with the user before calling. entryId accepts a hex id or an exact title.2 params
Permanently delete a mnemon entry and every relationship that touches it. GM-only on the backend. This cannot be undone — confirm with the user before calling. entryId accepts a hex id or an exact title.
campaignId*stringentryId*stringcreate_sessionSchedule a campaign session. Provide an ISO-8601 startAt; endAt is optional. Useful for laying out planned arcs or recurring play nights.6 params
Schedule a campaign session. Provide an ISO-8601 startAt; endAt is optional. Useful for laying out planned arcs or recurring play nights.
campaignId*stringdescriptionstringendAtstringinvitedUserIdsarraystartAt*stringtitle*stringlist_sessionsList campaign sessions for a given month (defaults to the current month).3 params
List campaign sessions for a given month (defaults to the current month).
campaignId*stringmonthintegeryearintegerget_sessionGet details of a single campaign session.2 params
Get details of a single campaign session.
campaignId*stringsessionId*stringupdate_sessionReschedule a campaign session or edit its title/description. All fields optional. Owner-only on the backend.6 params
Reschedule a campaign session or edit its title/description. All fields optional. Owner-only on the backend.
campaignId*stringdescriptionstringendAtstringsessionId*stringstartAtstringtitlestringlist_guildsList 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 fo...
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 fo...
No parameters. Call it with no arguments.
get_guildRetrieve full details of a guild (members, campaigns, calendar metadata).1 params
Retrieve full details of a guild (members, campaigns, calendar metadata).
guildId*stringlist_guild_membersList the members of a guild (id, role, status, invitedAt, joinedAt).1 params
List the members of a guild (id, role, status, invitedAt, joinedAt).
guildId*stringadd_campaign_to_guildAdd 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).2 params
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).
campaignId*stringguildId*stringinvite_guild_memberInvite a user to join the guild. Owner/Admin only.2 params
Invite a user to join the guild. Owner/Admin only.
guildId*stringuserId*stringremove_guild_memberRemove a member from the guild. Owner/Admin only.2 params
Remove a member from the guild. Owner/Admin only.
guildId*stringuserId*stringset_guild_member_roleChange 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.3 params
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.
guildId*stringrole*stringOwner · Admin · MemberuserId*stringadd_guild_calendar_eventAdd a new event to the guild's shared calendar. Owner/Admin only. startDateTime / endDateTime are ISO-8601 (e.g. 2026-06-12T19:00:00).5 params
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).
descriptionstringendDateTimestringguildId*stringstartDateTime*stringtitle*stringlist_friendsList the current user's accepted friends.
List the current user's accepted friends.
No parameters. Call it with no arguments.
list_sent_friend_requestsList outgoing friend requests that are still pending.
List outgoing friend requests that are still pending.
No parameters. Call it with no arguments.
list_received_friend_requestsList incoming friend requests awaiting your response.
List incoming friend requests awaiting your response.
No parameters. Call it with no arguments.
send_friend_requestSend a friend request to another Argo user.1 params
Send a friend request to another Argo user.
userId*stringaccept_friend_requestAccept an incoming friend request from the given user.1 params
Accept an incoming friend request from the given user.
userId*stringreject_friend_requestReject an incoming friend request from the given user.1 params
Reject an incoming friend request from the given user.
userId*stringcancel_friend_requestCancel a friend request you previously sent.1 params
Cancel a friend request you previously sent.
userId*stringforum_list_categoriesList 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.
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.
No parameters. Call it with no arguments.
forum_list_topicsList topics in a specific forum category. Provide categorySlug and/or categoryId — given only one, the other is resolved from the category list automatically. Use forum_list_categories to discover categories.2 params
List topics in a specific forum category. Provide categorySlug and/or categoryId — given only one, the other is resolved from the category list automatically. Use forum_list_categories to discover categories.
categoryIdintegercategorySlugstringforum_get_latest_topicsGet the latest active topics across all forum categories.
Get the latest active topics across all forum categories.
No parameters. Call it with no arguments.
forum_read_topicRead the full content of a forum topic including all posts and replies. Post bodies are returned as plain text (HTML markup is stripped).1 params
Read the full content of a forum topic including all posts and replies. Post bodies are returned as plain text (HTML markup is stripped).
topicId*integerforum_searchSearch 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.1 params
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.
q*stringforum_get_user_postsList topics created by the current user on the forum.
List topics created by the current user on the forum.
No parameters. Call it with no arguments.
forum_get_notificationsGet the current user's forum notifications (replies, mentions, likes).
Get the current user's forum notifications (replies, mentions, likes).
No parameters. Call it with no arguments.
forum_create_topicCreate 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.3 params
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.
categoryId*integerraw*stringtitle*stringforum_replyReply to an existing forum topic.2 params
Reply to an existing forum topic.
raw*stringtopicId*integerSponsors
Configuration
OAUTH_TOKEN*secretArgo OAuth2 access token from the consent flow at https://app.argo.games/oauth2/mcp-connect
REFRESH_TOKENsecretArgo OAuth2 refresh token. Enables automatic renewal of the access token when it expires (~1 hour).
ARGO_API_BASEOverride the Argo WebAPI base URL. Defaults to https://api.argo.games.
Readme
Argo MCP Server
Connects AI assistants to your Argo campaigns via the Model Context Protocol. Once configured, your AI assistant can read and write campaign lore, look up character details, and interact with Argo data directly from the chat interface.
Supported clients: Claude Code, Claude Desktop, OpenAI Codex, VS Code (1.103+), and any MCP-compatible host.
One-click install
Clicking either button hands a vscode:mcp/install URL to your editor with this config:
{ "type": "http", "url": "https://mcp.argo.games/mcp" }
Details
- Repository
- github.com/argo-rpg-platform/mcp
- Website
- app.argo.games/docs/mcp
- Categories
- Sales & Marketing, Data & Analytics
- Package
argo-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026