Antigravity Setup Guide
Antigravity is Google's agentic coding environment, available as an IDE, an app and a CLI. It supports the Model Context Protocol, so its agent can call Proxima's 41 tools. All Antigravity surfaces read the same mcp_config.json format, and its permission system asks you before an MCP tool runs unless you allow it.
src/mcp/index.js forwards calls to the desktop app, so the app has to be running. Node.js 18 or newer must be on your PATH.
1. Register the Proxima MCP server
Antigravity keeps every MCP server definition in mcp_config.json. The simplest way to open it from the IDE is through the agent panel:
mcp_config.json in the editor. In the Antigravity App you can reach the same list through Settings, Customizations, Installed MCP Servers.mcpServers and save:Use forward slashes on Windows. The optional timeoutSeconds raises the limit for a single tool call. Antigravity's default is three minutes per call and five minutes to connect, which is short for a slow reasoning model or a multi-model tool such as crew or run_loop. A positive value replaces both limits, so keep it large enough for the server to start.
Antigravity's own reference for the file and its properties (command, args, env, cwd, disabled, enabledTools, disabledTools) is on antigravity.google/docs/mcp.
Trimming the tool list
Each tool you expose costs the agent some context. If you only want part of Proxima, list the tools to keep with enabledTools, or hide some with disabledTools:
2. Verify the connection
proxima appears in the MCP server list as connected, with its tools listed.list_available_models. It should return the models your accounts offer. This proves Antigravity, the MCP process, the Proxima app and your logins all work together.mcp(proxima/ddg_search) for one tool, or mcp(proxima/*) for the whole server, in your policy configuration.3. Rules that steer the agent toward Proxima
Antigravity loads persistent rules from your workspace and combines them with any global rules. A short rule file can tell the agent when Proxima's tools are the right choice. Put it in one of these places:
AGENTS.mdorGEMINI.mdin the workspace root (plain Markdown, always active), or in any subfolder to scope it to that folder..agents/rules/*.mdfor several smaller rules. Each file starts with YAML frontmatter that sets atrigger(always_on,model_decision,globormanual).- Global rules for every project:
~/.gemini/AGENTS.mdor~/.gemini/GEMINI.md.
Example AGENTS.md:
Keep each rule file under 24 KB. Antigravity truncates larger files and limits the total size of always-on rules, so concise rules work best.
4. Troubleshooting
- The server does not connect. Validate the JSON in
mcp_config.json, use forward slashes, and runnode --versionto confirm Node 18+. A wrong path toindex.jsis the most common cause. - A tool call times out. Raise
timeoutSecondsas shown above, and try a faster model withlist_available_models. - Tool calls fail but the server is connected. Open the Proxima app and sign in to the provider again.
ddg_searchworks without a provider and helps you tell the two cases apart.
See the troubleshooting guide for more, and What's new in 5.5.0 for the model-discovery changes.