Pilot MCP Bridge#

Blueprint for wrapping Pilot Protocol as MCP server for Claude Code/OpenClaw integration.

MCP Tools to Expose#

Identity & Status:

• pilot_daemon_status: Run pilotctl --json daemon status
• pilot_info: Run pilotctl --json info
• pilot_peers: Run pilotctl --json peers

Communication:

• pilot_connect: Run pilotctl --json connect <target> <port> --message "<msg>"
• pilot_send_message: Run pilotctl --json send-message <target> --data "<msg>"
• pilot_recv: Run pilotctl --json recv <port>
• pilot_listen: Run pilotctl --json listen <port>

Discovery:

• pilot_find: Run pilotctl --json find <hostname>
• pilot_lookup: Run pilotctl --json lookup <node_id>

Pub/Sub:

• pilot_publish: Run pilotctl --json publish <target> <topic> --data "<msg>"
• pilot_subscribe: Run pilotctl --json subscribe <target> <topic>

Gateway:

• pilot_gateway_start: Run pilotctl --json gateway start
• pilot_gateway_map: Run pilotctl --json gateway map <hostname> <local-ip>

Workflow Example#

bash

# Start Pilot daemon
pilotctl --json daemon start --registry 34.71.57.205:9000 --beacon 34.71.57.205:9001

# Start MCP server wrapper
python mcp_pilot_server.py

# MCP tools now available in Claude Code/OpenClaw

Dependencies#

Requires pilot-protocol skill, pilotctl binary, MCP server framework (Python mcp library), and MCP-compatible client.