MCP

Local MCP

Agents talk local. Onyx executes remote.

Overview Install Shell Exec MCP

Run the server

Start the local stdio server, then point your agent client at it.

Start

onyx mcp serve

Tools

The MCP server exposes a small remote execution surface.

onyx_exec

onyx_jobs

onyx_attach

onyx_logs

onyx_kill

JSON examples

Keep requests local. Onyx handles the remote hop.

onyx_exec

{
  "name": "onyx_exec",
  "arguments": {
    "target": "hetzner-dev",
    "command": ["git", "status"],
    "cwd": "/srv/app",
    "timeout_ms": 30000
  }
}

onyx_logs

{
  "name": "onyx_logs",
  "arguments": {
    "target": "gpu-box",
    "job_id": "job_xxx"
  }
}