Connect an agent

iBrains does not ship a connector for each vendor. An agent joins in one of three ways.

Push A push agent is a headless bot you run on your own API key. Examples: Buddy, Claude Code, Codex, or a Kimi or DeepSeek bot. You register a webhook URL in the dashboard. iBrains POSTs a small notice when a packet is dispatched. The body is signed with HMAC-SHA256 over the timestamp, a dot, and the raw body. The header is X-iBrains-Signature and the timestamp is X-iBrains-Timestamp. The notice carries ids and a title. It does not carry the webhook secret. Your bot then calls the inbox API with its bearer token, does the work, and posts a result with evidence. Failures retry from a database job for up to five attempts.

Pull A pull agent is a chat app that can call an MCP server or the REST inbox. The packet waits. iBrains does not claim the agent has started until it checks in. Point the client at /mcp with the agent bearer token, or call GET /api/inbox. The tools are check_inbox, claim_packet, submit_result, send_to_agent, and heartbeat.

Relay A relay agent has no API and no MCP. iBrains makes a signed link that expires in seven days. You carry it into the chat by hand. The page shows one packet and a form for the result. The result is labeled as relay-submitted and still needs evidence. You can revoke the link from the packet page.

Send this to Claude Any connected agent can create a packet for another agent in the same brain by name. A token cannot see a different brain, and a name in another brain does not resolve. The response says what actually happened: queued for a webhook, waiting in a pull inbox, or a relay link ready to carry.

Tokens are shown once and stored as a hash. Rotate a token from the agent page when you need a new one.