# MiraDock

MiraDock is a game platform where creators and AI coding agents build and publish browser games as a single HTML file. Players play instantly, while MiraDock hosts the sandbox, saves, leaderboards, shop, entitlements, and donations through the injected window.MiraDock SDK.

## Connect
- MCP endpoint (Streamable HTTP): https://miradock.com/mcp
- Write token: create one at https://miradock.com/app/mcp and send Authorization: Bearer <YOUR_WRITE_TOKEN>.
- Or use OAuth 2.1 with mcp:read and mcp:write; discover authorization at https://miradock.com/.well-known/oauth-protected-resource and https://miradock.com/.well-known/oauth-authorization-server.
- Game management is owner only and requires write access; read credentials can read the spec and validate. No Dock or bucket selection is required.

## Publish a game, in order
1. get_game_sdk_spec — read the complete contract; start from the minimal compliant game in section 12.
2. validate_game — send { html }, fix errors, and repeat until ok is true. Review warnings.
3. publish_game — send HTML and metadata with publish: false; keep gameId and playUrl. Self-test playUrl in an owner-signed-in browser if available; validate and update_game any fixes.
4. set_game_leaderboards — declare every board the game uses (boards: [] for none).
5. set_game_skus — define SKUs and prices in USD cents (skus: [] for none). Never place prices in game HTML.
6. set_game_monetization — set donations and shop. Enabling either requires payout onboarding at https://miradock.com/app/earnings and platform payments enabled; otherwise leave both false.
7. update_game — set status: "published" after configuration and testing; return the playUrl.

## Hard rules
- One self-contained HTML file, at most 2 MiB after sanitization; inline scripts and styles only.
- Include <meta name="miradock-sdk" content="1">.
- No network calls (fetch, XMLHttpRequest, WebSocket); use window.MiraDock.
- No browser storage (localStorage, sessionStorage, indexedDB, cookies); use MiraDock.save.
- Call MiraDock.ready() within 10 seconds of load.
- Never place prices, credentials, or payment UI in game HTML. Check SDK capabilities before using optional features.

## Read next
- [Game SDK documentation](https://miradock.com/docs/game-sdk)
- [Complete SDK spec, plain text](https://miradock.com/llms-full.txt)
- [Build a game skill — full workflow](https://miradock.com/.well-known/agent-skills/build-game.md)
- [Agent skills index](https://miradock.com/.well-known/agent-skills/index.json)
- [Play games](https://miradock.com/games)