x51xxx avatar

Antigravity MCP Server

x51xxx/antigravity-mcp-server

Hand work from Claude Code or Cursor to Google Antigravity CLI: delegation, reviews, digests

GitHub stars
2
tools
15
transport
STDIO
env vars
3
last updated
Nov 14, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

ask-antigravityRun a prompt through `agy` in print mode. Supports model + `effort`, `mode`, session resume, `--add-dir`, `--sandbox`, `--dangerously-skip-permissions`, dry-run.

Run a prompt through `agy` in print mode. Supports model + `effort`, `mode`, session resume, `--add-dir`, `--sandbox`, `--dangerously-skip-permissions`, dry-run.

No parameter schema in public metadata yet.

plan-antigravityGenerate a structured implementation plan (JSON or markdown) without mutating anything.

Generate a structured implementation plan (JSON or markdown) without mutating anything.

No parameter schema in public metadata yet.

review-changesCollect a git diff (working tree / vs base branch / specific commit) and run a structured code review.

Collect a git diff (working tree / vs base branch / specific commit) and run a structured code review.

No parameter schema in public metadata yet.

brainstormStructured ideation (divergent, convergent, SCAMPER, design-thinking, lateral).

Structured ideation (divergent, convergent, SCAMPER, design-thinking, lateral).

No parameter schema in public metadata yet.

digest-antigravityIngest many files/directories and answer a focused question using Antigravity's large model context. Credential files (`.env`, keys…) are withheld.

Ingest many files/directories and answer a focused question using Antigravity's large model context. Credential files (`.env`, keys…) are withheld.

No parameter schema in public metadata yet.

batch-antigravityRun multiple atomic tasks sequentially or in parallel (priority order, stop-on-error, concurrency cap).

Run multiple atomic tasks sequentially or in parallel (priority order, stop-on-error, concurrency cap).

No parameter schema in public metadata yet.

bg-antigravityDetached background tasks: start / status / tail / stop / remove / list. State persists in `~/.agy-mcp/bg/` across server restarts.

Detached background tasks: start / status / tail / stop / remove / list. State persists in `~/.agy-mcp/bg/` across server restarts.

No parameter schema in public metadata yet.

delegate-antigravityLong multi-step tasks: runs detached in its own git worktree, on the Orchestrator model by default; live `status`, follow-up `continue` turns, `result` with the agent report + diff.

Long multi-step tasks: runs detached in its own git worktree, on the Orchestrator model by default; live `status`, follow-up `continue` turns, `result` with the agent report + diff.

No parameter schema in public metadata yet.

list-sessionsList / delete / clear conversation sessions.

List / delete / clear conversation sessions.

No parameter schema in public metadata yet.

list-modelsAvailable models (`agy models`) grouped by family, with the `effort` levels each accepts and what it is for.

Available models (`agy models`) grouped by family, with the `effort` levels each accepts and what it is for.

No parameter schema in public metadata yet.

healthDiagnose CLI installation, authentication, models, and session state.

Diagnose CLI installation, authentication, models, and session state.

No parameter schema in public metadata yet.

pingUtility.

Utility.

No parameter schema in public metadata yet.

HelpUtility.

Utility.

No parameter schema in public metadata yet.

versionUtility.

Utility.

No parameter schema in public metadata yet.

metricsUtility.

Utility.

No parameter schema in public metadata yet.

Sponsors

Configuration

AGY_MCP_CWD

Default working directory for agy runs (an explicit workingDir still wins)

AGY_SESSION_TTL_MSdefault: 86400000

Session time-to-live in milliseconds (default: 86400000 = 24h)

AGY_MAX_SESSIONSdefault: 50

Maximum concurrent sessions (default: 50)

Readme

Antigravity MCP Server

MCP (Model Context Protocol) server for Google Antigravity CLI (agy) integration. Lets any MCP client (Claude Code, Claude Desktop, Cursor, etc.) delegate tasks to Antigravity's agentic CLI — with model selection (Gemini, Claude, GPT-OSS), conversation resume, and workspace controls.

For the why behind it, read the project write-up on trishchuk.com. It covers how I use Claude Code or Cursor as the lead engineer and hand bounded work to Antigravity: long tasks delegated to the Gemini 4 Orchestrator in an isolated git worktree, read-only plans and reviews from a different model family, and large-context digests. It also has a table for choosing the right tool, the costs and isolation limits to know before delegating, and where Google's multi-agent tooling is heading.

Requirements

  • Node.js >= 18
  • Antigravity CLI installed (agy --version works) and authenticated (run agy once interactively and sign in with your Google account)

Installation


View the full README on GitHub

Details

Repository
github.com/x51xxx/antigravity-mcp-server
Website
trishchuk.com/projects/antigravity-mcp-server
Package
@trishchuk/antigravity-mcp-server
Transport
STDIO
Registry
MCP registry, active

More from x51xxx