These docs track main. Latest release: v1.0.0.

antigravity-booster
Reference

MCP tools

The tools exposed by the agb MCP server, generated from the TOOLS array in mcp/server.mjs.

The plugin registers an MCP server named agb (see Plugin layout). It speaks JSON-RPC over stdio and exposes a small set of tools, each of which runs the matching CLI command as a child process and returns its output.

Server

The server answers initialize with protocol version 2024-11-05 and serverInfo.name antigravity-booster-mcp.

Known issue (T-CODE-FIXES-AUDIT item 3)

serverInfo.version is hard-coded to 0.7.0 (C6); it does not report the plugin's package.json version. Use agb --version to see the installed version.

Child processes are started with AGB_PROVIDER=jetski added to the environment (spawn environment). Unknown tools return JSON-RPC error -32602, unknown methods -32601.

Tools

The list below is generated from the TOOLS array in mcp/server.mjs.

Known issue (T-CODE-FIXES-AUDIT item 2)

The concurrency parameter of agb_run is ignored. The server forwards it as an extra command-line flag (C33), but agb run reads only the plan path (run reads only the plan). Concurrency comes from the plan's caps and concurrencyCap.

agb_doctor: Run diagnostic health check for tools, auth, and sandbox setup

No parameters.

agb_plan: Compile an Antigravity brain plan or spec file into plan.json

ParameterTypeRequiredDescription
forcebooleannoForce overwrite the output file if it exists
noColdstartbooleannoSkip coldstart plan gate
noParallaxbooleannoSkip parallax spec ambiguity check
noPremortembooleannoSkip premortem advisory risk gate
outstringnoCustom output file path (default plan.json)
repostringyesAbsolute path to the target repository
specstringyesBrain ID, prefix, or spec.md path to compile

agb_preflight: Run plan-level coldstart probes and forecast scope overlaps

ParameterTypeRequiredDescription
planstringyesPath to plan.json file

agb_review: Deploy a read-only fleet of models to audit changes

ParameterTypeRequiredDescription
refstringnoOptional diff reference range (e.g. main...HEAD)
repostringyesPath to target repository

agb_run: Execute a compiled ticket DAG plan.json

ParameterTypeRequiredDescription
concurrencyintegernoOverride default concurrency cap
planstringyesPath to plan.json file

agb_status: Get execution status of a booster run in the target repository

ParameterTypeRequiredDescription
repostringyesPath to target repository

Mapping to the CLI

ToolRuns
agb_planagb plan <spec> <repo> plus --out, --force, --no-coldstart, --no-parallax, --no-premortem
agb_runagb run <plan>
agb_preflightagb preflight <plan>
agb_statusagb status <repo>
agb_doctoragb doctor
agb_reviewagb review <repo> [ref]

Evidence: tool dispatch. The server resolves the CLI to the sibling dist/agb.mjs in the bundled plugin, bin/agb.mjs in a source checkout, or agb on PATH (resolveAgbEntry). See Headless and MCP.

On this page