agent setup kit

Skill up your agent

Hand this to Cursor, OpenClaw, or any agent that can run API setup. Receive-only inbound email with signed JSON webhooks — no SMTP to build.

OpenClaw skill

Add the agentinbox skill to your OpenClaw workspace — copy or download the markdown file.

Copy for Cursor

Paste into chat. Your agent should create a workspace, register a domain or instant inbox, configure DNS, and wire the webhook.

setup prompt

Set up agentinbox.pro inbound email for my agent.

Goal: receive-only inbound email → signed JSON webhook (event type inbound.email.received).

Fastest path (no DNS):
1. POST https://api.agentinbox.pro/api/workspaces → save apiKey from response
2. POST /api/instant-inbox with Authorization: Bearer <apiKey>
3. Send test mail to the returned address
4. GET /api/domains/:id/events for the normalized payload

Production path (custom domain):
1. POST https://api.agentinbox.pro/api/workspaces → save apiKey from response
2. POST /api/domains with {"domain":"my-agent.example.com"} using Authorization: Bearer <apiKey>
3. Add TXT + MX DNS records from the API response (verify ownership, then MX to mx.agentinbox.pro)
4. POST /api/domains/:id/verify after TXT propagates
5. PATCH /api/domains/:id/delivery with {"webhookUrl":"https://my-server/inbound-email"}
6. Send test mail to any address on the domain

Verify webhook HMAC: X-AgentMail-Signature, X-AgentMail-Timestamp, X-AgentMail-Event-Id

Docs:
- https://docs.agentinbox.pro/quickstart/
- https://docs.agentinbox.pro/guides/webhook-events/
- https://docs.agentinbox.pro/guides/openclaw-email-setup/

MCP config (Cursor)

Optional stdio MCP server with create_instant_inbox and get_latest_inbound_event tools. Build with pnpm --filter @agentmail/mcp-email build.

mcp.json snippet

{
  "mcpServers": {
    "agentinbox-email": {
      "command": "node",
      "args": ["/path/to/agent-mail/packages/mcp-email/dist/index.js"],
      "env": {
        "AGENTINBOX_API_KEY": "ak_live_..."
      }
    }
  }
}