Minit MCP Server

Give your AI assistant a direct line to the Minit Games platform: it can list your Posts, upload game bundles, and schedule them to go live, all from a single conversation.

What is the Minit MCP server#

A remote Model Context Protocol endpoint at https://mcp.minit.games/mcp, with two layers of tools:

• Read-only, no sign-in: platform requirements, SDK docs, project scaffolding, build validation.
• Authenticated, creator sign-in: read your Posts, create and update drafts, upload bundles, manage your publishing schedule.

Connecting#

Add the server to any MCP-capable AI tool (Claude Desktop, Claude Code, Cursor, and others) as a remote HTTP MCP server with this URL:

https://mcp.minit.games/mcp

Where to add it is tool-specific — look for "MCP servers", "connectors", or "integrations" in your tool's settings and follow its own documentation. Two things every setup shares:

• The URL must include the /mcp path.
• No API key or config secret: sign-in happens in the browser the first time an authenticated tool is called (below).

First-run authentication#

The read-only tools work immediately. The first time your assistant calls an authenticated tool:

1. Your assistant opens a browser window pointing to https://mcp.minit.games/oauth/authorize?...
2. The Minit MCP server redirects to https://console.minit.games/mcp/authorize
3. Not signed in to the console? You're sent to the login page, then returned automatically
4. The page shows "Authorizing Minit MCP…" with your account email. Authorization completes automatically once your creator access is verified
5. The browser redirects back to your assistant, which retries the tool call

Sessions last up to 7 days; after expiry the same flow repeats.

Creator access required. Without creator tier access, the authorization page shows a "Creator access required" message with a link to apply. Once upgraded, repeat the tool call.

Tool reference#

Read-only tools (no sign-in required)#

• minit_get_requirements: the full, up-to-date platform rules, matching Platform Requirements.
• minit_get_sdk_reference: the complete @minit-games/sdk API reference with signatures and examples.
• minit_scaffold_game: a ready-to-run starter project for vanilla, phaser, pixi, or three, with index.html, SDK wiring, and (for Claude Code) a CLAUDE.md with platform rules baked in.
• minit_validate_build: checks a bundle (ZIP or inline file map) against platform rules and returns errors, warnings, and info items. Run it before uploading.

Authenticated tools (creator sign-in required)#

• minit_list_posts: your Posts with status, title, and schedule. Filters by status (draft, analyzing, published, scheduled) and a limit.
• minit_get_post: full state of one Post: processing state, screenshot URL, scheduled publish time, config. Poll it after an upload to watch the status leave analyzing.
• minit_create_post: creates a new draft Post and returns its ID. Title and description optional at creation.
• minit_update_post: updates title, description, mod settings, or config of a draft Post. Not callable on a published Post. Use the mod flow in the Creator Console for live games.
• minit_upload_game_bundle: pass the Post ID and your ZIP's size in bytes; returns a presigned upload URL. Your assistant uploads, then polls minit_get_post.
• minit_schedule_post: schedules a processed Post. Pass the Post ID and an epoch timestamp in milliseconds (Date.now()-style), in the future and within 4 weeks.
• minit_unschedule_post: cancels a pending publish schedule.

Quickstart: create and schedule your first Post from Claude#

Paste these in sequence in any assistant connected to the server.

Step 1: Build the game

Use the Minit MCP to get the platform requirements and SDK reference,
then scaffold a new Phaser project called "color-tap". Build a simple
tap-timing game where the player taps circles that match the target color.
The game lasts 60 seconds and ends with a final score. Any number
works; higher is better.

Step 2: Validate the build

Validate my color-tap build against the Minit Games platform rules.
Fix any errors the validator returns.

Step 3: Create a draft and upload

Create a new Post draft called "Color Tap" with the description
"Tap the matching color before time runs out."
Then upload the color-tap ZIP as the game bundle.
Wait for it to finish processing.

Step 4: Schedule to publish

Schedule the Color Tap Post to publish tomorrow at noon UTC.

Troubleshooting#

• Browser does not open during sign-in: look for a URL starting with https://mcp.minit.games/oauth/authorize in your assistant's output and open it manually.
• "Creator access required": request an upgrade via the link on the authorization page, then repeat the tool call.
• Token expired: sessions last up to 7 days; the one-time browser flow repeats. Expected.
• Upload fails or times out: check the ZIP against minit_validate_build. Presigned URLs are short-lived; call minit_upload_game_bundle again for a fresh one.
• Post stays in analyzing: processing normally completes within 60 seconds; after 5 minutes, contact support.
• "URL not found" connection error: the configured URL must include the /mcp path.
• "Post not found": wrong ID or another account's Post; use minit_list_posts to find the right one.