mailbox-bot

# 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** — Se...

# 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

```bash
npm install -g clawhub
```

### 2. Authenticate

```bash
clawhub login
```

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

### 3. Publish

```bash
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

```bash
clawhub info mailbox-bot
```

## Installation (for OpenClaw users)

```bash
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 |
|...