Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Deliver sealed requests when the Mac is asleep.
box_pubkey
from /v1/resolve with a libsodium sealed box (crypto_box_seal, X25519):
{
"method": "POST",
"path": "/mcp",
"headers": {
"content-type": "application/json",
"accept": "application/json, text/event-stream",
"content-digest": "sha-256=:…:",
"signature-input": "sig1=…",
"signature": "sig1=:…:",
"host": "<hostname>"
},
"body": { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { } }
}
https://<hostname>/mcp (same headers as a live call). Keep
the sealed envelope ≤ 64 KiB (stricter than live MCP’s 256 KiB).
POST https://relay.fau.run/v1/queue/<full-hostname>
Content-Type: application/json
{ "envelope": "<base64url sealed box>", "request_id": "<optional>" }
hostname is the full FQDN from resolve (e.g. n….relay.fau.run).
Response 202:
{ "request_id": "…", "expires_at": 1760000000 }
request_id
makes retries idempotent.
GET https://relay.fau.run/v1/queue/reply/<request_id>
| Status | Meaning |
|---|---|
204 | Still pending |
200 | {"envelope":"<base64url>"} |
404 | Expired or unknown |
| Status | error |
|---|---|
400 | bad_request |
404 | not_found |
413 | too_large |
429 | rate_limited |
507 | queue_full |