Skip to main content
One command connects your agent to Summer. It works for 31 agents, and on Windows and Mac. Using a chat app such as Claude or ChatGPT? Skip to the hosted server.

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.
For any other agent, use its id from Every agent. The command:
  1. Writes the Summer MCP server (summer-engine) into your agent’s own config file. Servers already in the file stay.
  2. Installs the Summer skills where your agent reads them. See Skills.
  3. Adds the Summer Games MCP (summer-games) for friends, parties and messages, and prints its one sign-in step. --no-games skips it.
  4. Runs summer doctor, which checks Node.js, Summer Engine, your sign-in and your agent’s config.
In Claude Code you can install the Summer plugin instead: /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:
If everything worked: your agent lists tools such as 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:
Your browser opens the Summer sign-in page. Sign in and choose Allow. The local server then also runs every cloud operation, so your agent needs only one Summer server. If your agent calls a cloud tool before you sign in, it gets a sign-in link and continues once you sign in.

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.
In Claude and Claude Desktop, open Settings > Connectors > Add custom connector and paste 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 id summer 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.
Windows. npx is a shell shim, and hosts that spawn it directly fail with ENOENT. summer setup writes "command": "cmd.exe", "args": ["/c", "npx", "-y", "summer-engine@latest", "mcp"] on Windows; do the same by hand.
No global install required. npx -y summer-engine@latest mcp runs the current release on demand. For faster startup install it (brew install summerengine/tap/summer or npm install -g summer-engine) and use "command": "summer", "args": ["mcp"].

Troubleshooting

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.
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.
Type npx.cmd in place of npx in PowerShell. Don’t change the execution policy.
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.