Skip to main content

Summer Engine in Antigravity

Antigravity is Google’s AI-powered IDE that supports MCP (Model Context Protocol). With Summer Engine’s integration, Antigravity’s AI can control your game engine: add nodes to scenes, set properties, import assets, run the game, and debug, all from within your coding workflow. This guide covers the configuration. Setup takes about a minute.

Prerequisites

  • Antigravity: Google’s AI-powered IDE or the agy CLI
  • Node.js 22+: For running the MCP server
  • Summer Engine: Open with your project, for engine work only
  • Sign in once: npx -y summer-engine@latest login. One browser sign-in also connects the store, publishing and Grow tools

Configuration

This writes the summer-engine server into ~/.gemini/config/mcp_config.json, the file the Antigravity IDE, the Antigravity CLI (agy) and Antigravity 2.0 share, installs the skill library to ~/.gemini/config/skills/, and runs summer doctor. Add --scope project to write .agents/mcp_config.json and .agents/skills/ in the project instead.
Coming from Gemini CLI? Gemini CLI was retired for individual accounts on 2026-06-18 and Antigravity replaced it. The Summer Gemini extension still works for Workspace and enterprise Gemini CLI users (summer setup gemini), but new setups should use Antigravity.

Option 2: Manual configuration

Antigravity uses the mcpServers shape. The files are:
  • User-level: ~/.gemini/config/mcp_config.json
  • Project-level: .agents/mcp_config.json in the project root

Step 1: Create or Edit the Config File

Create the file if it doesn’t exist. If it already has other MCP servers, add Summer Engine to the existing mcpServers object.

Step 2: Add Summer Engine

Step 3: Reload MCP servers

In the agent panel open the MCP servers view and refresh, or restart Antigravity. The Summer Engine MCP server starts when Antigravity starts; it connects to the engine on the first tool call.

Step 4: Verify

Check Antigravity’s MCP or AI settings to confirm “summer-engine” appears and its tools are listed. Then try a prompt:
  • “Use Summer Engine to add a MeshInstance3D with a BoxMesh to the scene”
If the node appears in Summer Engine, the setup is working.

Using Summer Engine with Antigravity

Once configured, the AI can use Summer Engine’s tools when you ask for game-related changes. Example prompts:
  • “Add a Camera3D and DirectionalLight3D to the scene root”
  • “Get the scene tree from Summer Engine”
  • “Import this model and add it to the World node: [URL]”
  • “Run the game and capture a screenshot”
  • “Set the project’s main scene to res://main.tscn”
Engine tools need the engine. Open your project in Summer Engine first, or run npx summer-engine run from the project directory. Asset, plan, store and publishing tools do not need it.

Troubleshooting

”Summer Engine is not running” (engine_not_running)

Start Summer Engine and open your project. The MCP server connects to the engine’s local API on port 6550. The engine writes a token to ~/.summer/api-token when it starts. Every Summer error names its code and one next step (next). not_signed_in: run npx -y summer-engine@latest login. no_credits: add credits at https://www.summerengine.com/studio/credits. All codes: How Summer answers.

MCP server not appearing

  • Config path: Verify ~/.gemini/config/mcp_config.json (user) or .agents/mcp_config.json in the project root. .vscode/mcp.json from older guides is VS Code’s file, not Antigravity’s.
  • JSON validity: Ensure no trailing commas, proper quotes, and valid JSON structure
  • Restart: Fully quit and reopen Antigravity

Tools return errors

See Value formats for parameter formats. Common issues: wrong node path format (./World/Player), invalid property values (use engine string format like "Vector3(0, 10, 0)"), or the game running when scene edits are attempted (stop it first with summer_stop).

Next Steps

Operations reference

Every operation with its inputs and an example

Building a Game

How an AI builds a full game using MCP

MCP Setup Overview

Architecture, prerequisites, and other IDEs

CLI Reference

summer install, run, create, and more

Need help? Ask in Discord first. That is where you get the fastest reply and support. For concrete help, email support@summerengine.com or founders@summerengine.com.