remix-mcp-quickstart

Quickstart workflow for AI assistants using Remix publishing APIs

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "remix-mcp-quickstart" with this command: npx skills add farworld-labs/remix-skills/farworld-labs-remix-skills-remix-mcp-quickstart

Recommended Flow

Base URL: https://api.remix.gg

  1. Fetch OpenAPI JSON from https://api.remix.gg/docs/json.
  2. Resolve exact methods/paths/schemas from the spec.
  3. GET /v1/metadata/categories to fetch valid category enums.
  4. POST /v1/games
  5. Build game code against window.RemixSDK requirements, including SDK <script> in HTML <head> (https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js) (see the remix-game-sdk skill)
  6. Set required metadata:
    • Name: game metadata APIs
    • Category: game metadata APIs (1-3)
    • Icon: upload via POST /v1/games/{gameId}/assets or in Remix Studio/app flow
  7. Upload binary assets (icon/sprites/audio) via POST /v1/games/{gameId}/assets or in Remix Studio/app flow.
  8. GET /v1/games/{gameId}/assets to confirm hosted asset URLs.
  9. POST /v1/games/{gameId}/versions/{versionId}/code
  10. GET /v1/games/{gameId}/versions/{versionId}/validate
  11. Optional: GET /v1/games/{gameId}/launch-readiness?versionId={versionId}
  12. If blockers exist, patch code/metadata and repeat validation
  13. GET /v1/games/{gameId}/versions/{versionId}/status

Discovery / Inspection Endpoints

  • GET /v1/games
  • GET /v1/games/{gameId}
  • GET /v1/games/{gameId}/versions
  • GET /v1/games/{gameId}/versions/{versionId}
  • GET /v1/games/{gameId}/versions/{versionId}/code
  • GET /v1/games/{gameId}/versions/{versionId}/thread
  • GET /v1/games/{gameId}/assets
  • GET /v1/games/{gameId}/items

Guardrails

  • Never skip validation checks.
  • Treat blockers[] as source of truth.
  • Do not trust cached path/method memory when OpenAPI is available.
  • Do not create extra versions from agent REST.
  • Do not submit from agent REST.
  • If docs are stale, check https://api.remix.gg/docs.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Automation

remix-agent-publish

No summary provided by upstream source.

Repository SourceNeeds Review
13-farworld-labs
General

remix-api-key-auth

No summary provided by upstream source.

Repository SourceNeeds Review
8-farworld-labs
General

remix-add-sprite

No summary provided by upstream source.

Repository SourceNeeds Review
7-farworld-labs
General

remix-rest-snippets

No summary provided by upstream source.

Repository SourceNeeds Review
7-farworld-labs