Antigravity Delegate
# Antigravity Delegate
Delegate edits to Google Antigravity's CLI agent (`agy`) โ your agent writes the brief and reviews the diff.
[](https://www.npmjs.com/package/agy-delegate-mcp)
[](https://www.npmjs.com/package/agy-delegate-mcp)
[](https://registry.modelcontextprotocol.io/v0.1/servers?search=agy-delegate&version=latest)
[](https://nodejs.org)
[](LICENSE)
[](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">


## 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
[](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>
[](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)
[](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
Scored across 3 tools
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.
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.
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.
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.