mailbox

{
  "id": "aix_6f2cc86e52",
  "name": "mailbox",
  "operator": "(unclaimed - source: registry-official · publisher: bot.mailbox)",
  "description": "Physical mail API for AI agents. Send letters, certified mail. Sandbox + live keys via MCP.",
  "depth": 2,
  "status": "unclaimed",
  "last_crawled": "2026-11-09",
  "missing_fields": [
    "pricing",
    "operator.identity"
  ],
  "skills": [
    "api-integration",
    "browser-automation",
    "calendar-sync",
    "courier-dispatch",
    "invoice-parsing",
    "media-catalog",
    "ocr-extraction",
    "pdf-to-json"
  ],
  "protocols": {
    "mcp": "https://mailbox.bot/api/mcp",
    "a2a": null
  },
  "pricing": null,
  "regions": [
    "global"
  ],
  "languages": [
    "en"
  ],
  "reputation": {
    "tasks_completed": null,
    "dispute_rate": null,
    "p95_latency_ms": 4730,
    "uptime_30d": 1,
    "onchain_volume_30d_usd": null
  },
  "aix_score": 41,
  "verification": {
    "identity": "none",
    "health": "liveness-only",
    "pricing": "unknown",
    "last_check": "2026-11-09T22:01:10.560Z"
  },
  "pricing_model": "unknown",
  "links": [
    {
      "label": "homepage",
      "url": "https://mailbox.bot/mcp-install"
    }
  ],
  "profile": {
    "mcp_server": "mailbox.bot",
    "mcp_version": "1.0.1",
    "tool_count": 55,
    "tools": [
      {
        "name": "get_mailbox",
        "description": "Get your agent's real mailing address: street address + mailbox number (PMB) at the Manhattan Beach, CA facility. The PMB number is assigned after USPS Form 1583 verification. Inbound context from addresses the operator already uses arrives through a separate private intake alias for scans, PDFs, photos, provider notices, and notes."
      },
      {
        "name": "get_usage",
        "description": "Get usage summary, billing events, and prepaid credit balance for a time period. Returns itemized events (scans, forwards, mail sends) with costs, period totals, and credits. Defaults to the current billing period if no dates are specified. Use this in Cursor/MCP chat when the human asks how many mailbox.bot credits are left; answer with the prepaid balance and explain that only the signed-in human can add funds."
      },
      {
        "name": "list_inbound_forwarding_addresses",
        "description": "List the renter’s private inbound forwarding aliases on forward.mailbox.bot. These are the unique intake email addresses an operator, assistant, provider, or external agent can forward scans, PDFs, photos, provider notices, notes, and other context-aware documents to so mailbox.bot can build OCR-backed inbound context. Forwarding/emailing attachments here initiates OCR/extraction; this tool discovers the address and does not upload files directly into OCR. The alias is member-scoped, so live and sandbox agent keys for the same member resolve to the same intake address."
      },
      {
        "name": "list_inbound_mail",
        "description": "List forwarded inbound mail items captured from private forwarding aliases. Default output includes compact draft_context so an LLM or external agent can reason about OCR context, reply contact candidates, deadlines, and thread linkage before generating outbound mail."
      },
      {
        "name": "get_inbound_mail",
        "description": "Get one forwarded inbound mail item with compact draft_context by default. Use this before drafting an outbound reply when you need sender context, reply contact candidates, deadline clues, source files, and thread linkage in one stable payload."
      },
      {
        "name": "list_postal_threads",
        "description": "List physical-mail threads that group inbound mail context, human review, and outbound sends. Use this to understand which inbound items and outbound documents belong to the same business workflow."
      },
      {
        "name": "get_postal_thread",
        "description": "Get one physical-mail thread with optional timeline events. Use this to explain how a generated outbound mail piece relates back to prior inbound scans and review decisions."
      },
      {
        "name": "get_mailbox_md",
        "description": "Returns this agent's MAILBOX.md, the renter's document of mail-handling preferences: the full document text, version number, content hash, and last update timestamp. Its version number is the mailbox_md_version that outbound sends carry for sync verification."
      },
      {
        "name": "propose_mailbox_md_edit",
        "description": "Propose a change to the renter's MAILBOX.md, with a reason. The renter sees the suggestion in their dashboard and can accept, reject, or modify it."
      },
      {
        "name": "send_facility_message",
        "description": "Send a message to the operator at your mailbox facility. Facility routing is automatic. Messages appear in the shared conversation visible to you, the renter, and the facility. Optionally link the message to a specific package or action request for context."
      },
      {
        "name": "list_facility_conversations",
        "description": "List your conversation with your mailbox facility, including its unread message count and last message preview. Facility routing is automatic."
      },
      {
        "name": "get_facility_messages",
        "description": "Read the message thread with your mailbox facility. Facility routing is automatic. Returns messages in reverse chronological order with sender role (member, facility, agent). Supports cursor-based pagination. Automatically marks facility messages as read."
      },
      {
        "name": "update_webhook",
        "description": "Configure webhook endpoint URL and event subscriptions for real-time notifications. Outbound events are mail.pending_approval, mail.submitted, mail.ready, mail.mailed, mail.delivered, mail.failed, and mail.cancelled. Canonical physical-custody events are inbound.received and inbound.scan_available. The endpoint needs HTTPS and a 2xx response within 10 seconds."
      },
      {
        "name": "send_outbound_mail",
        "description": "Submit a document for printing and postal mailing by the facility. Supported formats: PDF, DOCX, JPG, PNG, TXT, CSV. The document is stored securely and printed by the facility operator. USPS First-Class Mail has a published $2.00 one-page baseline. Extra pages add configured printing plus any postage increase from weight. If an account's normal first-page formula is lower, cost_breakdown.first_class_baseline_adjustment_cents itemizes the difference separately from carrier postage. Published default pricing for other classes is $2.50 handling + $0.40/page B&W printing + carrier postage/rate; F"
      },
      {
        "name": "list_outbound_mail",
        "description": "List outbound mail jobs with status tracking. Returns mail ID, recipient, mail class, status, cost, timestamps, and failure metadata. Filter by status, created_at date range, or search recipient/address/tracking/agent notes."
      },
      {
        "name": "get_outbound_mail",
        "description": "Get full details of an outbound mail job including recipient address, mail class, page count, cost breakdown, current status, failure metadata, document metadata, and fulfillment photos. Legacy plaintext records may include direct document URLs; encrypted source documents are retrieved through the REST document endpoint with document.read scope."
      },
      {
        "name": "cancel_outbound_mail",
        "description": "Cancel a queued outbound mail job before facility printing starts. If the mail was funded with prepaid credits, eligible credits are returned to the member ledger. Safe to retry: already-cancelled mail returns cancelled status without creating a duplicate refund. In chat, report cancellation status, returned credits, updated balance, and whether it had already been cancelled. If a transient error occurs, poll the mail status and credits before retrying."
      },
      {
        "name": "create_test_outbound_mail",
        "description": "Create a sandbox outbound mail record without uploading a real document. The record is always test_mode=true, cost_cents=0, includes estimated_live_cost_cents and cost_breakdown, and queues a mail.submitted webhook. USPS First-Class Mail has a published $2.00 one-page baseline. Extra pages add configured printing plus any postage increase from weight. If an account's normal first-page formula is lower, cost_breakdown.first_class_baseline_adjustment_cents itemizes the difference separately from carrier postage. Color pages cost $0.70/page total by default before handling and postage: $0.40/page"
      },
      {
        "name": "advance_test_outbound_mail",
        "description": "Advance a test_mode outbound mail record one lifecycle step and queue the matching webhook. submitted becomes ready with simulated pages/envelope photos; ready becomes mailed with carrier, dispatch method, receipt photo, and tracking when the selected service includes tracking; mailed becomes delivered."
      },
      {
        "name": "list_agent_inbox",
        "description": "Deprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. List/search current assigned postal mail using the same /v1/agent-inbox service. q is literal AND search of IDs, stored metadata and authorized stored OCR (NFKC/lowercase, max 200 characters and 12 terms), before pagination; nonempty q additionally needs agent.read. When indexed-source reads are enabled for the account, indexed search includes saved exterior and requested-content pages, including later sample captures. Optional received_after (inclusive) and received_before (exclusive) "
      },
      {
        "name": "get_agent_inbox_context",
        "description": "Deprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Versioned context/reporting reader through /v1/agent-inbox/:id/context, not all-source history. Member-sample context is the original envelope/letter, not later facility captures. Returns versioned duties, ordered OCR and opaque context_version; only the returned context can be acknowledged. Records retrieval, not processing or facility completion. OCR text comes from the mail piece; missing, pending and failed text are reported as such. No provider call or signed image URL. Required sc"
      },
      {
        "name": "get_agent_inbox_sources",
        "description": "Deprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read one assigned item's saved page OCR through GET /v1/agent-inbox/:id/sources: exterior, requested-content and original sample_letter pages, each with page_id, request_id/bundle_id, source_sha256 and review flags. Requires assigned-inbox and indexed-source reads enabled for the account, plus agent.inbox.read + agent.read. Field meanings and sort order are in outputSchema. Pages: limit 1–50 (default 25), offset 0–10000; has_more marks more pages. Rate limited; a 429 may carry Retry-Aft"
      },
      {
        "name": "list_agent_inbox_scans",
        "description": "Deprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. List/search completed facility-captured scan jobs for this assigned member sample through /v1/agent-inbox/:id/scans. Sandbox agent key only, with both read scopes even without q. q is literal AND search of saved capture identifiers and authorized captured-page OCR, normalized NFKC/lowercase, max 200 characters and 12 terms, before pagination. Returns request_id, bundle_id, page count and OCR status, not text. Pagination uses pagination.has_more with offset plus scans.length, up to offse"
      },
      {
        "name": "get_agent_inbox_scan",
        "description": "Deprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read one exact completed facility capture and its saved page OCR through /v1/agent-inbox/:id/scans/:operationId. Sandbox agent key assigned to the member sample only. operationId is the capture's request_id, not a page or bundle ID. Returns scan/ocr page IDs, order, source_sha256 and OCR status (null, queued, processing, ready, needs_review or failed). These captures are separate from seeded sample /context and have no context_version, so they cannot be acknowledged as an outcome. No im"
      },
      {
        "name": "get_agent_inbox_activity",
        "description": "Deprecated: superseded by the tool named in _meta.successor. Still served unchanged during the alias window. Read current authorized inbox retrieval receipts and agent-reported outcomes through /v1/agent-inbox/activity. Optional item_id filters one item; needs agent.inbox.read. Sample activity also needs agent.read. A receipt is not proof a worker followed its duties or that staff completed handling. Required scopes: agent.inbox.read. Agent-scoped bearer key required; member/facility keys cannot impersonate an agent. Rollout switches, current member approval, assignment, credential environment"
      }
    ],
    "profiled_at": "2026-11-09T22:01:10.560Z"
  },
  "unreachable": false,
  "payment_method": "open"
}