@agentpilot/connector
v1.1.0
Published
Agent Pilot MCP connector - bridges a local AI coding agent (Claude Code, etc.) to the Agent Pilot mobile app.
Maintainers
Readme
@agentpilot/connector
MCP (Model Context Protocol) connector for Agent Pilot — lets a local AI coding agent (Claude Code, etc.) send messages/progress updates to the Agent Pilot mobile app, and lets the app deliver phone-sent messages back to the exact terminal tab the agent is running in.
Usage
Register it with Claude Code's MCP system:
claude mcp add agent-pilot -- npx -y @agentpilot/connector --mcp --agent claudeCodeCheck it connected:
claude mcp listHow it works
- Exposes two MCP tools:
send_message_to_phoneandreport_progress, which the agent calls to push updates to the phone. - On startup, resolves its controlling terminal (
tty < /dev/tty) and registers it with the local Agent Pilot Host, so phone-sent messages get delivered to the correct terminal tab instead of a random one. - Talks JSON-RPC 2.0 over stdio, one line per message — standard MCP stdio transport.
Configuration (environment variables)
| Variable | Default | Purpose |
|---|---|---|
| PILOT_PUBLISH_URL | http://127.0.0.1:47831/publish | Local Host endpoint for pushing agent events to the phone |
| PILOT_REGISTER_URL | derived from PILOT_PUBLISH_URL | Local Host endpoint for registering this session's tty |
| PILOT_AGENT_PROVIDER | claudeCode | Agent identity, can also be set via --agent |
| PILOT_AGENT_DISPLAY_NAME | derived from provider | Friendly display name |
Requirements
The Agent Pilot Host app must be running locally (it's what actually talks to your phone). This connector only talks to 127.0.0.1 by default and does not need network access beyond your local machine.
License
MIT
