Skip to content

MCP Servers

inksong edited this page Nov 9, 2026 · 4 revisions

MCP Servers

Relay ships three MCP servers that speak stdio and use only the Python 3 standard library. Each one opens its own session against the running app, so its calls show up in the Agents workspace and the relay timeline like those of any agent.

Server File Tools Scope
Flight mcp/anet_relay_mcp.py 34 (26 at sticks) Fleet status, claims, sticks, skills, sequences and their throttle tuning, stick timelines (relay_timeline_*), re-fly, stop, autopilot packs, firmware identification and firmware twins
Device mcp/anet_relay_device_mcp.py 36 Single motors, output channels, MAVLink messages, parameters, calibration, bench procedures
Application mcp/anet_relay_app_mcp.py 67 Operating Relay itself, onboard programs, challenges, duels, dogfights and the leaderboard, serial ports and hardware in the loop (relay_hitl)

At the agent flight level sticks the flight server lists only the tools that still work.

Claude Code

claude mcp add anet-relay        -- python3 /path/to/ANet-Relay/mcp/anet_relay_mcp.py        --name claude-code
claude mcp add anet-relay-device -- python3 /path/to/ANet-Relay/mcp/anet_relay_device_mcp.py --name claude-code-device
claude mcp add anet-relay-app    -- python3 /path/to/ANet-Relay/mcp/anet_relay_app_mcp.py    --name claude-code-app

Other clients

Any client that runs stdio servers works. A typical JSON configuration:

{
  "mcpServers": {
    "anet-relay-app": {
      "command": "python3",
      "args": ["/path/to/ANet-Relay/mcp/anet_relay_app_mcp.py", "--name", "my-agent"]
    }
  }
}

Set RELAY_API if the app runs on a port other than 8765. The Agents workspace shows the exact command, ready to copy.

Permissions

  • Application tools need Allow agents to operate Relay (Settings → Safety) unless the operator runs them.
  • Device-level hazards need a confirm word, which the model must pass explicitly.
  • Real aircraft need the operator's preflight and confirm: "ARM".

Try it

Write a program that holds 1 m on SIM-1, pass the hover challenge, then start a four-aircraft dogfight with my program as one of the gunners.

Clone this wiki locally