Warp adapter

Warp's native agent registers relay mcp serve as an MCP tool source. Each turn, the agent calls one of three tools and we translate the call into a relay event.

If you run Claude Code, codex, or aider inside Warp's terminal that's already covered by the Claude Code / CLI adapters — no MCP setup needed.

Install

terminal

relay install --warp                # writes the snippet + prints UI steps

That writes a reference config at ~/.relay/warp-mcp.json and prints copy-paste instructions for Warp's MCP server UI:

Open Warp → Settings → AI → Manage MCP Servers.
Add a new server, name agent-relay.
Command: relay mcp serve (or python -m agent_relay.cli mcp serve if running from a dev checkout).
Save and toggle on.

Tools exposed

Tool	What it does
`relay_log_event`	Record a discrete event (`decision`, `tool_used`, `file_changed`, `rate_limited`).
`relay_snapshot`	Trigger a handoff snapshot for the current session.
`relay_session_status`	Return the current session id, agent slug, cwd.

Protocol

Standard MCP over stdio: line-delimited JSON-RPC 2.0. Implementation: src/agent_relay/adapters/mcp.py.

Source

MCP server core: src/agent_relay/adapters/mcp.py
Warp install helper: src/agent_relay/adapters/warp.py