Set up your agent
You need: Node.js 22 or newer. The Summer app already brings its own copy and connects the agents it finds, so you can skip this page if you installed it.- Writes the Summer MCP server (
summer-engine) into your agent’s own config file. Servers already in the file stay. - Installs the Summer skills where your agent reads them. See Skills.
- Adds the Summer Games MCP (
summer-games) for friends, parties and messages, and prints its one sign-in step.--no-gamesskips it. - Runs
summer doctor, which checks Node.js, Summer Engine, your sign-in and your agent’s config.
/plugin install summer --marketplace summerengine/summer, then /summer:start. Use the plugin or summer setup, not both.
Check that it works
Restart your agent so it loads the new server. Then ask it:summer_play, summer_screenshot and summer_search. You can also look in your agent’s MCP list: /mcp in Claude Code and Codex, Settings > MCP in Cursor. It shows summer-engine as connected.
Then try a real task: “Make a small 3D game in Summer, play it and show me a screenshot.” Your agent installs Summer Engine if it is missing (it asks you first), creates the project and opens it.
Sign in
Building and playing games needs no sign-in. For assets, publishing and the rest of the cloud work, sign in once:Hosted server for chat apps
Chat apps without a terminal connect to Summer’s hosted server. It does cloud work only: assets, plans, the store page, publishing, prices and analytics. It has no engine tools. You sign in with your Summer account the first time your agent connects.https://mcp.summerengine.com/mcp. For ChatGPT, see Summer in ChatGPT and Claude.
https://docs.summerengine.com/mcp only searches these docs. To connect Summer, use https://mcp.summerengine.com/mcp.Setup options
Every option: summer setup.
Every agent
Every idsummer setup accepts, with the file it writes and where the skills land. Agents with their own guide are linked; the rest are on Every Supported Agent with the exact snippet.
Legacy ids still work but warn:
gemini (Gemini CLI, retired for individual accounts on 2026-06-18; use antigravity) and roo-code (shut down 2026-05-15).
Aliases: claude → claude-code, devin → windsurf, agy → antigravity, copilot → github-copilot, vscode → vscode-copilot, droid → factory, kilo → kilo-code, qwen → qwen-code, kimi → kimi-code.
Manual configuration
If you would rather edit files yourself, or your agent is not listed, these are the shapes in use.summer setup <agent> --print prints the exact one for any agent.
Troubleshooting
My agent does not list any Summer tools
My agent does not list any Summer tools
Restart the agent: most agents load a new MCP server only at start. Then run
npx -y summer-engine@latest doctor, which shows whether your agent’s config points at Summer.A tool answers engine_not_running
A tool answers engine_not_running
Summer Engine is not open. Ask your agent to open your project, or run
npx -y summer-engine@latest dev in the game’s folder. Cloud tools work without the engine.Windows: running scripts is disabled on this system
Windows: running scripts is disabled on this system
Type
npx.cmd in place of npx in PowerShell. Don’t change the execution policy.summer doctor says Node.js is too old
summer doctor says Node.js is too old
Summer needs Node.js 22 or newer. Install the current LTS from nodejs.org (on Windows:
winget install -e --id OpenJS.NodeJS.LTS), then restart your agent.Next steps
Quickstart: coding agent
From setup to a game you can play.
Skills
The skill library and where each agent reads it.
Operations
Every tool, its input and its answer.
CLI reference
Every
summer command.Need help? Ask in Discord for the fastest reply, or email support@summerengine.com.

