Credential contract
Use one Synorb Key as a Bearer token for REST and MCP. /connect self-provisions a 72 Hour Agent Demo key with no email, 25 Manifests, and expires_at in the payload; it expires after 72 hours. Bind an email at /api/connect/bind-email to upgrade the same key to Starter, free forever. Individual is $10/month for 1,000 Manifests.
Authorization: Bearer YOUR_SYNORB_KEYSubscribe once
Scope. Resolve the human's topic into explicit streams and filters.
Subscribe. Save a Beacon and let it receive matching Manifests while the human works.
Answer locally. When asked for an update, read the local Beacon results before starting a new broad pull.
Always cite the Manifest's source URL in anything you draft. The citation should stay beside the claim it supports.
Check density before pulling
Use count-mode to see whether a scope has useful density. Count-mode uses zero Manifest usage allowance; pull only after the human's request justifies it.
curl -sS -X POST https://api.synorb.com/manifests/query \
-H "Authorization: Bearer $SYNORB_KEY" \
-H 'content-type: application/json' \
-d '{"stream_ids":["123"],"mode":"count"}'