iDos Games MCP

iDos Games MCP

Official Model Context Protocol servers foriDos Games, a backend and publishing platform for cross-platform games (web, Android, iOS, PC) with web3 support. Connect them to Claude,ChatGPT, Cursor, VS Code, Codex or any other MCP client, and your AI assistant can build, configure and shipyour games.

There are two servers, and they do different jobs:

Rule of thumb: game code goes through the SDK server. A game's live config, generated assets, task board andbuilds go through the iDos Games server.

iDos Games (hosted)

What your assistant can do with it:

• Find your games by name and see what it is allowed to do in each (list_my_titles).
• Read and update game configuration section by section: virtual currencies, items, store, lootboxes,quests, timed and co-op events, seasons, leaderboards, crafting, rewards, premium, tutorials, A/Bexperiments, localization, chat, multiplayer, push, advertising and more (get_<section> / save_<section>).Each section is saved on its own, so the rest of the configuration stays untouched.
• Web3: game currencies as on-chain tokens and items as NFTs on EVM networks and Solana, player depositsand withdrawals through the reward pool, token-gated play and wallet login, networks, contract addresses andgas policy (get_blockchain / save_blockchain, crypto currencies in save_currency, NFT items insave_item). Token launch and holder staking live on idosgames.com itself.
• Title data and localization keys: the game's shared key-value data and its text keys.
• Server logic: publish CloudCode, and list secret names (values are never returned).
• Generate assets with AI: images, speech and sound, music, short videos, 3D models and text. Generationspends your account's credits, so the assistant can check list_ai_tiers and estimate_media_cost beforerunning it.
• Task board: projects, columns, cards, assignees and comments.
• Ship builds: upload a ready web build, get a test link, then put it live for players.

Every tool has a title and readOnlyHint / destructiveHint / openWorldHint annotations.

How sign-in works

Add the server as a plain HTTP MCP server with no headers and no API key. initialize and tools/listneed no sign-in. The first tool call answers 401, your client opens the iDos Games sign-in page, and you pickwhich games the assistant may use and what it may do in each (read config, write config, generate assets,upload builds…). The client then repeats the call. You can revoke access at any time in Connected apps onplatform.idosgames.com.

Connect

Claude (claude.ai, Desktop, mobile): Settings → Connectors → Add custom connector →https://site.idosgames.com/api/v2/mcp.

Claude Code

claude mcp add --transport http idosgames https://site.idosgames.com/api/v2/mcp

ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode → Create, URLhttps://site.idosgames.com/api/v2/mcp, authentication OAuth.

Codex CLI

codex mcp add idosgames --url https://site.idosgames.com/api/v2/mcp

Gemini CLI

gemini mcp add --transport http idosgames https://site.idosgames.com/api/v2/mcp

Cursor (.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json, key serverUrl),VS Code (.vscode/mcp.json): see Both servers in one config.

iDos Games SDK (local)

Serves the iDos Games Module & Skills Registry to coding agents:

All tools are read-only and return content. The agent writes the files into its own project. The registry isbundled in the package, so it also works offline.

claude mcp add idosgames-sdk -- npx -y @idosgames/mcp

npm: @idosgames/mcp.

Both servers in one config

Cursor, .cursor/mcp.json:

{
  "mcpServers": {
    "idosgames": { "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

VS Code, .vscode/mcp.json:

{
  "servers": {
    "idosgames": { "type": "http", "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "type": "stdio", "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Windsurf, ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "idosgames": { "serverUrl": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Claude Code, .mcp.json:

{
  "mcpServers": {
    "idosgames": { "type": "http", "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Example prompts

• "Show the virtual currencies and store items configured for my game."
• "Add a daily quest that rewards 100 gold for winning 3 matches."
• "Generate a 512×512 icon for a fire sword and add it to the item catalog."
• "Start a new idle RPG project with a store and daily quests." (SDK server)
• "Build the game and upload it as a test version." (both servers)
• "What tasks are assigned to me on my board?"

Links

• Documentation: idosgames.com/mcp
• Support: idosgames.com/mcp#support, [email protected]
• Privacy policy: idosgames.com/privacy
• Terms: idosgames.com/terms

License

The SDK server (@idosgames/mcp) is MIT-licensed; see LICENSE. The hosted iDos Games server is aservice covered by the iDos Games terms.