pi-bridge
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ant-bridge
ACP model provider and loopback MCP/skill bridge for Pi (@earendil-works/pi-coding-agent >= 1.5).
ant-bridge connects Pi to the agy CLI over stdio JSON-RPC (agy acp), registers models under the antigravity
provider, and exposes Pi's extension, MCP, codemode, subagent, and skill surfaces over a per-session 127.0.0.1
Streamable HTTP MCP server (pi-bridge and per-server pi-bridge-<server> routes). It does not register extra Pi
tools, wrap core file/shell tools, or write to shared global MCP config files.
Prerequisites
Pi >= 1.5 (
pi --version).agy>= 1.5.3 onPATHand signed in (agy --version, thenagyonce to sign in if needed).
Related MCP server: Xiaozhi AI MCP Bridge
Install and update
Install directly from GitHub via Pi's package manager:
pi install git:github.com/reedjosh/ant-bridgeUpdate installed extensions to the latest commit (or update only ant-bridge):
pi update --extensions
# or update only ant-bridge:
pi update git:github.com/reedjosh/ant-bridgeIf you previously installed @estebanforge/pi-antigravity-bridge, remove it first so two extensions do not register
the same antigravity provider:
pi remove npm:@estebanforge/pi-antigravity-bridgeUsage
Switch models interactively inside Pi:
/model antigravity/gemini-4-carbonOr set a default in ~/.pi/agent/settings.json:
{
"defaultProvider": "antigravity",
"defaultModel": "gemini-4-carbon"
}How tool bridging works
Workspace tools stay native:
agy acpexecutes file reads/edits, search, and shell commands directly in its own runtime. Core Pi file/shell builtins (read,write,edit,bash,grep,find,ls) are excluded from the MCP bridge so tools are never duplicated.Pi 1.5 extension and MCP tools bridge automatically: Active Pi extension tools (including
builtin:codemode,builtin:mcp,builtin:tool-search,pi-subagents, and PR tracking tools) are served onpi-bridge, while direct Pi MCP tools (mcp__<server>__<tool>) bridge onto per-serverpi-bridge-<server>routes over loopback127.0.0.1HTTP authenticated with a per-session random header token (x-bridge-token).Live catalog sync: Whenever the active bridged tool catalog changes between turns (for example after
tool_searchloads deferred tools,/mcpupdates server exposure or connection state,/agy bridgeor/agy toolschanges bridged scope, or/reloadruns),ant-bridgeautomatically recyclesagy acpand reloads the bound session (session/load) soagysees the updated MCP routes and schemas without losing conversation history.Skills: Pi Agent Skills are exposed dynamically via
activate_skillonpi-bridge, sourced live frompi.getCommands()(reflecting package, settings, project-trusted skills, and/reloadupdates) with a filesystemscanSkillsfallback.Usage footer: Streaming turns display live ACP token counts in the status bar (
ACP <in> in (+<cached> cached) / <out> outwhen native usage is reported, orACP ~ <in> in / <out> outfor client-side estimates, hidden while all counts are zero).Long-running tool escalation: Calls that exceed their foreground window (120s for
subagentandcodemode, 20s for other bridged tools) return aSTILL RUNNINGhandle that resolves viabridge_poll_resultwithout hitting transport timeouts.Session persistence: Each
agy acpsubprocess runs with a stagedHOMEunder<agentDir>/antigravity-bridge/acp-homes/whoseantigravity-clistate directory symlinks back to~/.gemini/antigravity-cli, isolating MCP configuration per session while preserving conversation state across restarts.
MCP server exposure
Pi 1.5 controls how MCP servers in ~/.pi/agent/mcp.json or .pi/mcp.json (or interactively via /mcp) reach the
model:
"exposure": "direct"(recommended for daily-driver servers): Pi declares each tool directly, andant-bridgebridges the server onto its ownpi-bridge-<server>MCP route (mcp_pi-bridge-<server>_<tool>when eager, or viacall_mcp_toolwhenagymarks a large catalogLazy:). Calls execute directly and render as clean<server>/<tool>rows in Pi. You can also promote specific tools on a larger server with"toolExposure"."exposure": "codemode"(Pi default): Tools are not declared as individual MCP tools;agyreaches them viacodemode(searchTools,describeNamespace,tools.mcp__<server>__<tool>) to batch or filter multi-step calls in one script."exposure": "deferred": Tools stay undeclared untiltool_searchloads matching tools into Pi's active tool catalog; on the next turnant-bridgerecyclesagy acp, reloads the bound session, and exposes the loaded tools onpi-bridge-<server>.
{
"mcpServers": {
"linear": {
"url": "https://mcp.linear.app/mcp",
"exposure": "direct"
}
}
}Commands
Run /agy inside Pi to open the settings picker (or display status in non-TUI modes), or pass a subcommand:
/agy- interactive configuration picker (bridgeTools, timeouts, permission mode, usage estimate, digest)./agy doctor- checkagybinary version, activebound conversation, driver stats (spawns,turns,recycles), and loopback MCP server status./agy bridge all|mcp|none- update bridged tool scope live and start the loopbackpi-bridgeMCP server on demand when switching fromnonetoallormcp(no/reloadneeded)./agy tools [hide|show <name>|reset]- inspect or toggle which Pi tools are exposed overpi-bridge, with tab completion overpi.getAllTools()./agy tasks [tail <id>]- browse background task logs in the bound conversation directory (Entertails the last 40 lines,rrescans), with tab completion over task IDs on/agy tasks tail <id>./agy artifacts [open <n|name>]- browse or open artifacts in the bound conversation directory, with tab completion over artifact filenames on/agy artifacts open <name>./agy quota- display model quota status fromagy usage./agy clear [all]- clear the conversation binding for the current Pi session only (leaving other open Pi sessions untouched), or passallto clear persisted bindings across every Pi session.
Configuration and session bindings are stored under ~/.pi/agent/antigravity-bridge/ (or
$PI_CODING_AGENT_DIR/antigravity-bridge/).
Development
npm install
npm testPeer packages (@earendil-works/* and typebox) are resolved from the host Pi installation and intentionally omitted
from node_modules.
License
MIT. Forked from @estebanforge/pi-antigravity-bridge 1.10.4 and focused down to an ACP-only provider and Pi 1.5
loopback MCP bridge.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server exposing SMI Aware tools, resources, and skills over Streamable HTTP.
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
Agent communication platform for agent to agent messaging via MCP. Messages, channels, skills.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to securely access local machine capabilities such as file operations, shell commands, Skills, and Pi Tools through a controlled MCP interface with token authorization and multiple tunnel options.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to invoke local file operations, multi-engine web search, weather, system commands, developer utilities, and code execution over MCP, and includes a web dashboard for managing endpoints, testing tools, and viewing live logs.43 npm1MIT
- AlicenseNot gradedqualityCmaintenanceLets MCP clients create, resume, message, and stop Pi coding-agent sessions running on another machine, with conversations that survive client disconnects and server restarts. Sessions can be kept loopback-only or published privately to trusted callers over Tailscale HTTPS.1Apache 2.0
- AlicenseAqualityCmaintenanceEnables any MCP client to browse, triage, search, read, and drive pi coding agent sessions through Pi Web's HTTP API via 25 tools. Supports listing and filtering sessions, reading transcripts, flagging conversations awaiting input, sending messages and waiting for replies, inspecting project diffs, and forking, renaming, or deleting sessions over either stdio or Streamable HTTP.25MIT