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. serverInfo.version is read from the plugin's package.json, the same source agb --version uses (v1.0.0 hard-coded 0.7.0 instead: C6).
Child processes inherit the ambient environment from the host agent harness. Unknown tools return JSON-RPC error -32602, unknown methods -32601.
Tools
The list below is generated from the TOOLS array in mcp/server.mjs.
agb_run takes only a plan
agb run has no concurrency flag, so agb_run accepts no concurrency parameter: a call that supplies one returns a tool error naming it (v1.0.0 forwarded it to agb run, which ignored it: C33). Runtime concurrency is enforced by the plan's caps field (while concurrencyCap is an advisory fan-out forecast written by adlc merge-forecast).agb_doctor: Run diagnostic health check for tools, auth, and sandbox setup
| Parameter | Type | Required | Description |
|---|---|---|---|
| repo | string | no | Optional path to target repository |
agb_plan: Compile an Antigravity brain plan or spec file into plan.json
| Parameter | Type | Required | Description |
|---|---|---|---|
| force | boolean | no | Force overwrite the output file if it exists |
| noColdstart | boolean | no | Skip coldstart plan gate |
| noParallax | boolean | no | Skip parallax spec ambiguity check |
| noPremortem | boolean | no | Skip premortem advisory risk gate |
| out | string | no | Custom output file path (default plan.json) |
| repo | string | yes | Absolute path to the target repository |
| spec | string | yes | Brain ID, prefix, or spec.md path to compile |
agb_preflight: Run plan-level coldstart probes and forecast scope overlaps
| Parameter | Type | Required | Description |
|---|---|---|---|
| noColdstart | boolean | no | Skip coldstart plan gate |
| plan | string | yes | Path to plan.json file |
agb_review: Deploy a read-only fleet of models to audit changes
| Parameter | Type | Required | Description |
|---|---|---|---|
| ref | string | no | Optional diff reference range (e.g. main...HEAD) |
| repo | string | yes | Path to target repository |
agb_run: Execute a compiled ticket DAG plan.json
| Parameter | Type | Required | Description |
|---|---|---|---|
| plan | string | yes | Path to plan.json file |
agb_status: Get execution status of a booster run in the target repository
| Parameter | Type | Required | Description |
|---|---|---|---|
| repo | string | yes | Path to target repository |
Mapping to the CLI
| Tool | Runs |
|---|---|
agb_plan | agb plan <spec> <repo> plus --out, --force, --no-coldstart, --no-parallax, --no-premortem |
agb_run | agb run <plan> |
agb_preflight | agb preflight <plan> plus --no-coldstart |
agb_status | agb status <repo> |
agb_doctor | agb doctor |
agb_review | agb 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.