Playgama Developer Cabinet MCP Server

Publish and manage your HTML5 games on Playgama straight from your AI agent — Codex, Claude Code, Cursor or VS Code. Full guide: Playgama wiki.

The server is hosted by Playgama. There is nothing to install or run and no token to copy — you give your client the endpoint below, sign in to the cabinet in the browser it opens, and allow the connection.

What you get

• Publish in seconds — ask your agent, get a public playable link back.
• Get the audience — the game takes its first players from the Playgama network, and Playgama DSP can send more the day it goes live (beta). The agent can start that campaign itself with start_sandbox_traffic; share the game first and the boost is free.
• Start monetization — rewarded, interstitial and banner ads switch on through Playgama Ad once the game clears the session threshold (access by request).
• Get all analytics — playtime, retention and revenue reports in your developer dashboard; payouts start at 100 USD.

You need a Playgama developer account with the sign-up finished. A connected agent reaches the games of your own organization and nothing else. It stays connected while it keeps using the server; revoke it on the same page and it is refused on its next call.

Every game needs the Playgama Bridge SDK integrated — the sandbox included. If your game does not have it yet, the agent integrates it before the first upload: get_bridge_sdk_docs serves the docs, and the Game checklist lists the required steps in order. A build in which the SDK was not detected is not published, and the sandbox takes Playgama Bridge 2.2.0 or newer only.

Questions: developer.success@playgama.com

Connect

Every client below opens the browser the first time it connects. Sign in to the cabinet if you are not signed in, check the account and the agent, and allow it.

Codex

codex mcp add 'playgama-developer-cabinet' --url 'https://developer.playgama.com/api/mcp'

Claude Code

claude mcp add --transport 'http' 'playgama-developer-cabinet' 'https://developer.playgama.com/api/mcp'

Then run /mcp in Claude Code and choose the server to sign in.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "playgama-developer-cabinet": {
      "type": "http",
      "url": "https://developer.playgama.com/api/mcp"
    }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "playgama-developer-cabinet": {
      "type": "http",
      "url": "https://developer.playgama.com/api/mcp"
    }
  }
}

Claude Desktop and claude.ai

Settings → Connectors → Add custom connector, with the endpoint https://developer.playgama.com/api/mcp.

A token in a config from before OAuth

If your config still sends an Authorization header with a pgm_mcp_ token, it keeps working for now. Remove the header and connect again as above.

Tools

The authoritative list is what the server answers to tools/list. As of version 1.3.0:

Every write tool is annotated destructiveHint: true, so clients ask before calling it.

Agents start with get_launch_steps and read it again after each step.

Uploading a build

1. Read get_game_checklist and check the game and the zip against each item; fix what fails before uploading.
2. start_archive_upload answers uploadUrl and headers.
3. PUT the zip to uploadUrl with exactly those headers, e.g. curl -T game.zip -H "Content-Type: application/zip" "<uploadUrl>".
4. confirm_archive_upload, then poll get_archive_status until state.status is no longer CHECKING. PASSED publishes; on PROBLEM or NOT_CHECKED pass state.message on to the developer word for word and fix the build — publish_sandbox and a submit to moderation both refuse it (get_bridge_sdk_docs has the SDK integration docs). The sandbox also refuses a build on a Playgama Bridge older than 2.2.0 (BRIDGE_VERSION_OUTDATED) or one whose version the check could not read (BRIDGE_VERSION_UNKNOWN): update the SDK and upload a new archive. If processing is FAILED, upload a corrected zip.

Covers work the same way, one slot per call: a PNG or JPEG of exactly 800×800 (square), 1080×1920 (portrait) or 1920×1080 (landscape).

Sandbox traffic

Get a free boost after sharing your game on any platform. The developer publishes the post and pastes its link to the agent, which passes one to three public HTTPS post links to start_sandbox_traffic in postUrls; one is enough. The bonus is once per game, for up to three games per organization over its lifetime. Earlier free launches without sharing do not use this bonus. get_sandbox_share has the ready post and share links. Paid traffic is available in the cabinet; MCP does not purchase it.

Limits

• Build archive: up to 300 MB per zip.
• Cover: up to 10 MB per file.
• Sandbox: 3 publications per rolling hour per game; only publications that change something count.

What the server deliberately does not do

These stay human actions in the cabinet:

• submitting a game to moderation;
• deleting anything — leaderboards, or archives and covers from the form;
• rolling a game back to its last submitted version;
• reading payouts;
• uploading screenshots, videos and other assets.

Beyond the MCP server

The rest of the Playgama stack picks up where this server stops:

• Playgama Bridge SDK — required in every game you upload (see above), and the same integration carries the game further: one API for ads, leaderboards, payments and platform SDKs when you publish the same game across platforms. Open source, npm i @playgama/bridge.
• Playgama Ad — monetizes web games with rewarded, interstitial and banner formats through a single lightweight JS SDK, with gaming-focused demand, Google Ad Manager MCM support and reporting. Access by request.
• Playgama Wrap — turns the same game into a standalone site on your own domain, with hosting, player accounts, in-game purchases, PWA install and indexable SEO pages. Early access.
• Playgama DSP — brings the first players to a freshly published game. Beta.

License

MIT