remix-mcp-quickstart
Quickstart for the official Remix MCP server. Use when configuring or operating `@remix-gg/mcp`, wiring MCP auth, or choosing the right Remix MCP tools and skill resources.
How do I install this agent skill?
npx skills add https://github.com/farworld-labs/remix-skills --skill remix-mcp-quickstartIs this agent skill safe to install?
- Gen Agent Trust Hubfail
This skill facilitates the setup and operation of the Remix MCP server but contains several high-risk patterns. It instructs users to execute a remote shell script via a piped-to-bash command from an external domain, which is a significant security risk. Furthermore, it accesses sensitive local credential files and environment variables, and ingests configuration data from a project-local JSON file that could be used for indirect instruction injection.
- Socketpass
No alerts
- Snykfail
Risk: CRITICAL · 1 issue
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
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:
REMIX_API_KEY- saved CLI credentials in
~/.config/remix/credentials.json
Project Settings
The current packaged MCP skills prefer this lookup order before createGame:
- task context or prior tool results
- nearest
.remix-cli.json - 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
createGameupdateGameuploadVersiongenerateImagegenerateShopImageuploadGameAssetgenerateSpriteSheetlistShopItemscreateShopItemupdateShopItemdeleteShopItem
Skill Resources
The server exposes skill resources under skills://...:
skills://overviewskills://game-creationskills://upload-gameskills://implement-multiplayerskills://integrate-save-gameskills://add-image-to-gameskills://manage-shop-itemsskills://add-sprite-to-gameskills://migrate-mobile-fullscreenskills://open-game
Load the matching skill resource before taking multi-step actions.
Recommended Flow
- Read task context first, then
.remix-cli.json, then legacy.remix-mcp.json. - If no IDs exist, call
createGame. - Build or repair the game against
window.RemixSDKrequirements. - Upload assets with
uploadGameAsset,generateImage,generateShopImage, orgenerateSpriteSheetas needed. - Upload code with
uploadVersion. - If the task involves monetization, run
listShopItemsbefore creating or updating items. - Use the matching workflow resource for detailed rules before continuing.
Guardrails
- Do not call
createGamewhen task context,.remix-cli.json, or legacy.remix-mcp.jsonalready 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/farworld-labs/remix-skills/remix-mcp-quickstart">View remix-mcp-quickstart on skillZs</a>