{"id":"a6e63ebc-b200-4f0e-893b-2f9bf3793ab4","entityType":"agent","slug":"clawhub-arbengine-mailbox-bot","name":"mailbox.bot","canonicalUrl":"https://www.xpersona.co/agent/clawhub-arbengine-mailbox-bot","canonicalPath":"/agent/clawhub-arbengine-mailbox-bot","generatedAt":"2026-10-09T05:21:15.922Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"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. 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 notif","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn78haq37zygezbw3jg4fgc7n580x3h6:mailbox-bot","sourceUrl":"https://clawhub.ai/arbengine/mailbox-bot","homepage":"https://clawhub.ai/arbengine/mailbox-bot","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/arbengine/mailbox-bot","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"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 "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":1010,"packageName":null,"latestVersion":"2.0.1","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-03-01T00:53:04.009Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-03-01T00:53:04.009Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T00:53:04.009Z","lastVerifiedAt":null,"highlights":[{"version":"2.0.1","createdAt":"2026-02-12T16:02:47.138Z","changelog":"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.","fileCount":3,"zipByteSize":4867},{"version":"2.0.0","createdAt":"2026-02-12T15:24:17.746Z","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.","fileCount":3,"zipByteSize":4866},{"version":"1.0.5","createdAt":"2026-02-10T05:46:37.048Z","changelog":"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.","fileCount":null,"zipByteSize":null},{"version":"1.0.4","createdAt":"2026-02-10T05:39:11.982Z","changelog":"Fix repository URL to point to correct GitHub repo (arbengine/mailbox-bot-skill)","fileCount":null,"zipByteSize":null},{"version":"1.0.3","createdAt":"2026-02-10T05:36:59.112Z","changelog":"Update rate limit: 30 req/min (was 5). More headroom for AI agents making legitimate waitlist signups.","fileCount":null,"zipByteSize":null},{"version":"1.0.2","createdAt":"2026-02-10T05:34:47.547Z","changelog":"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.","fileCount":null,"zipByteSize":null},{"version":"1.0.1","createdAt":"2026-02-10T05:31:02.632Z","changelog":"Clarify that v1.0 is waitlist-only. Full API comes in v2.0.","fileCount":null,"zipByteSize":null},{"version":"1.0.0","createdAt":"2026-02-10T05:29:01.905Z","changelog":"Initial release — physical address infrastructure for AI agents. Waitlist signup works now, full API coming soon.","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn78haq37zygezbw3jg4fgc7n580x3h6:mailbox-bot","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T05:21:15.922Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-arbengine-mailbox-bot/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: mailbox.bot\n\nOwner: arbengine\n\nSummary: 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.\n\nTags: latest:2.0.1\n\nVersion history:\n\nv2.0.1 | 2026-02-12T16:02:47.138Z | user\n\nv2.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.\n\nv2.0.0 | 2026-02-12T15:24:17.746Z | user\n\nv2.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.\n\nv1.0.5 | 2026-02-10T05:46:37.048Z | user\n\nEnhanced 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.\n\nv1.0.4 | 2026-02-10T05:39:11.982Z | user\n\nFix repository URL to point to correct GitHub repo (arbengine/mailbox-bot-skill)\n\nv1.0.3 | 2026-02-10T05:36:59.112Z | user\n\nUpdate rate limit: 30 req/min (was 5). More headroom for AI agents making legitimate waitlist signups.\n\nv1.0.2 | 2026-02-10T05:34:47.547Z | user\n\nMake 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.\n\nv1.0.1 | 2026-02-10T05:31:02.632Z | user\n\nClarify that v1.0 is waitlist-only. Full API comes in v2.0.\n\nv1.0.0 | 2026-02-10T05:29:01.905Z | user\n\nInitial release — physical address infrastructure for AI agents. Waitlist signup works now, full API coming soon.\n\nArchive index:\n\nArchive v2.0.1: 3 files, 4867 bytes\n\nFiles: README.md (2362b), SKILL.md (8381b), _meta.json (130b)\n\nFile v2.0.1:SKILL.md\n\n---\nname: mailbox-bot\ndescription: 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.\ntags: [logistics, packages, shipping, fulfillment, warehouse, api, webhook, agents, mcp, a2a]\nversion: 2.0.1\nauthor: mailbox.bot\nrepository: https://github.com/arbengine/mailbox-bot-skill\n---\n\n# mailbox.bot\n\n**Get a shipping address for your AI agent.**\n\nSpin 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.\n\n## Agent protocol support\n\n- **MCP** — Model Context Protocol\n- **A2A** — Agent-to-Agent discovery\n- **OpenClaw** — Agent discovery via `/.well-known/agent.json`\n- **REST** — Standard RESTful API\n\n## What your agent gets\n\nA micro fulfillment node your agent controls via API.\n\n**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.\n\n**Every package scanned & photographed** — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.\n\n**Instant webhook notifications** — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.\n\n**Returns go back automatically** — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention.\n\n## How it works\n\n1. **Verify & get your reference code** — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.\n2. **Ship packages to your agent** — Use our facility address + your reference code at checkout. All major private carriers.\n3. **We receive & document** — Every package scanned, weighed, photographed. Structured data the moment it arrives.\n4. **Your agent decides what's next** — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return.\n\n## Use cases\n\n- **Hardware procurement** — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment\n- **Autonomous logistics** — Operations agents that reorder when stock runs low and route incoming shipments automatically\n- **Edge infrastructure** — Servers, sensors, networking gear, field devices — received, documented, and staged\n- **Document intake** — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data\n- **Return handling** — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent\n- **Package forwarding** — Agents that receive packages at the facility and autonomously request forwarding to end destinations\n\n## Private carriers only (v1.0)\n\nWe 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.\n\n## Current status: v1.0 — Live\n\n**Available now:**\n- Waitlist signup via `/api/v1/waitlist` (no auth required)\n- Full onboarding: KYC, plan selection, payment, agent creation\n- Operator Dashboard for human oversight\n- REST API with package tracking, photos, forwarding\n- Webhook notifications on package arrival\n- Agent protocol support (MCP, A2A, OpenClaw, REST)\n\n## When to use this skill\n\n**Trigger this skill when user says:**\n- \"I need a shipping address for my agent\"\n- \"Can my agent receive packages?\"\n- \"How do I receive packages through an API?\"\n- \"My agent needs to order physical hardware\"\n- \"Can my agent handle returns and RMAs?\"\n- \"I need a fulfillment node for my agent\"\n- \"How do I get webhook notifications for package arrivals?\"\n- \"Can my agent forward packages?\"\n\n**What to do:**\n1. **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.\n2. **Check if they have an API key** — If `MAILBOX_BOT_API_KEY` is set, use the live API endpoints below.\n3. **If no API key** — Add them to the waitlist via `/api/v1/waitlist` and let them know early access members go first.\n\n## Configuration\n\n**Optional** (for members with API access):\n```bash\nexport MAILBOX_BOT_API_KEY=\"your_api_key_here\"\n```\n\nGet your API key at https://mailbox.bot/dashboard/api-keys (after onboarding).\n\n## API Endpoints\n\n### 1. Join waitlist (no auth required)\n\n```bash\ncurl -X POST https://mailbox.bot/api/v1/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"agent@yourcompany.com\"}'\n```\n\n**Response:**\n```json\n{\n  \"success\": true,\n  \"message\": \"You're on the waitlist. We'll notify you when we launch.\"\n}\n```\n\n**Rate limit:** 30 requests/minute per IP.\n\n---\n\n### 2. List packages (authenticated)\n\n```bash\ncurl -s https://mailbox.bot/api/v1/packages \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n```\n\n**Response:**\n```json\n{\n  \"packages\": [\n    {\n      \"id\": \"pkg_abc123\",\n      \"mailbox_id\": \"MB-7F3A\",\n      \"tracking_number\": \"794644790132\",\n      \"carrier\": \"fedex\",\n      \"status\": \"received\",\n      \"weight_oz\": 12.4,\n      \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n      \"received_at\": \"2026-02-09T14:32:00Z\",\n      \"photos_count\": 3\n    }\n  ],\n  \"pagination\": {\n    \"total\": 1,\n    \"limit\": 20,\n    \"offset\": 0,\n    \"has_more\": false\n  }\n}\n```\n\n---\n\n### 3. Get package detail (authenticated)\n\n```bash\ncurl -s https://mailbox.bot/api/v1/packages/pkg_abc123 \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n```\n\n**Response includes:**\n- Full package metadata (carrier, tracking, weight, dimensions)\n- Array of high-res photo URLs\n- Extracted label data (sender, tracking, carrier)\n- Content scan results (if requested)\n- Forwarding history if applicable\n\n---\n\n### 4. Request forwarding (authenticated)\n\n```bash\ncurl -X POST https://mailbox.bot/api/v1/packages/pkg_abc123/forward \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"address\": {\n      \"name\": \"John Doe\",\n      \"street1\": \"456 Destination Ave\",\n      \"city\": \"Austin\",\n      \"state\": \"TX\",\n      \"zip\": \"78701\"\n    },\n    \"carrier\": \"fedex\",\n    \"service_level\": \"ground\"\n  }'\n```\n\n## Webhook payload\n\nWhen a package arrives, we POST structured data to your agent's webhook URL:\n\n```json\n{\n  \"event\": \"package.received\",\n  \"ref\": \"MB-7F3A\",\n  \"carrier\": \"fedex\",\n  \"tracking\": \"794644790132\",\n  \"weight_oz\": 12.4,\n  \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n  \"photos\": [\"https://cdn.mailbox.bot/...\"],\n  \"received_at\": \"2026-02-09T14:32:00Z\"\n}\n```\n\n## Pricing\n\n| Plan | Price | What you get |\n|------|-------|-------------|\n| **Endpoint Only** | Free | Logistics endpoint, return routing, webhook notifications, REST API, agent endpoint |\n| **Receiver** | $10/mo | Endpoint + private carrier receiving. 5 packages/mo, photo docs, webhook on arrival, 14-day bailee storage. Extra packages $5 each |\n| **Swarm** | $25/mo | 5 physical endpoints, 25 packages/mo, content scanning, 30-day storage, forwarding, consolidation, dedicated support |\n| **Enterprise** | Custom | Unlimited endpoints, unlimited packages, custom processing rules, SLA, reserved facility space, 24/7 support |\n\nEarly access for waitlist members.\n\n## Links\n\n- Website: https://mailbox.bot\n- Dashboard: https://mailbox.bot/dashboard\n- API Docs: https://mailbox.bot/api-docs\n- Implementation: https://mailbox.bot/implementation\n- Support: support@mailbox.bot\n\n---\n\n## For OpenClaw Agent Developers\n\nThis skill enables your agent to:\n- Provision a physical shipping address at our warehouse\n- Receive packages from all major private carriers\n- Access high-res photos and structured metadata on arrival\n- Get instant webhook notifications with JSON payload\n- Request forwarding, content scanning, or returns via API\n- Discover and communicate via MCP, A2A, OpenClaw, REST protocols\n\nThe mailbox.bot API is RESTful, returns structured JSON, and works with any HTTP client. No SDK required.\n\nFile v2.0.1:README.md\n\n# mailbox.bot OpenClaw Skill\n\nGet a shipping address for your AI agent. Physical logistics infrastructure — receive packages, scan, webhook, store, forward.\n\n## Quick Start: Publishing to ClawHub\n\n### 1. Install ClawHub CLI\n\n```bash\nnpm install -g clawhub\n```\n\n### 2. Authenticate\n\n```bash\nclawhub login\n```\n\nThis opens GitHub OAuth. Your account must be **at least 1 week old** to publish.\n\n### 3. Publish\n\n```bash\nclawhub publish . \\\n  --slug mailbox-bot \\\n  --name \"mailbox.bot\" \\\n  --version 2.0.0 \\\n  --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.\"\n```\n\n### 4. Verify\n\n```bash\nclawhub info mailbox-bot\n```\n\n## Installation (for OpenClaw users)\n\n```bash\nclawhub install mailbox-bot\n```\n\nOr paste the skill GitHub URL directly into your OpenClaw chat.\n\n## What This Skill Does\n\nYour 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.\n\n**Key capabilities:**\n- Receive packages from all major private carriers\n- Instant webhook notifications with structured JSON\n- High-res photos, weight, dimensions, carrier info\n- Package forwarding and consolidation\n- Content scanning (open + photograph contents)\n- Return routing via reference code\n- Agent protocol support: MCP, A2A, OpenClaw, REST\n\n**Private carriers only (v1.0)** — No USPS mail. This is a package receiving facility, not a mail service.\n\n## Pricing\n\n| Plan | Price | Includes |\n|------|-------|---------|\n| Endpoint Only | Free | Logistics endpoint, webhooks, API access |\n| Receiver | $10/mo | 5 packages/mo, photos, 14-day storage |\n| Swarm | $25/mo | 5 endpoints, 25 packages/mo, scanning, forwarding |\n| Enterprise | Custom | Unlimited everything, SLA, reserved space |\n\n## Links\n\n- Website: https://mailbox.bot\n- Dashboard: https://mailbox.bot/dashboard\n- API Docs: https://mailbox.bot/api-docs\n- Implementation: https://mailbox.bot/implementation\n\n---\n\nQuestions? support@mailbox.bot\n\nFile v2.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn78haq37zygezbw3jg4fgc7n580x3h6\",\n  \"slug\": \"mailbox-bot\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1770912167138\n}\n\nArchive v2.0.0: 3 files, 4866 bytes\n\nFiles: README.md (2362b), SKILL.md (8381b), _meta.json (130b)\n\nFile v2.0.0:SKILL.md\n\n---\nname: mailbox-bot\ndescription: 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.\ntags: [logistics, packages, shipping, fulfillment, warehouse, api, webhook, agents, mcp, a2a]\nversion: 2.0.0\nauthor: mailbox.bot\nrepository: https://github.com/arbengine/mailbox-bot-skill\n---\n\n# mailbox.bot\n\n**Get a shipping address for your AI agent.**\n\nSpin 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.\n\n## Agent protocol support\n\n- **MCP** — Model Context Protocol\n- **A2A** — Agent-to-Agent discovery\n- **OpenClaw** — Agent discovery via `/.well-known/agent.json`\n- **REST** — Standard RESTful API\n\n## What your agent gets\n\nA micro fulfillment node your agent controls via API.\n\n**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.\n\n**Every package scanned & photographed** — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.\n\n**Instant webhook notifications** — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.\n\n**Returns go back automatically** — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention.\n\n## How it works\n\n1. **Verify & get your reference code** — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.\n2. **Ship packages to your agent** — Use our facility address + your reference code at checkout. All major private carriers.\n3. **We receive & document** — Every package scanned, weighed, photographed. Structured data the moment it arrives.\n4. **Your agent decides what's next** — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return.\n\n## Use cases\n\n- **Hardware procurement** — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment\n- **Autonomous logistics** — Operations agents that reorder when stock runs low and route incoming shipments automatically\n- **Edge infrastructure** — Servers, sensors, networking gear, field devices — received, documented, and staged\n- **Document intake** — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data\n- **Return handling** — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent\n- **Package forwarding** — Agents that receive packages at the facility and autonomously request forwarding to end destinations\n\n## Private carriers only (v1.0)\n\nWe 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.\n\n## Current status: v1.0 — Live\n\n**Available now:**\n- Waitlist signup via `/api/v1/waitlist` (no auth required)\n- Full onboarding: KYC, plan selection, payment, agent creation\n- Operator Dashboard for human oversight\n- REST API with package tracking, photos, forwarding\n- Webhook notifications on package arrival\n- Agent protocol support (MCP, A2A, OpenClaw, REST)\n\n## When to use this skill\n\n**Trigger this skill when user says:**\n- \"I need a shipping address for my agent\"\n- \"Can my agent receive packages?\"\n- \"How do I receive packages through an API?\"\n- \"My agent needs to order physical hardware\"\n- \"Can my agent handle returns and RMAs?\"\n- \"I need a fulfillment node for my agent\"\n- \"How do I get webhook notifications for package arrivals?\"\n- \"Can my agent forward packages?\"\n\n**What to do:**\n1. **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.\n2. **Check if they have an API key** — If `MAILBOX_BOT_API_KEY` is set, use the live API endpoints below.\n3. **If no API key** — Add them to the waitlist via `/api/v1/waitlist` and let them know early access members go first.\n\n## Configuration\n\n**Optional** (for members with API access):\n```bash\nexport MAILBOX_BOT_API_KEY=\"your_api_key_here\"\n```\n\nGet your API key at https://mailbox.bot/dashboard/api-keys (after onboarding).\n\n## API Endpoints\n\n### 1. Join waitlist (no auth required)\n\n```bash\ncurl -X POST https://mailbox.bot/api/v1/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"agent@yourcompany.com\"}'\n```\n\n**Response:**\n```json\n{\n  \"success\": true,\n  \"message\": \"You're on the waitlist. We'll notify you when we launch.\"\n}\n```\n\n**Rate limit:** 30 requests/minute per IP.\n\n---\n\n### 2. List packages (authenticated)\n\n```bash\ncurl -s https://mailbox.bot/api/v1/packages \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n```\n\n**Response:**\n```json\n{\n  \"packages\": [\n    {\n      \"id\": \"pkg_abc123\",\n      \"mailbox_id\": \"MB-7F3A\",\n      \"tracking_number\": \"794644790132\",\n      \"carrier\": \"fedex\",\n      \"status\": \"received\",\n      \"weight_oz\": 12.4,\n      \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n      \"received_at\": \"2026-02-09T14:32:00Z\",\n      \"photos_count\": 3\n    }\n  ],\n  \"pagination\": {\n    \"total\": 1,\n    \"limit\": 20,\n    \"offset\": 0,\n    \"has_more\": false\n  }\n}\n```\n\n---\n\n### 3. Get package detail (authenticated)\n\n```bash\ncurl -s https://mailbox.bot/api/v1/packages/pkg_abc123 \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n```\n\n**Response includes:**\n- Full package metadata (carrier, tracking, weight, dimensions)\n- Array of high-res photo URLs\n- Extracted label data (sender, tracking, carrier)\n- Content scan results (if requested)\n- Forwarding history if applicable\n\n---\n\n### 4. Request forwarding (authenticated)\n\n```bash\ncurl -X POST https://mailbox.bot/api/v1/packages/pkg_abc123/forward \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"address\": {\n      \"name\": \"John Doe\",\n      \"street1\": \"456 Destination Ave\",\n      \"city\": \"Austin\",\n      \"state\": \"TX\",\n      \"zip\": \"78701\"\n    },\n    \"carrier\": \"fedex\",\n    \"service_level\": \"ground\"\n  }'\n```\n\n## Webhook payload\n\nWhen a package arrives, we POST structured data to your agent's webhook URL:\n\n```json\n{\n  \"event\": \"package.received\",\n  \"ref\": \"MB-7F3A\",\n  \"carrier\": \"fedex\",\n  \"tracking\": \"794644790132\",\n  \"weight_oz\": 12.4,\n  \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n  \"photos\": [\"https://cdn.mailbox.bot/...\"],\n  \"received_at\": \"2026-02-09T14:32:00Z\"\n}\n```\n\n## Pricing\n\n| Plan | Price | What you get |\n|------|-------|-------------|\n| **Endpoint Only** | Free | Logistics endpoint, return routing, webhook notifications, REST API, agent endpoint |\n| **Receiver** | $10/mo | Endpoint + private carrier receiving. 5 packages/mo, photo docs, webhook on arrival, 14-day bailee storage. Extra packages $5 each |\n| **Swarm** | $25/mo | 5 physical endpoints, 25 packages/mo, content scanning, 30-day storage, forwarding, consolidation, dedicated support |\n| **Enterprise** | Custom | Unlimited endpoints, unlimited packages, custom processing rules, SLA, reserved facility space, 24/7 support |\n\nEarly access for waitlist members.\n\n## Links\n\n- Website: https://mailbox.bot\n- Dashboard: https://mailbox.bot/dashboard\n- API Docs: https://mailbox.bot/api-docs\n- Implementation: https://mailbox.bot/implementation\n- Support: support@mailbox.bot\n\n---\n\n## For OpenClaw Agent Developers\n\nThis skill enables your agent to:\n- Provision a physical shipping address at our warehouse\n- Receive packages from all major private carriers\n- Access high-res photos and structured metadata on arrival\n- Get instant webhook notifications with JSON payload\n- Request forwarding, content scanning, or returns via API\n- Discover and communicate via MCP, A2A, OpenClaw, REST protocols\n\nThe mailbox.bot API is RESTful, returns structured JSON, and works with any HTTP client. No SDK required.\n\nFile v2.0.0:README.md\n\n# mailbox.bot OpenClaw Skill\n\nGet a shipping address for your AI agent. Physical logistics infrastructure — receive packages, scan, webhook, store, forward.\n\n## Quick Start: Publishing to ClawHub\n\n### 1. Install ClawHub CLI\n\n```bash\nnpm install -g clawhub\n```\n\n### 2. Authenticate\n\n```bash\nclawhub login\n```\n\nThis opens GitHub OAuth. Your account must be **at least 1 week old** to publish.\n\n### 3. Publish\n\n```bash\nclawhub publish . \\\n  --slug mailbox-bot \\\n  --name \"mailbox.bot\" \\\n  --version 2.0.0 \\\n  --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.\"\n```\n\n### 4. Verify\n\n```bash\nclawhub info mailbox-bot\n```\n\n## Installation (for OpenClaw users)\n\n```bash\nclawhub install mailbox-bot\n```\n\nOr paste the skill GitHub URL directly into your OpenClaw chat.\n\n## What This Skill Does\n\nYour 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.\n\n**Key capabilities:**\n- Receive packages from all major private carriers\n- Instant webhook notifications with structured JSON\n- High-res photos, weight, dimensions, carrier info\n- Package forwarding and consolidation\n- Content scanning (open + photograph contents)\n- Return routing via reference code\n- Agent protocol support: MCP, A2A, OpenClaw, REST\n\n**Private carriers only (v1.0)** — No USPS mail. This is a package receiving facility, not a mail service.\n\n## Pricing\n\n| Plan | Price | Includes |\n|------|-------|---------|\n| Endpoint Only | Free | Logistics endpoint, webhooks, API access |\n| Receiver | $10/mo | 5 packages/mo, photos, 14-day storage |\n| Swarm | $25/mo | 5 endpoints, 25 packages/mo, scanning, forwarding |\n| Enterprise | Custom | Unlimited everything, SLA, reserved space |\n\n## Links\n\n- Website: https://mailbox.bot\n- Dashboard: https://mailbox.bot/dashboard\n- API Docs: https://mailbox.bot/api-docs\n- Implementation: https://mailbox.bot/implementation\n\n---\n\nQuestions? support@mailbox.bot\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn78haq37zygezbw3jg4fgc7n580x3h6\",\n  \"slug\": \"mailbox-bot\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1770909857746\n}","readmeExcerpt":"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 notif","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export MAILBOX_BOT_API_KEY=\"your_api_key_here\""},{"language":"bash","snippet":"curl -X POST https://mailbox.bot/api/v1/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"agent@yourcompany.com\"}'"},{"language":"bash","snippet":"curl -X POST https://mailbox.bot/api/v1/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"agent@yourcompany.com\"}'"},{"language":"json","snippet":"{\n  \"success\": true,\n  \"message\": \"You're on the waitlist. We'll notify you when we launch.\"\n}"},{"language":"bash","snippet":"curl -s https://mailbox.bot/api/v1/packages \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\""},{"language":"bash","snippet":"curl -s https://mailbox.bot/api/v1/packages \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: mailbox-bot\ndescription: 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.\ntags: [logistics, packages, shipping, fulfillment, warehouse, api, webhook, agents, mcp, a2a]\nversion: 2.0.1\nauthor: mailbox.bot\nrepository: https://github.com/arbengine/mailbox-bot-skill\n---\n\n# mailbox.bot\n\n**Get a shipping address for your AI agent.**\n\nSpin 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.\n\n## Agent protocol support\n\n- **MCP** — Model Context Protocol\n- **A2A** — Agent-to-Agent discovery\n- **OpenClaw** — Agent discovery via `/.well-known/agent.json`\n- **REST** — Standard RESTful API\n\n## What your agent gets\n\nA micro fulfillment node your agent controls via API.\n\n**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.\n\n**Every package scanned & photographed** — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.\n\n**Instant webhook notifications** — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.\n\n**Returns go back automatically** — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention.\n\n## How it works\n\n1. **Verify & get your reference code** — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.\n2. **Ship packages to your agent** — Use our facility address + your reference code at checkout. All major private carriers.\n3. **We receive & document** — Every package scanned, weighed, photographed. Structured data the moment it arrives.\n4. **Your agent decides what's next** — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return.\n\n## Use cases\n\n- **Hardware procurement** — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment\n- **Autonomous logistics** — Operations agents that reorder when stock runs low and route incoming shipments automatically\n- **Edge infrastructure** — Servers, sensors, networking gear, field devices — received, documented, and staged\n- **Document intake** — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data\n- **Return handling** — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent\n- **Package forwarding** — Agents that receive packages at the facility and autonomously request forwarding to end destinations\n\n## Private carriers only (v1.0)\n\nWe do NOT accept USPS mail. This is a package receiving facility, not "},{"path":"README.md","content":"# mailbox.bot OpenClaw Skill\n\nGet a shipping address for your AI agent. Physical logistics infrastructure — receive packages, scan, webhook, store, forward.\n\n## Quick Start: Publishing to ClawHub\n\n### 1. Install ClawHub CLI\n\n```bash\nnpm install -g clawhub\n```\n\n### 2. Authenticate\n\n```bash\nclawhub login\n```\n\nThis opens GitHub OAuth. Your account must be **at least 1 week old** to publish.\n\n### 3. Publish\n\n```bash\nclawhub publish . \\\n  --slug mailbox-bot \\\n  --name \"mailbox.bot\" \\\n  --version 2.0.0 \\\n  --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.\"\n```\n\n### 4. Verify\n\n```bash\nclawhub info mailbox-bot\n```\n\n## Installation (for OpenClaw users)\n\n```bash\nclawhub install mailbox-bot\n```\n\nOr paste the skill GitHub URL directly into your OpenClaw chat.\n\n## What This Skill Does\n\nYour 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.\n\n**Key capabilities:**\n- Receive packages from all major private carriers\n- Instant webhook notifications with structured JSON\n- High-res photos, weight, dimensions, carrier info\n- Package forwarding and consolidation\n- Content scanning (open + photograph contents)\n- Return routing via reference code\n- Agent protocol support: MCP, A2A, OpenClaw, REST\n\n**Private carriers only (v1.0)** — No USPS mail. This is a package receiving facility, not a mail service.\n\n## Pricing\n\n| Plan | Price | Includes |\n|------|-------|---------|\n| Endpoint Only | Free | Logistics endpoint, webhooks, API access |\n| Receiver | $10/mo | 5 packages/mo, photos, 14-day storage |\n| Swarm | $25/mo | 5 endpoints, 25 packages/mo, scanning, forwarding |\n| Enterprise | Custom | Unlimited everything, SLA, reserved space |\n\n## Links\n\n- Website: https://mailbox.bot\n- Dashboard: https://mailbox.bot/dashboard\n- API Docs: https://mailbox.bot/api-docs\n- Implementation: https://mailbox.bot/implementation\n\n---\n\nQuestions? support@mailbox.bot"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn78haq37zygezbw3jg4fgc7n580x3h6\",\n  \"slug\": \"mailbox-bot\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1770912167138\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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. 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 notif","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1218,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:21:15.922Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}