[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_103":104},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@argo-rpg-platform/mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":57,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","argo-rpg-platform","moduleId","mcp","@argo-rpg-platform/mcp","displayName","MCP","tagline","MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2","iconKey","https://avatars.githubusercontent.com/u/200429031?v=4","category","data","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.argo.games/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363307000,"updatedAt",1781499468000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Argo-RPG-Platform%2Fargo-mcp","sourceVerified",true,"importedAt","upstreamStars",0,"upstreamUpdatedAt",1780480748000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/Argo-RPG-Platform/MCP","githubRepoFullName","Argo-RPG-Platform/MCP","releaseId","ext-argo-rpg-platform-mcp","version","1.0.3","descriptionMarkdown","# Argo MCP Server\n\nConnects AI assistants to your Argo campaigns via the [Model Context Protocol](https://modelcontextprotocol.io). 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.\n\nSupported clients: Claude Code, Claude Desktop, OpenAI Codex, VS Code (1.103+), and any MCP-compatible host.\n\n## One-click install\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Argo_MCP-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?name=argo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.argo.games%2Fmcp%22%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Argo_MCP-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode-insiders:mcp/install?name=argo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.argo.games%2Fmcp%22%7D)\n\nClicking either button hands a `vscode:mcp/install` URL to your editor with this config:\n\n```json\n{ \"type\": \"http\", \"url\": \"https://mcp.argo.games/mcp\" }\n```\n\nVS Code stores the entry in your user-level `mcp.json`, then negotiates OAuth on first connect via Dynamic Client Registration against the Argo authorization server. No tokens are embedded in the URL — VS Code stores the resulting access and refresh tokens in your OS keychain.\n\n**Linux / Flatpak / Snap note:** If clicking the button doesn't open VS Code, the `vscode:` URL handler isn't registered. This is common on:\n\n- **Flatpak / Snap VS Code** — the sandbox isolates the install from the host, so the host browser can't find the protocol handler.\n- **Tarball / manual installs** — no postinst hook runs `update-desktop-database`. Either run `xdg-mime default code.desktop x-scheme-handler/vscode` once, or use the manual fallback below.\n\nManual fallback: copy the JSON from the [VS Code (one-click, recommended)](#vs-code-one-click-recommended) section below into your VS Code `mcp.json` config.\n\nThe same install button is rendered on the Argo install page at `https://app.argo.games/docs/mcp/install`.\n\n---\n\n## Prerequisites\n\n- Node.js 20 or later\n- An Argo account with at least one campaign\n- A Game Master must authorize the AI assistant via the OAuth2 consent flow (see [Getting a token](#getting-a-token))\n\n---\n\n## Quick start\n\nThere are three supported ways to use the Argo MCP server. Pick the one that matches your client.\n\n### ChatGPT (remote)\n\nUse the hosted endpoint — **do not** install the npx package. Add this MCP server URL to ChatGPT:\n\n```\nhttps://mcp.argo.games/mcp\n```\n\nChatGPT will walk you through OAuth on first connect via dynamic client registration.\n\n### Local MCP clients (Claude Code, Claude Desktop, Codex, etc.) — recommended\n\nSign in once on the machine that runs the MCP client:\n\n```bash\nnpx -y argo-mcp auth login\n```\n\nThe command prints the consent URL, opens nothing, and asks you to paste the access token (and optionally the refresh token) from the consent page. Tokens are saved locally:\n\n- Windows: `%APPDATA%\\argo-mcp\\tokens.json`\n- macOS: `~/Library/Application Support/argo-mcp/tokens.json`\n- Linux: `${XDG_CONFIG_HOME:-~/.config}/argo-mcp/tokens.json`\n\nThen configure the MCP server with no env vars:\n\n```json\n{\n \"mcpServers\": {\n \"argo\": { \"command\": \"npx\", \"args\": [\"-y\", \"argo-mcp\"] }\n }\n}\n```\n\nOther auth commands:\n\n```bash\nnpx -y argo-mcp auth status # show whether you are signed in\nnpx -y argo-mcp auth logout # forget locally stored tokens\n```\n\n> Local stdio mode does not use OAuth Dynamic Client Registration. DCR is only used by the hosted HTTP server at `https://mcp.argo.games`.\n\n### Advanced — environment variables\n\nFor CI, Docker, or anyone who prefers explicit env config, you can skip `auth login` and pass tokens directly. `OAUTH_TOKEN` always wins over the local token store.\n\n```json\n{\n \"mcpServers\": {\n \"argo\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"argo-mcp\"],\n \"env\": {\n \"OAUTH_TOKEN\": \"\",\n \"REFRESH_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n---\n\n## Build from source (contributors)\n\n```bash\ngit clone https://github.com/Argo-RPG-Platform/MCP.git argo-mcp\ncd argo-mcp\nnpm install\nnpm run build\n```\n\n---\n\n## Getting a token\n\nThe MCP server authenticates with Argo using an OAuth2 access token tied to a specific set of campaigns. Tokens are obtained through the Argo consent flow:\n\n1. Open **https://app.argo.games/oauth2/mcp-connect** in your browser.\n2. Select the campaigns you want the AI assistant to access and the permission level (read or read+write).\n3. Click **Authorize**. You will be redirected to a page showing two tokens:\n - **Access token** — set this as `OAUTH_TOKEN`\n - **Refresh token** — set this as `REFRESH_TOKEN` (recommended; enables automatic renewal when the access token expires after ~1 hour)\n\nTreat both tokens like passwords. Revoke them at any time from the campaign's integrations page.\n\n---\n\n## Configuration\n\n### VS Code (one-click, recommended)\n\nUse the install buttons at the top of this README, or paste the following into a `.vscode/mcp.json` (per-workspace) or your user-level MCP config:\n\n```json\n{\n \"servers\": {\n \"argo\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.argo.games/mcp\"\n }\n }\n}\n```\n\nVS Code handles OAuth automatically via Dynamic Client Registration on first connect. There is no need to set `OAUTH_TOKEN` or `REFRESH_TOKEN` — VS Code stores tokens in the OS keychain.\n\n### Claude Code\n\nAdd the server with the CLI:\n\n```bash\nclaude mcp add argo \\\n --command node \\\n --args /absolute/path/to/argo-mcp/dist/index.js \\\n --env OAUTH_TOKEN= \\\n --env REFRESH_TOKEN=\n```\n\nOr add it manually to your project's `.claude/settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"argo\": {\n \"command\": \"node\",\n \"args\": [\"/absolute/path/to/argo-mcp/dist/index.js\"],\n \"env\": {\n \"OAUTH_TOKEN\": \"\",\n \"REFRESH_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n### Claude Desktop\n\nEdit your Claude Desktop config file:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"argo\": {\n \"command\": \"node\",\n \"args\": [\"/absolute/path/to/argo-mcp/dist/index.js\"],\n \"env\": {\n \"OAUTH_TOKEN\": \"\",\n \"REFRESH_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nRestart Claude Desktop after saving.\n\n### OpenAI Codex\n\nAdd the server to your Codex MCP configuration:\n\n```json\n{\n \"mcpServers\": {\n \"argo\": {\n \"command\": \"node\",\n \"args\": [\"/absolute/path/to/argo-mcp/dist/index.js\"],\n \"env\": {\n \"OAUTH_TOKEN\": \"\",\n \"REFRESH_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n### ChatGPT App Submission\n\nFor the hosted ChatGPT app surface, this repo exposes OAuth discovery, dynamic client registration, and domain verification endpoints on the MCP domain. The submission checklist and required env vars are in [CHATGPT_APP_SUBMISSION.md](https://github.com/Argo-RPG-Platform/MCP/blob/main/CHATGPT_APP_SUBMISSION.md).\n\n### Using a `.env` file (local dev)\n\nCreate a `.env` file in the `argo-mcp` directory:\n\n```\nOAUTH_TOKEN=\nREFRESH_TOKEN=\n```\n\nThen run directly:\n\n```bash\nnpm run dev # hot-reload via tsx\n# or\nnpm start # compiled dist/\n```\n\n---\n\n## Pre-built Agent Skills\n\nOnce the MCP is connected, you can install the [argo-agent-skills](https://github.com/Argo-RPG-Platform/argo-agent-skills) plugin to get ready-made Game Master workflows that orchestrate the tools below — session prep, post-session recap, NPC generation, and a guided MCP setup walkthrough. The same skill source ships parallel packaging for Claude (Code + Claude.ai) and OpenAI-compatible clients (Codex, ChatGPT).\n\n**Claude Code:**\n\n```\n/plugin marketplace add Argo-RPG-Platform/argo-agent-skills\n/plugin install argo-gm-pack@argo\n```\n\n**Claude.ai / Codex / ChatGPT:** download the per-target zip from the [latest release](https://github.com/Argo-RPG-Platform/argo-agent-skills/releases/latest) and follow the upload steps in that repo's README.\n\nSee the [Argo Skills docs](https://app.argo.games/docs/skills) for the full list of skills, examples, and authoring guidance for your own.\n\n---\n\n## Available tools\n\nThis server exposes tools across campaigns, mnemons, sessions, guilds, friends, invites, and the Argo community forum.\n\n### Campaigns\n\n- `list_campaigns` (`campaign.read`) lists accessible campaigns and their access level\n- `get_campaign` (`campaign.read`) retrieves campaign details\n- `create_campaign` (`campaign.create`) creates a new campaign\n- `update_campaign` (`campaign.write`) updates campaign name or description\n- `list_co_gms` (`campaign.read`) lists assistant GMs\n- `add_co_gm` (`campaign.write`) adds an assistant GM\n- `remove_co_gm` (`campaign.write`) removes an assistant GM\n\n### Mnemons\n\n- `describe_mnemon_types` lists supported mnemon types, relationship labels, and content-block rules\n- `list_mnemons` (`campaign.read`) lists mnemon entries for a campaign\n- `get_mnemon` (`campaign.read`) retrieves a mnemon entry in full\n- `list_mnemon_relationships` (`campaign.read`) lists linked entries and relationship edges\n- `create_*_mnemons` (`campaign.write`) creates typed mnemon entries for NPC, Location, Quest, Lore, Archive, Journal, SessionSummary, Player, and Custom entries\n- `update_*_mnemons` (`campaign.write`) updates typed/meta fields for those mnemon entry types\n- `update_mnemons_content` (`campaign.write`) edits mnemon content blocks\n- `create_mnemon_relationship` (`campaign.write`) creates a relationship between entries\n- `delete_mnemon_relationship` (`campaign.write`) deletes a relationship by ID\n\n### Sessions\n\n- `create_session` (`campaign.write`) schedules a campaign session\n- `list_sessions` (`campaign.read`) lists sessions for a campaign and month\n- `get_session` (`campaign.read`) retrieves a single session\n- `update_session` (`campaign.write`) updates a session's schedule or text\n\n### Guilds\n\n- `list_guilds` (`guild.read`) lists guilds the current user belongs to\n- `get_guild` (`guild.read`) retrieves guild details\n- `list_guild_members` (`guild.read`) lists guild members\n- `add_campaign_to_guild` (`guild.write`) links a campaign to a guild\n- `invite_guild_member` (`guild.admin`) invites a guild member\n- `remove_guild_member` (`guild.admin`) removes a guild member\n- `set_guild_member_role` (`guild.admin`) changes a guild member's role\n- `add_guild_calendar_event` (`guild.admin`) adds a guild calendar event\n\n### Friends and invites\n\n- `list_friends` (`friends.read`) lists accepted friends\n- `list_sent_friend_requests` (`friends.read`) lists outgoing pending requests\n- `list_received_friend_requests` (`friends.read`) lists incoming pending requests\n- `send_friend_request` (`friends.write`) sends a friend request\n- `accept_friend_request` (`friends.write`) accepts a request\n- `reject_friend_request` (`friends.write`) rejects a request\n- `cancel_friend_request` (`friends.write`) cancels a sent request\n- `invite_user_by_email` (`invite.write`) sends Argo invitation emails\n\n### Forum\n\n- `forum_list_categories` (`forum.read`) lists forum categories\n- `forum_list_topics` (`forum.read`) lists topics in a category\n- `forum_get_latest_topics` (`forum.read`) lists recent forum activity\n- `forum_read_topic` (`forum.read`) reads a topic thread\n- `forum_search` (`forum.read`) searches forum content\n- `forum_get_user_posts` (`forum.read`) lists the current user's topics\n- `forum_get_notifications` (`forum.read`) lists the current user's notifications\n- `forum_create_topic` (`forum.write`) creates a new topic on `community.argo.games`\n- `forum_reply` (`forum.write`) replies to an existing topic on `community.argo.games`\n\nMany campaign-scoped tools accept `campaignId`. You can find a campaign's ID from the Argo campaign URL or by asking the GM.\n\n---\n\n## Token renewal\n\nThe access token expires after approximately one hour. If `REFRESH_TOKEN` is configured, the server automatically fetches a new access token on the first request that returns a 401 and retries transparently — no action required.\n\nIf no refresh token is set and the access token expires, the tool will return:\n\n> Token expired — re-consent at https://app.argo.games/oauth2/mcp-connect\n\nRe-run the consent flow at that URL to get fresh tokens.\n\n---\n\n## Revoking access\n\nTo disconnect the AI assistant from a campaign, revoke the grant from the campaign's integrations page in the Argo WebApp. The access token and refresh token will both become invalid immediately.\n\n---\n\n## Environment variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `OAUTH_TOKEN` | If not signed in via `auth login` | OAuth2 access token from the consent flow |\n| `REFRESH_TOKEN` | Recommended | OAuth2 refresh token; enables automatic renewal |\n| `ARGO_API_BASE` | No | Override the API base URL (default: `https://api.argo.games`) |\n| `ARGO_MCP_TOKEN_PATH` | No | Override the local token file path used by `auth login` |\n\n---\n\n## Privacy Policy\n\nFull policy: **https://argo.games/policies/privacy-policy**\n\nWhat the Argo MCP server handles:\n\n- **Data collected.** OAuth access and refresh tokens issued by the Argo authorization server (`oauth.argo.games`); the campaign, mnemon, guild, forum, and friends payloads that pass through tool calls; standard HTTP metadata (IP, user agent) for rate limiting and abuse mitigation.\n- **Usage.** Tool calls are proxied to the Argo WebAPI (`api.argo.games`) on behalf of the authenticated user. Tokens are cached in-process for the lifetime of an MCP session so clients that omit `Authorization` on subsequent requests (a known Claude Code behaviour) keep working.\n- **Storage & retention.** Session token cache is in-memory only and is evicted after 30 minutes of inactivity. No user content (mnemons, campaigns, forum posts) is persisted by the MCP server — it is forwarded to the WebAPI and discarded. Logs retain only request metadata, not payload contents.\n- **Third-party sharing.** Requests are forwarded only to the Argo WebAPI and (during the OAuth flow) the Argo authorization server. No other third parties receive request data from this server.\n- **Contact.** Privacy questions: `support@argo.games`. Security disclosures: see the SECURITY policy on the Argo GitHub organization.\n\nThe hosted privacy policy at the link above is the authoritative version and covers the full Argo platform including the WebAPI and WebApp.\n\n---\n\n## License\n\nMIT — see [LICENSE](https://github.com/Argo-RPG-Platform/MCP/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","Data & Analytics","upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","io.github.Argo-RPG-Platform/argo-mcp","homepage","ENV",{"_105":106,"_107":108,"_109":110},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]