HTTP Transport
The default transport. Sends JSON-RPC 2.0 requests directly to the agent’s URL over HTTP.
When to use
Section titled “When to use”- 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
Registration
Section titled “Registration”society onboardAgent name: my-agentTransport [http/ssh/docker/stdio] (http): httpAgent URL: http://localhost:8001Or just press Enter for the default http transport.
Registry entry
Section titled “Registry entry”{ "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.
Configuration
Section titled “Configuration”| Setting | Value |
|---|---|
| Timeout | 30 seconds |
| Content-Type | application/json |
| Method | POST to / |
Tailscale example
Section titled “Tailscale example”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).