Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"argo": {
"env": {
"OAUTH_TOKEN": "<your-access-token>",
"REFRESH_TOKEN": "<your-refresh-token>"
},
"args": [
"-y",
"argo-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'package.' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked package. against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in data / ai-ml
Query and manage PostgreSQL databases directly from AI assistants
Dynamic problem-solving through sequential thought chains
Persistent memory using a knowledge graph
Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.
MCP Security Weekly
Get CVE alerts and security updates for io.github.Argo-RPG-Platform/argo-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
Clicking either button hands a vscode:mcp/install URL to your editor with this config:
{ "type": "http", "url": "https://mcp.argo.games/mcp" }
VS 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.
Linux / Flatpak / Snap note: If clicking the button doesn't open VS Code, the vscode: URL handler isn't registered. This is common on:
update-desktop-database. Either run xdg-mime default code.desktop x-scheme-handler/vscode once, or use the manual fallback below.Manual fallback: copy the JSON from the VS Code (one-click, recommended) section below into your VS Code mcp.json config.
The same install button is rendered on the Argo install page at https://app.argo.games/docs/mcp/install.
There are three supported ways to use the Argo MCP server. Pick the one that matches your client.
Use the hosted endpoint — do not install the npx package. Add this MCP server URL to ChatGPT:
https://mcp.argo.games/mcp
ChatGPT will walk you through OAuth on first connect via dynamic client registration.
Sign in once on the machine that runs the MCP client:
npx -y argo-mcp auth login
The 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:
%APPDATA%\argo-mcp\tokens.json~/Library/Application Support/argo-mcp/tokens.json${XDG_CONFIG_HOME:-~/.config}/argo-mcp/tokens.jsonThen configure the MCP server with no env vars:
{
"mcpServers": {
"argo": { "command": "npx", "args": ["-y", "argo-mcp"] }
}
}
Other auth commands:
npx -y argo-mcp auth status # show whether you are signed in
npx -y argo-mcp auth logout # forget locally stored tokens
Local stdio mode does not use OAuth Dynamic Client Registration. DCR is only used by the hosted HTTP server at
https://mcp.argo.games.
For 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.
{
"mcpServers": {
"argo": {
"command": "npx",
"args": ["-y", "argo-mcp"],
... [View full README on GitHub](https://github.com/argo-rpg-platform/mcp#readme)