npm package: @remix-gg/mcp
Description: MCP server + skills for building remix HTML games
Latest version: 0.9.0

# @remix-gg/mcp

MCP server and skills for building and publishing HTML games on [Remix](https://remix.gg).

## Quick Start

If you also want the human-facing Remix CLI, install it separately:

```bash
curl -fsSL https://remix.gg/install.sh | bash
remix login
remix whoami
```

The MCP server itself is still non-interactive. It reads auth from:

1. `REMIX_API_KEY`
2. saved Remix CLI credentials in `~/.config/remix/credentials.json`

### Claude Code

```bash
claude mcp add remix-mcp -- npx -y @remix-gg/mcp
```

### Claude Desktop

Add to your Claude Desktop config:

```json
{
  "mcpServers": {
    "remix": {
      "command": "npx",
      "args": ["-y", "@remix-gg/mcp"],
      "env": {
        "REMIX_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Authentication

Set the `REMIX_API_KEY` environment variable with your API key from [remix.gg](https://remix.gg),
or run `remix login` first so the MCP server can reuse the saved CLI credentials.

```bash
export REMIX_API_KEY=your-api-key
```

### Set API Key in Claude Code

You can make the ENV variable work for all Claude Code sessions by setting it in `.claude/settings.json`.

```json
{
  "env": {
    "REMIX_API_KEY": "sk_agent_your-api-key-from-remixgg"
  }
}
```

## Tools

| Tool | Description |
| --- | --- |
| `createGame` | Create a new game on Remix |
| `updateGame` | Update an existing Remix game (name) |
| `uploadVersion` | Validate and upload an HTML game file to a game version |
| `generateImage` | Generate an AI image and host it as a game asset |
| `uploadGameAsset` | Upload an asset file (image, audio, 3D model, video) |
| `generateSpriteSheet` | Generate an animated sprite sheet and transparent variant for a game |
| `listShopItems` | List all shop items for a game so you can inspect IDs, slugs, and statuses |
| `createShopItem` | Create a new shop item (consumable, one-time, or tier unlock) for a game |
| `updateShopItem` | Update fields on an existing shop item (name, slug, pricing, metadata) |
| `deleteShopItem` | Delete or deactivate a shop item depending on current status |

## Skills

The MCP server exposes skill resources that guide agents through multi-step workflows:

| Skill | Description |
| --- | --- |
| `game-creation` | Full workflow for creating an HTML5 game from scratch |
| `migrate-mobile-fullscreen` | Adapt an existing game for mobile fullscreen while respecting safe areas |
| `upload-game` | Package and upload a finished game to Remix |
| `implement-multiplayer` | Integrate turn-based multiplayer using the Remix SDK |
| `integrate-save-game` | Add save/load game state via the Remix SDK |
| `add-image-to-game` | Generate and integrate image assets into a game |
| `manage-shop-items` | Create, list, update, delete, and integrate shop items |
| `add-sprite-to-game` | Generate and integrate animated sprite sheets in a game |
| `open-game` | Open a game in Remix Studio for browser preview |
| `overview` | Master overview of all available capabilities |

## Game Settings

Game IDs are persisted in a `.remix-settings.json` file in the project root. The MCP tools read and write this file automatically so IDs carry across sessions.

## Links

- [remix.gg](https://remix.gg)
- [Remix CLI install.sh](https://remix.gg/install.sh)
- [@remix-gg/cli](https://www.npmjs.com/package/@remix-gg/cli) — human-facing CLI with `remix login` and `remix whoami`
- [@remix-gg/sdk](https://www.npmjs.com/package/@remix-gg/sdk) — Client SDK for game developers