iDos Games SDK

Name: iDos Games SDK
Author: idosgames

@idosgamesMCP server · External

Game modules, project scaffold and SDK skills for building web games on iDos Games.

Game developmentv0.1.34MITDockerfile

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npm@idosgames/mcpv0.1.34

Run

npx -y @idosgames/mcp

MCP client config

{
  "mcpServers": {
    "idos-games-sdk": {
      "command": "npx",
      "args": [
        "-y",
        "@idosgames/mcp"
      ]
    }
  }
}

README5 min readView on GitHub

iDos Games MCP

Official Model Context Protocol servers for iDos 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 ship your games.

There are two servers, and they do different jobs:

	iDos Games (`com.idosgames/platform`)	iDos Games SDK (`com.idosgames/sdk`)
What it works on	Your live games: their data	Game code in your project
Where it runs	Hosted: `https://site.idosgames.com/api/v2/mcp`	Locally: `npx -y @idosgames/mcp`
Transport	Streamable HTTP	stdio
Sign-in	OAuth 2.1, you pick the games and permissions	None (public, read-only)
Works in browser-only clients (claude.ai, ChatGPT)	Yes	No, it needs a client that can start a local process

Rule of thumb: game code goes through the SDK server. A game's live config, generated assets, task board and builds 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/B experiments, 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 deposits and withdrawals through the reward pool, token-gated play and wallet login, networks, contract addresses and gas policy (get_blockchain / save_blockchain, crypto currencies in save_currency, NFT items in save_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. Generation spends your account's credits, so the assistant can check list_ai_tiers and estimate_media_cost before running 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.

Add the server as a plain HTTP MCP server with no headers and no API key. initialize and tools/list need no sign-in. The first tool call answers 401, your client opens the iDos Games sign-in page, and you pick which 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 on platform.idosgames.com.

Connect

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

Claude Code

bash

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

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

Codex CLI

bash

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

Gemini CLI

bash

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:

Tool	Purpose
`list_modules`	Catalog of composable game modules (games and systems: store, quests, inventory, leaderboard…)
`get_module`	One module's full source and install instructions
`get_host_scaffold`	The base every new project starts from (sign-in, lobby, config)
`get_manifest`	Runtime `@idosgames/*` packages and their exact versions
`list_skills` / `get_skill`	How to code against `@idosgames/core`, the module contract and composition
`search`	Find a ready module by the feature you need

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

bash

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

npm: @idosgames/mcp.

Both servers in one config

Cursor, .cursor/mcp.json:

json

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

VS Code, .vscode/mcp.json:

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:

json

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

Claude Code, .mcp.json:

json

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