mcpField
R
remix-mcp-quickstart

remix-mcp-quickstart

github.com/farworld-labsDevelopment58 installs
Repository

About remix-mcp-quickstart

remix-mcp-quickstart is a skill for configuring authentication and using Remix MCP tools and workflow resources to create, update, and upload games. It is intended for agents working on Remix games and emphasizes reusing existing project IDs and checking the relevant guidance before multi-step tasks.

Key features

  1. 01CLI authentication and MCP setup
  2. 02Game and version management tools
  3. 03Asset and shop item operations
  4. 04Workflow guidance via skill resources

Use cases

  1. 01Set up Remix MCP access for a project
  2. 02Create or update a Remix game
  3. 03Upload game code and assets
  4. 04Manage a game's shop items

MCP support

It documents configuring the Remix MCP server with `claude mcp add remix-mcp -- npx -y @remix-gg/mcp`. The server exposes game, asset, shop, and skill-resource capabilities to MCP clients.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/farworld-labs/remix-skills --skill remix-mcp-quickstart

After installing, type/remix-mcp-quickstartin Claude Code to confirm it loaded.

Details

From the project README

Install And Auth

Install the human-facing CLI if you want browser auth and reusable credentials:

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

Then configure MCP:

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

The MCP server reads auth from:

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

Project Settings

The current packaged MCP skills prefer this lookup order before createGame:

  1. task context or prior tool results
  2. nearest .remix-cli.json
  3. legacy .remix-mcp.json

Upstream MCP docs are still inconsistent in places and may mention .remix-settings.json. Treat that as stale guidance unless the specific project already uses it. The safe rule is: if you already have gameId and versionId, reuse them and do not call createGame.

Core Tool Set

  • createGame
  • updateGame
  • uploadVersion
  • generateImage
  • generateShopImage
  • uploadGameAsset
  • generateSpriteSheet
  • listShopItems
  • createShopItem
  • updateShopItem
  • deleteShopItem

Skill Resources

The server exposes skill resources under skills://...:

  • skills://overview
  • skills://game-creation
  • skills://upload-game
  • skills://implement-multiplayer
  • skills://integrate-save-game
  • skills://add-image-to-game
  • skills://manage-shop-items
  • skills://add-sprite-to-game
  • skills://migrate-mobile-fullscreen
  • skills://open-game

Load the matching skill resource before taking multi-step actions.

Recommended Flow

  1. Read task context first, then .remix-cli.json, then legacy .remix-mcp.json.
  2. If no IDs exist, call createGame.
  3. Build or repair the game against window.RemixSDK requirements.
  4. Upload assets with uploadGameAsset, generateImage, generateShopImage, or generateSpriteSheet as needed.
  5. Upload code with uploadVersion.
  6. If the task involves monetization, run listShopItems before creating or updating items.
  7. Use the matching workflow resource for detailed rules before continuing.

Guardrails

  • Do not call createGame when task context, .remix-cli.json, or legacy .remix-mcp.json already provides IDs.
  • Do not read the HTML or asset file yourself before calling file-path-based MCP tools.
  • Use CLI login or REMIX_API_KEY; do not invent a separate MCP-only auth scheme.
  • If package docs disagree, prefer the current package source in packages/mcp/src.

Comments

Markdown supported