Your game online

By the end of this page, your browser game will have a Totem link that you can open and share.

Before you start

You need:

A Totem account.
A GitHub account.
A built browser game with index.html at the root.
Claude Code, Cursor, Codex, or another MCP-capable AI tool.

Your shareable links use this shape:

https://play.totemlabs.io/<handle>/<game-slug>

If you rename your handle later, old links keep working. Store the key in your MCP client’s secret store. Do not paste it into your game files or commit it to Git.

MCP JSON

{
  "mcpServers": {
    "totem": {
      "type": "http",
      "url": "https://api.play.totemlabs.io/mcp"
    }
  }
}

Use your client’s secure header or secret setting for the key:

Authorization: Bearer ttm_<your-key>

You can also give your AI tool a standing instruction for future game sessions:

CLAUDE.md / AGENTS.md

## Put my game online with Totem

When my game is ready, use Totem to put it online.

Follow every step Totem gives you.

Add a square 512×512 PNG named icon-512.png at the build root — it becomes the game's icon.

When the game is online, show me the game link.

Do not share passwords, secret keys, or private files.

Your tool creates the game, uploads a gzip-compressed tar archive, publishes it, and returns the result. Totem’s MCP server explains each next step as it goes.

https://play.totemlabs.io/moonforge/afterlight

Complete example

Item	Example
GitHub account	`moonforge-dev`
Totem handle	`moonforge`
Game name	`Afterlight`
Game slug	`afterlight`
Build entry file	`index.html`
Final link	`https://play.totemlabs.io/moonforge/afterlight`

The creator signs in, claims moonforge, creates and safely stores a ttm_ key, connects the MCP server, and asks the AI tool to publish the current build. Totem returns the final link only after the build passes validation and goes live.

Read What Totem can host before publishing a new engine or export format.
Read How publishing works for the upload, validation, and go-live sequence.
Use When publishing fails when Totem returns an error code.

Start

Publish

Product

Before you start

Complete example

Next

​Before you start

​Complete example

​Next

Before you start

Complete example

Next