Skip to main content
Glama
README.md
# Antigravity Delegate

Delegate edits to Google Antigravity's CLI agent (`agy`) โ€” your agent writes the brief and reviews the diff.

[![npm version](https://img.shields.io/npm/v/agy-delegate-mcp)](https://www.npmjs.com/package/agy-delegate-mcp)
[![npm downloads](https://img.shields.io/npm/dt/agy-delegate-mcp)](https://www.npmjs.com/package/agy-delegate-mcp)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-blue)](https://registry.modelcontextprotocol.io/v0.1/servers?search=agy-delegate&version=latest)
[![node](https://img.shields.io/node/v/agy-delegate-mcp)](https://nodejs.org)
[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![tests](https://github.com/andreilungeanu/agy-delegate-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/andreilungeanu/agy-delegate-mcp/actions/workflows/test.yml)

<img src="assets/logo-light.png" alt="Antigravity Delegate logo" width="150" align="left" hspace="15">

Antigravity Delegate is the MCP bridge that lets Claude Code, ChatGPT/Codex, Copilot โ€” or any MCP client โ€” hand implementation to **agy** over the Agent Client Protocol, then get a structured result back for review.

<br clear="left">

![You and your agent plan and review; the MCP delegate tool hands the brief to agy, which implements with Gemini models and edits your workspace; a clean result comes back with what changed, which files, and the plan, for your agent to review](assets/flow.png)

![Delegate result payload](assets/result-json.png)

## Features

- ๐Ÿค **Native plugins** โ€” install into Claude Code, ChatGPT/Codex, or GitHub Copilot CLI and say *"delegate this to Antigravity"*. The shared skill teaches your agent how to delegate well.
- ๐Ÿ’ฌ **No stalled runs** โ€” if agy needs to clarify, it ends the turn and returns the question as a normal result. Your agent answers by resuming the same session.
- ๐Ÿ“ฆ **Named results** โ€” final answer, changed files, session id, model and thinking level, returned as one compact JSON payload.
- ๐Ÿ“‹ **Plan first** โ€” `plan` mode: agy writes a plan, returned in full as `plan`; you review it, then the same session implements it.
- ๐Ÿ” **Ask anything** โ€” `ask` mode: Q&A over your codebase.
- ๐Ÿฉบ **Self-diagnosing** โ€” a `doctor` tool that reports what is missing, the models agy offers, and the account tier.

`plan` and `ask` are instructions to the agent, and `workspace` is its working directory โ€” [Security](SECURITY.md) and the [delegate reference](skills/delegate/reference.md) spell out what the bridge enforces and what it reports back.

## Install

You need [Node.js 20+](https://nodejs.org/) and the Antigravity CLI (`agy`), signed in โ€” run `agy` once and sign in.

### Claude Code

```shell
/plugin marketplace add andreilungeanu/agy-delegate-mcp
/plugin install agy-delegate@agy-delegate-mcp
```

Then ask:

> Delegate to Antigravity: migrate src/api from callbacks to async/await and update the tests, then walk me through what changed.

### Cursor

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=agy-delegate&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImFneS1kZWxlZ2F0ZS1tY3AiXX0%3D)

Or add it under **Customize โ†’ MCPs** in the sidebar, or in `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (this project):

```json
{
  "mcpServers": {
    "agy-delegate": {
      "command": "npx",
      "args": ["-y", "agy-delegate-mcp"]
    }
  }
}
```

### ChatGPT desktop / Codex

```shell
codex plugin marketplace add andreilungeanu/agy-delegate-mcp
codex plugin add agy-delegate@agy-delegate-mcp
```

### GitHub Copilot CLI

```shell
copilot plugin marketplace add andreilungeanu/agy-delegate-mcp
copilot plugin install agy-delegate@agy-delegate-mcp
```

The server alone, without the skill: `copilot mcp add agy-delegate -- npx -y agy-delegate-mcp`.

### More clients

<details>
<summary><strong>VS Code</strong> โ€” one-click install, or <code>.vscode/mcp.json</code></summary>

[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=agy-delegate&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22agy-delegate-mcp%22%5D%7D)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=agy-delegate&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22agy-delegate-mcp%22%5D%7D&quality=insiders)

```json
{
  "servers": {
    "agy-delegate": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "agy-delegate-mcp"]
    }
  }
}
```

</details>

<details>
<summary><strong>JetBrains AI Assistant</strong> โ€” Settings โ†’ Tools โ†’ AI Assistant โ†’ MCP</summary>

Under **Settings โ†’ Tools โ†’ AI Assistant โ†’ Model Context Protocol (MCP)**, click **Add** and paste this JSON:

```json
{
  "mcpServers": {
    "agy-delegate": {
      "command": "npx",
      "args": ["-y", "agy-delegate-mcp"]
    }
  }
}
```

</details>

<details>
<summary><strong>Devin Desktop (formerly Windsurf)</strong> โ€” <code>~/.config/devin/mcp_config.json</code></summary>

This config is for Devin Local, the default agent (Local 3.6+). On Windows the file is `%APPDATA%\devin\mcp_config.json`. Legacy Cascade and older Windsurf builds read `~/.codeium/windsurf/mcp_config.json`.

```json
{
  "mcpServers": {
    "agy-delegate": {
      "command": "npx",
      "args": ["-y", "agy-delegate-mcp"]
    }
  }
}
```

Heads-up: Devin Desktop's Cascade agent caps you at 100 tools across all servers.

</details>

<details>
<summary><strong>Visual Studio 2026 / 2022</strong> โ€” <code>%USERPROFILE%\.mcp.json</code></summary>

```json
{
  "servers": {
    "agy-delegate": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "agy-delegate-mcp"]
    }
  }
}
```

Visual Studio 2022 needs 17.14+. Note the top-level key is `servers`, not `mcpServers`. A `.mcp.json` in the solution directory scopes it to that solution.

</details>

<details>
<summary><strong>OpenCode</strong> โ€” <code>~/.config/opencode/opencode.json</code> or project <code>opencode.json</code></summary>

OpenCode does **not** use `mcpServers`. Local servers go under `mcp`, with `type: "local"` and `command` as one array:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agy-delegate": {
      "type": "local",
      "command": ["npx", "-y", "agy-delegate-mcp"],
      "enabled": true
    }
  }
}
```

This is the v1 shape, which OpenCode v2 still reads (v2's native form is `mcp.servers`).

</details>

<details>
<summary><strong>Kilo Code</strong> โ€” <code>kilo.jsonc</code> (<code>mcp</code> key, not <code>mcpServers</code>)</summary>

Same shape as OpenCode: `type: "local"` and `command` as one array.

```json
{
  "mcp": {
    "agy-delegate": {
      "type": "local",
      "command": ["npx", "-y", "agy-delegate-mcp"],
      "enabled": true
    }
  }
}
```

In the VS Code extension: **Settings โ†’ MCP โ†’ Add Server โ†’ Local (stdio)**. On Windows, if `npx` is not found, use command `cmd` with arguments `/c`, `npx`, `-y`, `agy-delegate-mcp`.

</details>

### Kiro and any other MCP client

Add the following server to the client's MCP config โ€” for Kiro, `~/.kiro/settings/mcp.json` (user) or `.kiro/settings/mcp.json` (workspace):

```json
{
  "mcpServers": {
    "agy-delegate": {
      "command": "npx",
      "args": ["-y", "agy-delegate-mcp"]
    }
  }
}
```

## License

MIT ยฉ [Andrei Lungeanu](https://github.com/andreilungeanu)

<sub>[Technical reference](TECHNICAL.md) ยท [Security](SECURITY.md) ยท [Privacy](PRIVACY.md) ยท [Terms](TERMS.md) ยท [Changelog](CHANGELOG.md)</sub>

TDQS

A4.1/5.0

Scored across 3 tools

Disambiguation5/5

Each tool maps to a clearly distinct action in the delegation lifecycle: start/resume a delegation (delegate), abort one (cancel), and diagnose setup failures (doctor). The descriptions explicitly scope when to use each, including the 'never shell out to agy' guardrail, so an agent can select without ambiguity.

Naming Consistency4/5

All names are single lowercase words with no mixed casing or prefixes, so the set is predictable. The only deviation is that 'doctor' is a noun while 'delegate' and 'cancel' are verbs, a minor break in the verb pattern.

Tool Count4/5

Three tools is minimal but well-matched to a narrow proxy purpose: one action tool, one lifecycle-control tool, one diagnostic. Nothing extraneous is present, though the surface is thin enough that a fourth helper (e.g. list sessions) could be justified.

Completeness4/5

The core lifecycle is covered: start/resume delegation, cancel an in-flight run, and troubleshoot setup. The main gap is discoverability โ€” there is no way to list or query active/recent session IDs, so an agent must track sessionIds itself, and resume is only reachable by re-invoking delegate.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues