Guide
Build games with Claude Code or Codex on your computer
Besides chatting in the editor, you can build a game with your own coding agent, then preview and publish it here.
What it is
Your own coding agent writes the game on your computer. When it pushes, the platform checks the build and adds it to your game as a new draft. You preview it and publish it in the app, as with games made in chat.
What you need
- Claude Code or Codex (or another agent that supports Agent Skills and MCP)
- git and Git LFS (your game becomes a git repository on your computer; images and sounds go through Git LFS)
- A registered account (guests can’t make games)
Set up your agent
Pick your agent and run these once. Logging in opens a browser window where you allow access.
Your agent
Add the Creator Kit marketplace
/plugin marketplace add MoonTechnica/agent-pluginsInstall the TOKOYO.games plugin
/plugin install tokoyo-creator@moon-technicaOpen /mcp and log in to game-sns. A browser window opens so you can allow access.
/mcpPull this game's current draft
/tokoyo-creator:pull <game-id>
MCP server URL
https://tokoyo.games/mcp/creatorHow a build goes
Log in to the platform through the MCP server (once per agent).
Tools the agent uses:
whoamiPick one of your games, or create a new one.
Tools the agent uses:
list_appscreate_appget_appPull the current draft’s history (git) and the SDK.
Tools the agent uses:
get_sdkget_git_bundlesBuild and change the game on your computer.
Push the build.
Tools the agent uses:
begin_buildsubmit_buildWait while the platform checks it (usually a minute or two).
Tools the agent uses:
get_buildcancel_buildOpen the editor link the agent shows you and try the new draft in the preview.
Publish from the app when you’re happy with it.
To improve someone else's game, remix it, send your changes, and once validation passes ask the agent to propose them to the original (no need to publish)
Tools the agent uses:
resolve_appremixopen_proposalget_proposalcomment_proposal
What the agent can and can’t do
The agent can
- Create new games
- Download and upload drafts of games you can edit, including your teams' games
- Remix published games that allow it (the fork belongs to you or your team)
- Open, update or withdraw proposals to the original game, and comment on proposals
- Merge proposals that reached your games (the result is a draft; nothing is published)
- Generate images, sounds and 3D assets with your credits
- See build and check status
The agent can't
- Publish, unpublish or post games, or change remix and proposal settings
- Spend credits on anything other than asset tools
- Manage teams or change account settings
- Report games or people
- Delete games or your account
Opening, closing, commenting on and merging proposals reach other people, so Claude Code asks you before each one. In Codex, set these tools to ask for approval (see the guide).
Costs and limits
- The AI model runs on your own Claude or OpenAI plan. The platform doesn’t charge credits for it.
- Asset tools (images, sounds, 3D) spend credits, as in the editor. Each game has a daily limit that resets at 00:00 UTC.
- You can push up to 20 times an hour.
Quick local runs
Troubleshooting
- Login fails or keeps asking again
- Log out and log in again. In Claude Code, open /mcp, select tokoyo, log out and log in. In Codex, run codex mcp logout tokoyo, then codex mcp login tokoyo. Claude Code uses a fixed callback port, so close anything else using it.
- “Kit outdated”
- Update the TOKOYO.games plugin, then retry. In Claude Code, run /plugin marketplace update tokoyo-plugins. In Codex, run codex plugin marketplace upgrade tokoyo-plugins. For other agents, run npx skills add again.
- “Stale base”
- The draft changed since you pulled (for example, from chat in the editor). The agent pulls again, rebases your changes onto it (like git pull --rebase), then pushes.
- Images or sounds won’t upload (Git LFS asks for credentials)
- Ask the agent to log in to the Kit (node <kit>/scripts/kit.mjs login). You allow it once in the browser; it is separate from the MCP login.
- Disconnect an agent
- Go to Account settings → Connected agents and disconnect it. It stops working right away.


