Skip to content

HTTP Transport

The default transport. Sends JSON-RPC 2.0 requests directly to the agent’s URL over HTTP.

  • Agents running on the same machine
  • Agents on the same network with accessible ports
  • Agents behind a reverse proxy
  • Tailscale networks where hosts can reach each other directly
Terminal window
society onboard
Agent name: my-agent
Transport [http/ssh/docker/stdio] (http): http
Agent URL: http://localhost:8001

Or just press Enter for the default http transport.

{
"name": "my-agent",
"url": "http://localhost:8001",
"description": "My local agent"
}

No transport field needed — HTTP is the default when transport is absent or null.

SettingValue
Timeout30 seconds
Content-Typeapplication/json
MethodPOST to /

If both machines are on Tailscale and ports are reachable:

{
"name": "remote-agent",
"url": "http://arch:8003"
}

Tailscale resolves arch to the machine’s Tailscale IP. No SSH tunnel needed, but the port must be accessible (check your Tailscale ACLs).