Claude Agy MCP

Install · Why Gemini 3.8 Flash? · MCP Power Stack · Tools · Timeouts · Configuration

⚡ Install

npm i @pymodel/claude-agy-mcp

claude mcp add-json -s user claude-agy-mcp \

'{"type":"stdio","command":"npx","args":["-y","@pymodel/claude-agy-mcp"],"timeout":3600000}'

Claude Code delegates heavy tasks to Google's flagship Gemini Flash via the Antigravity CLI (agy) — saving Claude's context window and tokens for what matters.

Claude acts as the orchestrator → claude-agy-mcp routes compute-heavy sub-tasks to the newest Gemini Flash agy offers → only concise answers return. Large files, deep git searches, and log dumps never pollute Claude's context.

User → Claude Code → claude-agy-mcp (MCP) → agy CLI → Gemini 3.8 Flash / Pro / Claude

← ← ← (Clean answers only)

Why Gemini Flash for Claude Code?

Gemini Flash is Google's most intelligent workhorse model for coding and agentic execution. It applies deep multi-step planning, rigorous terminal reasoning, and high first-pass code accuracy.

Gemini 3.8 Flash (High) is the default model for every tool. Each chain leads with gemini-flash@latest-high, which resolves against agy models to the newest Flash at High effort — 3.8 Flash as of 2026-09-11 — and only falls back to Pro or Claude when Flash is unavailable or cooling down. The benchmark table below compares 3.8 Flash against 3.7 Flash, from Google's launch table (2026-09-02); the bridge does not pin that generation.

Benchmark Highlights

The Token & Context Multiplier

When Claude Code directly analyzes a 4,000-line database dump or greps 20 files across git history, those thousands of lines stay permanently in Claude's prompt context, inflating cost and pushing you toward compaction.

With claude-agy-mcp:

1. Claude calls analyze_files or deep_search.
2. Gemini 3.8 Flash processes the 100k+ tokens in isolation via agy.
3. Only the exact code-level findings and line citations return into Claude's prompt.
4. Subsequent questions reuse the same agy session with follow_up without re-sending any files.

The Ultimate AI Engineering MCP Stack

claude-agy-mcp is designed to anchor a modern AI engineer's MCP toolkit alongside complementary specialized servers:

┌─────────────────────────────────────────────────────────────────────────────┐

│ Claude Code (Agent) │ └──────┬──────────────────────┬───────────────────────┬───────────────────────┘ │ │ │ │ ▼ ▼ ▼ ▼ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │claude-agy-mcp│ │ context7 │ │ firecrawl │ │ tavily │ │ (Gemini 3.8 │ │(Official Docs│ │(Web Scraping │ │(Live Search │ │ Delegation) │ │ & API Specs)│ │ & Crawling) │ │ & Research) │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘

Recommended MCP Configuration (.agents/mcp_config.json or Claude Code)

{

"mcpServers": { "claude-agy-mcp": { "command": "npx", "args": ["-y", "@pymodel/claude-agy-mcp"], "timeout": 3600000 }, "context7": { "command": "npx", "args": ["-y", "@upstash/context7-mcp@latest"] }, "firecrawl": { "command": "npx", "args": ["-y", "firecrawl-mcp"] }, "tavily": { "command": "npx", "args": ["-y", "tavily-mcp"] } } }

Why this over claude-to-agy?

Requirements

• Node.js 18+
• Antigravity CLI (agy) installed and authenticated
• Claude Code

Install

# 1. Register the MCP server (user scope = all projects).

add-json bakes in a generous client-side timeout so long analyze_files /

delegate calls don't trip Claude Code's tool-call deadline (see Timeouts).

claude mcp add-json -s user claude-agy-mcp \ '{"type":"stdio","command":"npx","args":["-y","@pymodel/claude-agy-mcp"],"timeout":3600000}'

2. Install the bundled skills into every agent found on this machine.

The server gives an agent the tools; the skills tell it when to use them.

npx --package @pymodel/claude-agy-mcp claude-agy-mcp-install-skills

--list to preview, --dir to install somewhere explicit,

--force to replace a skill you have symlinked to your own checkout.

3. Optional: add delegation rules to your project (or ~/.claude/CLAUDE.md).

curl -o CLAUDE.md https://raw.githubusercontent.com/PyModel/claude-agy-mcp/main/CLAUDE.md

Bundled skills

Installing the package installs the skills too, so there is nothing separate to vendor or keep in sync:

The "timeout": 3600000 (60 min, milliseconds) is the client-side tool-call

deadline, matched to the bridge's default AGY_MAX_RUNTIME ceiling. Without it,

a cold-start analyze_files (~40–50s) or a long delegate hits Claude Code's

default and returns timed out waiting for response w