Content
# Antigravity MCP Server
MCP (Model Context Protocol) server for [Google Antigravity CLI](https://antigravity.google/docs/cli-getting-started) (`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.
A sibling of [@trishchuk/kimi-mcp-server](https://github.com/x51xxx/kimi-mcp-server), ported to the Antigravity CLI.
## Requirements
- Node.js >= 18
- [Antigravity CLI](https://antigravity.google/docs/cli-getting-started) installed (`agy --version` works) and authenticated (run `agy` once interactively and sign in with your Google account)
## Installation
```bash
npm install -g @trishchuk/antigravity-mcp-server
```
Or run from source:
```bash
pnpm install && pnpm build
```
## MCP client configuration
```json
{
"mcpServers": {
"antigravity": {
"command": "npx",
"args": ["-y", "@trishchuk/antigravity-mcp-server"],
"env": {
"AGY_MCP_CWD": "/path/to/your/project"
}
}
}
}
```
For Claude Code:
```bash
claude mcp add antigravity -- npx -y @trishchuk/antigravity-mcp-server
```
## Tools
| Tool | Description |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ask-antigravity` | Run a prompt through `agy` in print mode. Supports model override, session resume, `--add-dir`, `--sandbox`, `--dangerously-skip-permissions`, dry-run. |
| `plan-antigravity` | Generate a structured implementation plan (JSON or markdown) without mutating anything. |
| `review-changes` | Collect a git diff (working tree / vs base branch / specific commit) and run a structured code review. |
| `brainstorm` | Structured ideation (divergent, convergent, SCAMPER, design-thinking, lateral). |
| `digest-antigravity` | Ingest many files/directories and answer a focused question using Antigravity's large model context. |
| `batch-antigravity` | Run multiple atomic tasks sequentially or in parallel (priority order, stop-on-error, concurrency cap). |
| `bg-antigravity` | Detached background tasks: start / status / tail / stop / remove / list. State persists in `~/.agy-mcp/bg/` across server restarts. |
| `delegate-antigravity` | Delegate an implementation task into an isolated git worktree; poll status, then `collect` the diff for selective review. |
| `list-sessions` | List / delete / clear conversation sessions. |
| `list-models` | List model labels currently available (`agy models`). |
| `health` | Diagnose CLI installation, authentication, models, and session state. |
| `ping`, `Help`, `version`, `metrics` | Utilities. |
Background and batch tools default to `--dangerously-skip-permissions` because print mode cannot answer interactive permission prompts; pass `skipPermissions: false` to opt out.
## Models
The `model` parameter takes the **display label** from `agy models`, e.g.:
- `Gemini 3.5 Flash (Low | Medium | High)`
- `Gemini 3.1 Pro (Low | High)`
- `Claude Sonnet 4.6 (Thinking)`, `Claude Opus 4.6 (Thinking)`
- `GPT-OSS 120B (Medium)`
Labels change between CLI releases — use the `list-models` tool for the current list. Omit `model` to use your Antigravity default.
## Sessions and conversation resume
`ask-antigravity` supports multi-turn conversations:
```json
{ "prompt": "Analyze src/auth.ts for security issues", "sessionId": "auth-review" }
```
```json
{ "prompt": "Now suggest fixes for the issues you found", "sessionId": "auth-review" }
```
How it works: `agy` doesn't print its conversation ID to stdout in print mode, so the server passes `--log-file` to a temp file and parses `Print mode: conversation=<uuid>` from it. The next call with the same `sessionId` resumes via `agy --conversation <uuid>`.
You can also pass a native `conversationId` directly, or `continueLatest: true` for `agy --continue`.
Session storage is in-memory (lost on server restart). Configure with:
- `AGY_SESSION_TTL_MS` — session TTL (default 24h)
- `AGY_MAX_SESSIONS` — max stored sessions (default 50)
- `AGY_MCP_CWD` — default working directory for `agy` runs
### Known quirk
When resuming a conversation, agy print mode replays the previous assistant message before the new response. The server strips the replayed prefix automatically when it can (previous response under 1000 chars); for longer responses a leading echo may remain.
## Safety
- `skipPermissions: true` maps to `--dangerously-skip-permissions` — agy auto-approves all tool/command permission requests. Use deliberately.
- `sandbox: true` maps to `--sandbox` — terminal restrictions enabled.
- By default agy uses your configured permission rules (`/permissions` in interactive agy).
## Development
```bash
pnpm build # tsc
pnpm lint # tsc --noEmit
pnpm format # prettier
```
## License
MIT
