# iDos Games SDK

An MCP server that feeds a coding agent the iDos Games module catalog, a starter project and SDK how-tos. No sign-in, works offline.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: iDos-Games
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/iDos-Games/idosgames-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/idos-games-sdk

## What it does

The server exposes the Module & Skills Registry to your agent. It lists ready game modules such as a store, quests, inventory, leaderboards or multiplayer, hands over a module's full source with its install notes, and returns the scaffold every new project starts from. Package versions for `@idosgames/*` come from the manifest tool, and separate skills cover coding against `@idosgames/core` and combining modules. A search tool finds a module by the feature you describe. Two validators run the studio's own checks over a video asset or video package.

Every tool is read-only and answers with content. Writing files is the agent's job, so the server never touches your project. The registry ships inside the npm package, which keeps it usable with no network.

There is no authentication, and the transport is stdio. Your client must be able to spawn a local process through `npx`; a chat that only speaks HTTP to remote tools won't run it. Live game settings, asset generation and build uploads belong to the separate hosted iDos Games server, which does use OAuth.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add sdk -- npx -y @idosgames/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add idos-games-sdk -- npx -y @idosgames/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "idos-games-sdk": {
            "command": "npx",
            "args": [
                "-y",
                "@idosgames/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "idos-games-sdk": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@idosgames/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add idos-games-sdk npx -y @idosgames/mcp
```

## When to use it
- pick a ready module for a game mechanic and read its source
- start a new game project from the base scaffold
- pin the right `@idosgames/*` package versions
- learn how to build on `@idosgames/core` and the module contract
- check a video-studio asset or video before shipping it

## Example prompts
- Find a store module and walk me through installing it
- Scaffold a new project from the host template and pull the current manifest
- Validate the package in `video.json` with `validate_video`

## Similar
- [build-mobile-threejs-games](https://affpapa.org/en/nevibecode/skills/build-mobile-threejs-games.md) — skill · 1300 installs
- [optimize-threejs-games](https://affpapa.org/en/nevibecode/skills/optimize-threejs-games.md) — skill · 1300 installs
- [unity-vrc-world-sdk-3](https://affpapa.org/en/nevibecode/skills/unity-vrc-world-sdk-3.md) — skill · 992 installs
- [monetize-game](https://affpapa.org/en/nevibecode/skills/monetize-game.md) — skill · 862 installs
- [sdk-portfolio-strategy](https://affpapa.org/en/nevibecode/skills/sdk-portfolio-strategy.md) — skill · 8000 installs
- [cline-sdk](https://affpapa.org/en/nevibecode/skills/cline-sdk.md) — skill · 4700 installs

From the same set: [idos-games/idosgames-mcp](https://affpapa.org/en/nevibecode/by/idos-games/idosgames-mcp.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md