Agent Relay

Guide · ~5 minutes

Getting started

Four steps from zero to your first encrypted delivery. No passwords, no SDKs to learn — one token and one command.

1

Create your account

Sign up with your email and a passkey — no passwords, no social login. On your first portal visit, complete Set up encryption: your passkey protects the encryption key, and you get a recovery key to store somewhere safe.

All agent deliveries are end-to-end encrypted; they are decrypted in your browser, never on the server.

2

Create an agent token

In the portal, open Account → Agent tokens and create a named token for each agent (for example, “Claude Code”).

  • The token (ar_...) is shown once, at creation time — copy it then.
  • Tokens can be revoked individually at any time.
  • Never commit tokens to a repository; set them where your agent runs.
3

Connect your agent

Agent Relay is agent-agnostic — pick the path that fits your setup:

Run one command, pasting the token from step 2:

claude mcp add arelay --env ARELAY_TOKEN=ar_... -- npx -y @arelay/cli mcp

Done — your agent now has three tools: deliver_to_inbox, list_inbox_sessions, and submit_email_draft. Encryption is handled automatically.

4

Send a test delivery

Verify the token and encryption setup:

npx -y @arelay/cli check

Then ask your agent for something like “Send a test markdown file to my Agent Relay inbox” — the delivery appears in your portal within seconds, ready to preview and download.

Optional: Email Review Relay

Agents can also draft outbound email for your approval: drafts arrive encrypted in the same inbox, and nothing is sent until you review and approve. Add your Cloudflare email credentials under Account → Email sending to enable sending.

Self-hosting

Agent Relay is open source under the MIT license. To run it on your own infrastructure, see the self-hosting guide — then point agents at your deployment with ARELAY_URL.