claude-to-agy
This server acts as a bridge, allowing Claude Code to delegate heavy or complex tasks to the Antigravity CLI (agy), saving Claude's context window and tokens.
What you can delegate to agy:
Large file analysis — offload processing of large files (logs, dumps, generated code)
Multi-file analysis — analyze more than 3 files at once without consuming Claude's context
Deep searches — run
git log,git diff,grep, and similar expensive operationsWeb lookups — retrieve external documentation or knowledge
Adversarial review / plan critique — route plan critiques or adversarial reviews to
agy
How it works:
Provide a prompt, a working directory, and an optional list of absolute file paths
The server executes
agy --dangerously-skip-permissions --add-dir <cwd> -p "<prompt>", optionally prepending file contents to the promptReturns the clean text output from
agy, or raises an exception handled natively by FastMCPTimeouts are configurable via
AGY_CONNECT_TIMEOUT(default 60s) andAGY_TOTAL_TIMEOUT(default 1200s)
Allows delegation of heavy tasks (large files, multi-file analysis, deep searches, web lookups) to the Antigravity CLI which leverages Google's Gemini API for processing.
claude-to-agy
A lightweight MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) - saving context window and tokens for what matters.
What It Does
Registers a delegate_to_agy MCP tool that Claude automatically uses when it encounters:
Large files (>200 lines) - logs, dumps, generated code
Multi-file analysis (>3 files at once)
Deep searches -
git log,git diff,grepWeb lookups - documentation, external knowledge
Adversarial review / plan critique - always delegated
Claude sends a prompt + file paths → the bridge runs agy CLI → returns the result.
Related MCP server: agy-bridge
Requirements
Python 3.10+
Installation
Note: The command below uses
uvxto run the server without manual installation. If you don't haveuvinstalled, you can substituteuvxwithnpx -yorpipx run.
# 1. Register the MCP server globally via uvx
claude mcp add -s user claude-to-agy uvx claude-to-agy
# 2. Download the delegation rules into your current project
curl -o CLAUDE.md https://raw.githubusercontent.com/rauls-kjarners/claude-to-agy/main/CLAUDE.mdThat's it. Claude will now automatically delegate heavy tasks to Antigravity CLI in any project that has the CLAUDE.md file.
Tip: To enable globally without copying
CLAUDE.mdper project, add the rules to~/.claude/CLAUDE.mdinstead.
Using as a Skill
This project also includes a SKILL.md file, which is the standard format for reusable Claude Code skills. If your setup supports skills, you can use it instead of manually copying CLAUDE.md:
claude skill add https://raw.githubusercontent.com/rauls-kjarners/claude-to-agy/main/SKILL.mdNote: You still need the MCP server registered (step 1 above). The skill provides the rules, MCP provides the tool.
Configuration
All settings are optional environment variables:
Variable | Default | Description |
|
| Seconds to start the agy process |
|
| Hard timeout for entire execution |
How It Works
User → Claude Code → MCP bridge (FastMCP) → agy CLI → Gemini API
← ← ←CLAUDE.mdinstructs Claude when to delegateClaude calls
delegate_to_agy(prompt, cwd, files?)via MCPbridge.pyprepends file paths to the promptRuns
agy --dangerously-skip-permissions --add-dir <cwd> -p "<prompt>"Returns the text output cleanly or raises an exception natively handled by FastMCP
Development
# Linting & Formatting
uv run ruff check .
uv run ruff format .
# Type Checking
uv run pyright
# Tests
uv run pytest
# Pre-commit Hooks (Run before committing)
uv run pre-commit installLicense
MIT
Available Tools
1 tooldelegate_to_agyB
Delegate complex reasoning or deep search to Antigravity CLI.
Inputs: prompt (required), cwd (required), files. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no risk of confusion between tools. The single tool's purpose is clearly described, so an agent can easily identify what it does.
The tool name follows a clear verb_noun pattern ('delegate_to_agy'), consistent with common conventions. With only one tool, naming consistency is inherent.
One tool is sparse for a typical MCP server. While the server serves a narrow purpose (delegation to AGY), the single tool may feel insufficient for complex workflows, but it is not excessively heavy.
The server covers its stated purpose of delegation, but lacks additional tools for managing delegations (e.g., status checks, result retrieval, error handling). There are minor gaps that could affect agent reliability.
Maintenance
Related MCP Connectors
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP bridge that lets Codex delegate long-running agent work to the Antigravity CLI, providing observable and resumable tool-based execution with project scoping.1479 PyPI17MIT
- AlicenseAqualityBmaintenanceMCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.6143 npm68MIT
- AlicenseAqualityAmaintenanceAn MCP server that bridges Claude Code with Antigravity CLI using a Swarm Agent architecture to optimize local development workflows and minimize LLM token costs. Includes a web UI for monitoring agent workflows.321,045 PyPI33MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that lets Claude Code call the Google Antigravity CLI (agy) headlessly for a second opinion from a different model family, or to have agy read project files on Claude's behalf so large files never enter Claude's context window.-