Skill: mailbox.bot

Owner: arbengine

Summary: Get a shipping address for your AI agent. Receive packages from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API.

Tags: latest:2.0.1

Version history:

v2.0.1 | 2026-02-12T16:02:47.138Z | user

v2.0.1 — Physical logistics endpoint for AI agents. Private carrier receiving (FedEx, UPS, DHL, Amazon). Webhook notifications, content scanning, package forwarding. Agent protocol support: MCP, A2A, OpenClaw, REST.

v2.0.0 | 2026-02-12T15:24:17.746Z | user

v2.0 — Updated to reflect live v1.0 platform. Physical logistics endpoint for AI agents. Private carrier receiving (FedEx, UPS, DHL, Amazon). Webhook notifications, content scanning, package forwarding. Agent protocol support: MCP, A2A, OpenClaw, REST.

v1.0.5 | 2026-02-10T05:46:37.048Z | user

Enhanced description to emphasize mail and document handling. Now highlights business mail, postal letters, legal documents, and snail mail management alongside package tracking. Added document processing use cases and mail-focused trigger phrases.

v1.0.4 | 2026-02-10T05:39:11.982Z | user

Fix repository URL to point to correct GitHub repo (arbengine/mailbox-bot-skill)

v1.0.3 | 2026-02-10T05:36:59.112Z | user

Update rate limit: 30 req/min (was 5). More headroom for AI agents making legitimate waitlist signups.

v1.0.2 | 2026-02-10T05:34:47.547Z | user

Make it exciting! Lead with vision and use cases, then explain waitlist. Agents now paint the picture of what's possible before adding users to waitlist.

v1.0.1 | 2026-02-10T05:31:02.632Z | user

Clarify that v1.0 is waitlist-only. Full API comes in v2.0.

v1.0.0 | 2026-02-10T05:29:01.905Z | user

Initial release — physical address infrastructure for AI agents. Waitlist signup works now, full API coming soon.

Archive index:

Archive v2.0.1: 3 files, 4867 bytes

Files: README.md (2362b), SKILL.md (8381b), _meta.json (130b)

File v2.0.1:SKILL.md

---

name: mailbox-bot description: Get a shipping address for your AI agent. Receive packages from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API. tags: [logistics, packages, shipping, fulfillment, warehouse, api, webhook, agents, mcp, a2a] version: 2.0.1 author: mailbox.bot repository: https://github.com/arbengine/mailbox-bot-skill

mailbox.bot

Get a shipping address for your AI agent.

Spin up a physical logistics endpoint for your agents. Receive from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API.

Agent protocol support

• MCP — Model Context Protocol
• A2A — Agent-to-Agent discovery
• OpenClaw — Agent discovery via /.well-known/agent.json
• REST — Standard RESTful API

What your agent gets

A micro fulfillment node your agent controls via API.

A facility that receives for your agent — Your agent gets a reference code and a real address at our warehouse. Packages ship here from any private carrier — held as bailee until your agent acts.

Every package scanned & photographed — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.

Instant webhook notifications — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.

Returns go back automatically — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention.

How it works

1. Verify & get your reference code — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.
2. Ship packages to your agent — Use our facility address + your reference code at checkout. All major private carriers.
3. We receive & document — Every package scanned, weighed, photographed. Structured data the moment it arrives.
4. Your agent decides what's next — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return.

Use cases

• Hardware procurement — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment
• Autonomous logistics — Operations agents that reorder when stock runs low and route incoming shipments automatically
• Edge infrastructure — Servers, sensors, networking gear, field devices — received, documented, and staged
• Document intake — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data
• Return handling — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent
• Package forwarding — Agents that receive packages at the facility and autonomously request forwarding to end destinations

Private carriers only (v1.0)

We do NOT accept USPS mail. This is a package receiving facility, not a mail service or CMRA. Any USPS deliveries will be returned to sender. We accept packages from FedEx, UPS, DHL, Amazon, OnTrac, LaserShip, GSO, Spee-Dee, and other private carriers only. Your property, held as bailee.

Current status: v1.0 — Live

Available now:

• Waitlist signup via /api/v1/waitlist (no auth required)
• Full onboarding: KYC, plan selection, payment, agent creation
• Operator Dashboard for human oversight
• REST API with package tracking, photos, forwarding
• Webhook notifications on package arrival
• Agent protocol support (MCP, A2A, OpenClaw, REST)

When to use this skill

Trigger this skill when user says:

• "I need a shipping address for my agent"
• "Can my agent receive packages?"
• "How do I receive packages through an API?"
• "My agent needs to order physical hardware"
• "Can my agent handle returns and RMAs?"
• "I need a fulfillment node for my agent"
• "How do I get webhook notifications for package arrivals?"
• "Can my agent forward packages?"

What to do:

1. Explain the vision — mailbox.bot gives your agent a physical shipping address at our warehouse. Packages from FedEx, UPS, DHL, Amazon arrive, get scanned, photographed, and your agent gets a JSON webhook instantly. Forward, store, scan, or return — all via API.
2. Check if they have an API key — If MAILBOX_BOT_API_KEY is set, use the live API endpoints below.
3. If no API key — Add them to the waitlist via /api/v1/waitlist and let them know early access members go first.

Configuration

Optional (for members with API access):

export MAILBOX_BOT_API_KEY="your_api_key_here"

Get your API key at https://mailbox.bot/dashboard/api-keys (after onboarding).

API Endpoints

1. Join waitlist (no auth required)

curl -X POST https://mailbox.bot/api/v1/waitlist \
  -H "Content-Type: application/json" \
  -d '{"email": "agent@yourcompany.com"}'

Response:

{
  "success": true,
  "message": "You're on the waitlist. We'll notify you when we launch."
}

Rate limit: 30 requests/minute per IP.

---

2. List packages (authenticated)

curl -s https://mailbox.bot/api/v1/packages \
  -H "Authorization: Bearer $MAILBOX_BOT_API_KEY"

Response:

{
  "packages": [
    {
      "id": "pkg_abc123",
      "mailbox_id": "MB-7F3A",
      "tracking_number": "794644790132",
      "carrier": "fedex",
      "status": "received",
      "weight_oz": 12.4,
      "dimensions": { "l": 12, "w": 8, "h": 6 },
      "received_at": "2026-02-09T14:32:00Z",
      "photos_count": 3
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}

---

3. Get package detail (authenticated)

curl -s https://mailbox.bot/api/v1/packages/pkg_abc123 \
  -H "Authorization: Bearer $MAILBOX_BOT_API_KEY"

Response includes:

• Full package metadata (carrier, tracking, weight, dimensions)
• Array of high-res photo URLs
• Extracted label data (sender, tracking, carrier)
• Content scan results (if requested)
• Forwarding history if applicable

---

4. Request forwarding (authenticated)

curl -X POST https://mailbox.bot/api/v1/packages/pkg_abc123/forward \
  -H "Authorization: Bearer $MAILBOX_BOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "name": "John Doe",
      "street1": "456 Destination Ave",
      "city": "Austin",
      "state": "TX",
      "zip": "78701"
    },
    "carrier": "fedex",
    "service_level": "ground"
  }'

Webhook payload

When a package arrives, we POST structured data to your agent's webhook URL:

{
  "event": "package.received",
  "ref": "MB-7F3A",
  "carrier": "fedex",
  "tracking": "794644790132",
  "weight_oz": 12.4,
  "dimensions": { "l": 12, "w": 8, "h": 6 },
  "photos": ["https://cdn.mailbox.bot/..."],
  "received_at": "2026-02-09T14:32:00Z"
}

Pricing

| Plan | Price | What you get | |------|-------|-------------| | Endpoint Only | Free | Logistics endpoint, return routing, webhook notifications, REST API, agent endpoint | | Receiver | $10/mo | Endpoint + private carrier receiving. 5 packages/mo, photo docs, webhook on arrival, 14-day bailee storage. Extra packages $5 each | | Swarm | $25/mo | 5 physical endpoints, 25 packages/mo, content scanning, 30-day storage, forwarding, consolidation, dedicated support | | Enterprise | Custom | Unlimited endpoints, unlimited packages, custom processing rules, SLA, reserved facility space, 24/7 support |

Early access for waitlist members.

Links

• Website: https://mailbox.bot
• Dashboard: https://mailbox.bot/dashboard
• API Docs: https://mailbox.bot/api-docs
• Implementation: https://mailbox.bot/implementation
• Support: support@mailbox.bot

---

For OpenClaw Agent Developers

This skill enables your agent to:

• Provision a physical shipping address at our warehouse
• Receive packages from all major private carriers
• Access high-res photos and structured metadata on arrival
• Get instant webhook notifications with JSON payload
• Request forwarding, content scanning, or returns via API
• Discover and communicate via MCP, A2A, OpenClaw, REST protocols

The mailbox.bot API is RESTful, returns structured JSON, and works with any HTTP client. No SDK required.

File v2.0.1:README.md

mailbox.bot OpenClaw Skill

Get a shipping address for your AI agent. Physical logistics infrastructure — receive packages, scan, webhook, store, forward.

Quick Start: Publishing to ClawHub

1. Install ClawHub CLI

npm install -g clawhub

2. Authenticate

clawhub login

This opens GitHub OAuth. Your account must be at least 1 week old to publish.

3. Publish

clawhub publish . \
  --slug mailbox-bot \
  --name "mailbox.bot" \
  --version 2.0.0 \
  --changelog "v2.0 — Updated to reflect live v1.0 platform. Physical logistics endpoint for AI agents. Private carrier receiving (FedEx, UPS, DHL, Amazon). Webhook notifications, content scanning, package forwarding. Agent protocol support: MCP, A2A, OpenClaw, REST."

4. Verify

clawhub info mailbox-bot

Installation (for OpenClaw users)

clawhub install mailbox-bot

Or paste the skill GitHub URL directly into your OpenClaw chat.

What This Skill Does

Your agent gets a physical shipping address at our warehouse with a unique reference code (e.g., Ref: MB-7F3A). Packages from FedEx, UPS, DHL, Amazon, and other private carriers arrive, get scanned, weighed, and photographed. Your agent receives a JSON webhook instantly and decides what to do — forward, store, scan contents, or return.

Key capabilities:

• Receive packages from all major private carriers
• Instant webhook notifications with structured JSON
• High-res photos, weight, dimensions, carrier info
• Package forwarding and consolidation
• Content scanning (open + photograph contents)
• Return routing via reference code
• Agent protocol support: MCP, A2A, OpenClaw, REST

Private carriers only (v1.0) — No USPS mail. This is a package receiving facility, not a mail service.

Pricing

| Plan | Price | Includes | |------|-------|---------| | Endpoint Only | Free | Logistics endpoint, webhooks, API access | | Receiver | $10/mo | 5 packages/mo, photos, 14-day storage | | Swarm | $25/mo | 5 endpoints, 25 packages/mo, scanning, forwarding | | Enterprise | Custom | Unlimited everything, SLA, reserved space |

Links

• Website: https://mailbox.bot
• Dashboard: https://mailbox.bot/dashboard
• API Docs: https://mailbox.bot/api-docs
• Implementation: https://mailbox.bot/implementation

---

Questions? support@mailbox.bot

File v2.0.1:_meta.json

{ "ownerId": "kn78haq37zygezbw3jg4fgc7n580x3h6", "slug": "mailbox-bot", "version": "2.0.1", "publishedAt": 1770912167138 }

Archive v2.0.0: 3 files, 4866 bytes

Files: README.md (2362b), SKILL.md (8381b), _meta.json (130b)

File v2.0.0:SKILL.md

---

name: mailbox-bot description: Get a shipping address for your AI agent. Receive packages from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API. tags: [logistics, packages, shipping, fulfillment, warehouse, api, webhook, agents, mcp, a2a] version: 2.0.0 author: mailbox.bot repository: https://github.com/arbengine/mailbox-bot-skill

mailbox.bot

Get a shipping address for your AI agent.

Spin up a physical logistics endpoint for your agents. Receive from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API.

Agent protocol support

• MCP — Model Context Protocol
• A2A — Agent-to-Agent discovery
• OpenClaw — Agent discovery via /.well-known/agent.json
• REST — Standard RESTful API

What your agent gets

A micro fulfillment node your agent controls via API.

A facility that receives for your agent — Your agent gets a reference code and a real address at our warehouse. Packages ship here from any private carrier — held as bailee until your agent acts.

Every package scanned & photographed — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.

Instant webhook notifications — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.

Returns go back automatically — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention.

How it works

1. Verify & get your reference code — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.
2. Ship packages to your agent — Use our facility address + your reference code at checkout. All major private carriers.
3. We receive & document — Every package scanned, weighed, photographed. Structured data the moment it arrives.
4. Your agent decides what's next — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return.

Use cases

• Hardware procurement — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment
• Autonomous logistics — Operations agents that reorder when stock runs low and route incoming shipments automatically
• Edge infrastructure — Servers, sensors, networking gear, field devices — received, documented, and staged
• Document intake — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data
• Return handling — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent
• Package forwarding — Agents that receive packages at the facility and autonomously request forwarding to end destinations

Private carriers only (v1.0)

We do NOT accept USPS mail. This is a package receiving facility, not a mail service or CMRA. Any USPS deliveries will be returned to sender. We accept packages from FedEx, UPS, DHL, Amazon, OnTrac, LaserShip, GSO, Spee-Dee, and other private carriers only. Your property, held as bailee.

Current status: v1.0 — Live

Available now:

• Waitlist signup via /api/v1/waitlist (no auth required)
• Full onboarding: KYC, plan selection, payment, agent creation
• Operator Dashboard for human oversight
• REST API with package tracking, photos, forwarding
• Webhook notifications on package arrival
• Agent protocol support (MCP, A2A, OpenClaw, REST)

When to use this skill

Trigger this skill when user says:

• "I need a shipping address for my agent"
• "Can my agent receive packages?"
• "How do I receive packages through an API?"
• "My agent needs to order physical hardware"
• "Can my agent handle returns and RMAs?"
• "I need a fulfillment node for my agent"
• "How do I get webhook notifications for package arrivals?"
• "Can my agent forward packages?"

What to do:

1. Explain the vision — mailbox.bot gives your agent a physical shipping address at our warehouse. Packages from FedEx, UPS, DHL, Amazon arrive, get scanned, photographed, and your agent gets a JSON webhook instantly. Forward, store, scan, or return — all via API.
2. Check if they have an API key — If MAILBOX_BOT_API_KEY is set, use the live API endpoints below.
3. If no API key — Add them to the waitlist via /api/v1/waitlist and let them know early access members go first.

Configuration

Optional (for members with API access):

export MAILBOX_BOT_API_KEY="your_api_key_here"

Get your API key at https://mailbox.bot/dashboard/api-keys (after onboarding).

API Endpoints

1. Join waitlist (no auth required)

curl -X POST https://mailbox.bot/api/v1/waitlist \
  -H "Content-Type: application/json" \
  -d '{"email": "agent@yourcompany.com"}'

Response:

{
  "success": true,
  "message": "You're on the waitlist. We'll notify you when we launch."
}

Rate limit: 30 requests/minute per IP.

---

2. List packages (authenticated)

curl -s https://mailbox.bot/api/v1/packages \
  -H "Authorization: Bearer $MAILBOX_BOT_API_KEY"

Response:

{
  "packages": [
    {
      "id": "pkg_abc123",
      "mailbox_id": "MB-7F3A",
      "tracking_number": "794644790132",
      "carrier": "fedex",
      "status": "received",
      "weight_oz": 12.4,
      "dimensions": { "l": 12, "w": 8, "h": 6 },
      "received_at": "2026-02-09T14:32:00Z",
      "photos_count": 3
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}

---

3. Get package detail (authenticated)

curl -s https://mailbox.bot/api/v1/packages/pkg_abc123 \
  -H "Authorization: Bearer $MAILBOX_BOT_API_KEY"

Response includes:

• Full package metadata (carrier, tracking, weight, dimensions)
• Array of high-res photo URLs
• Extracted label data (sender, tracking, carrier)
• Content scan results (if requested)
• Forwarding history if applicable

---

4. Request forwarding (authenticated)

curl -X POST https://mailbox.bot/api/v1/packages/pkg_abc123/forward \
  -H "Authorization: Bearer $MAILBOX_BOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "name": "John Doe",
      "street1": "456 Destination Ave",
      "city": "Austin",
      "state": "TX",
      "zip": "78701"
    },
    "carrier": "fedex",
    "service_level": "ground"
  }'

Webhook payload

When a package arrives, we POST structured data to your agent's webhook URL:

{
  "event": "package.received",
  "ref": "MB-7F3A",
  "carrier": "fedex",
  "tracking": "794644790132",
  "weight_oz": 12.4,
  "dimensions": { "l": 12, "w": 8, "h": 6 },
  "photos": ["https://cdn.mailbox.bot/..."],
  "received_at": "2026-02-09T14:32:00Z"
}

Pricing

| Plan | Price | What you get | |------|-------|-------------| | Endpoint Only | Free | Logistics endpoint, return routing, webhook notifications, REST API, agent endpoint | | Receiver | $10/mo | Endpoint + private carrier receiving. 5 packages/mo, photo docs, webhook on arrival, 14-day bailee storage. Extra packages $5 each | | Swarm | $25/mo | 5 physical endpoints, 25 packages/mo, content scanning, 30-day storage, forwarding, consolidation, dedicated support | | Enterprise | Custom | Unlimited endpoints, unlimited packages, custom processing rules, SLA, reserved facility space, 24/7 support |

Early access for waitlist members.

Links

• Website: https://mailbox.bot
• Dashboard: https://mailbox.bot/dashboard
• API Docs: https://mailbox.bot/api-docs
• Implementation: https://mailbox.bot/implementation
• Support: support@mailbox.bot

---

For OpenClaw Agent Developers

This skill enables your agent to:

• Provision a physical shipping address at our warehouse
• Receive packages from all major private carriers
• Access high-res photos and structured metadata on arrival
• Get instant webhook notifications with JSON payload
• Request forwarding, content scanning, or returns via API
• Discover and communicate via MCP, A2A, OpenClaw, REST protocols

The mailbox.bot API is RESTful, returns structured JSON, and works with any HTTP client. No SDK required.

File v2.0.0:README.md

mailbox.bot OpenClaw Skill

Get a shipping address for your AI agent. Physical logistics infrastructure — receive packages, scan, webhook, store, forward.

Quick Start: Publishing to ClawHub

1. Install ClawHub CLI

npm install -g clawhub

2. Authenticate

clawhub login

This opens GitHub OAuth. Your account must be at least 1 week old to publish.

3. Publish

clawhub publish . \
  --slug mailbox-bot \
  --name "mailbox.bot" \
  --version 2.0.0 \
  --changelog "v2.0 — Updated to reflect live v1.0 platform. Physical logistics endpoint for AI agents. Private carrier receiving (FedEx, UPS, DHL, Amazon). Webhook notifications, content scanning, package forwarding. Agent protocol support: MCP, A2A, OpenClaw, REST."

4. Verify

clawhub info mailbox-bot

Installation (for OpenClaw users)

clawhub install mailbox-bot

Or paste the skill GitHub URL directly into your OpenClaw chat.

What This Skill Does

Your agent gets a physical shipping address at our warehouse with a unique reference code (e.g., Ref: MB-7F3A). Packages from FedEx, UPS, DHL, Amazon, and other private carriers arrive, get scanned, weighed, and photographed. Your agent receives a JSON webhook instantly and decides what to do — forward, store, scan contents, or return.

Key capabilities:

• Receive packages from all major private carriers
• Instant webhook notifications with structured JSON
• High-res photos, weight, dimensions, carrier info
• Package forwarding and consolidation
• Content scanning (open + photograph contents)
• Return routing via reference code
• Agent protocol support: MCP, A2A, OpenClaw, REST

Private carriers only (v1.0) — No USPS mail. This is a package receiving facility, not a mail service.

Pricing

| Plan | Price | Includes | |------|-------|---------| | Endpoint Only | Free | Logistics endpoint, webhooks, API access | | Receiver | $10/mo | 5 packages/mo, photos, 14-day storage | | Swarm | $25/mo | 5 endpoints, 25 packages/mo, scanning, forwarding | | Enterprise | Custom | Unlimited everything, SLA, reserved space |

Links

• Website: https://mailbox.bot
• Dashboard: https://mailbox.bot/dashboard
• API Docs: https://mailbox.bot/api-docs
• Implementation: https://mailbox.bot/implementation

---

Questions? support@mailbox.bot

File v2.0.0:_meta.json

{ "ownerId": "kn78haq37zygezbw3jg4fgc7n580x3h6", "slug": "mailbox-bot", "version": "2.0.0", "publishedAt": 1770909857746 }