// MCP TOOL REFERENCE

MAILBOX TOOLS

29 tools from the Mailbox MCP Server, categorised by risk level.

// ALL 29 MAILBOX TOOLS

READ 18 tools

Read advance_test_outbound_mail Advance a test_mode outbound mail record one lifecycle step and queue the matching webhook. submitted becom... Read get_facility_messages Read the message thread with a specific facility. Returns messages in reverse chronological order with send... Read get_inbound_mail Get one forwarded inbound mail item with compact draft_context by default. Use this before drafting an outb... Read get_mailbox Get your agent's real mailing address beta endpoint when the account has explicit beta access: street addre... Read get_mailbox_md Get the renter's MAILBOX.md standing instructions for this agent. Returns the full instruction text, versio... Read get_outbound_mail Get full details of an outbound mail job including recipient address, mail class, page count, cost breakdow... Read get_package Get full package details including photos, tracking events, shipping label data (carrier, addresses, weight... Read get_package_photos Get photos for a package with OCR-extracted text and confidence scores. Filter by photo type to get only ex... Read get_postal_thread Get one physical-mail thread with optional timeline events. Use this to explain how a generated outbound ma... Read get_scan_results Get document scan results including raw OCR text, structured data fields (addresses, dates, amounts), and c... Read get_usage Get usage summary and billing events for a time period. Returns itemized events (scans, forwards, mail send... Read list_facility_conversations List your active facility conversations with unread message counts and last message preview. Each conversat... Read list_inbound_forwarding_addresses List the renter’s private inbound forwarding aliases on forward.mailbox.bot. These are the unique intake em... Read list_inbound_mail List forwarded inbound mail items captured from private forwarding aliases. Default output includes compact... Read list_outbound_mail List outbound mail jobs with status tracking. Returns mail ID, recipient, mail class, status, cost, and tim... Read list_packages List inbound mail or packages for approved real mailing address/package beta accounts with optional filters... Read list_postal_threads List physical-mail threads that group inbound mail context, human review, and outbound sends. Use this to u... Read request_scan Request document scanning (OCR + structured data extraction) for a package. The facility will scan the docu...

WRITE 10 tools

Write add_note Add an observation or context note to a package. Notes are visible to the facility operator and the renter.... Write add_tag Add a tag/label to a package for categorization and filtering. Tags are free-form strings. Adding the same ... Write create_rule Create a standing instruction that auto-triggers actions when incoming packages match conditions. Rules run... Write create_test_outbound_mail Create a sandbox outbound mail record without uploading a real document. The record is always test_mode=tru... Write propose_mailbox_md_edit Propose changes to the renter's MAILBOX.md instructions with reasoning. The renter will see your suggestion... Write register_expected Pre-register an expected inbound shipment so it is auto-matched when it arrives at the facility. Optionally... Write send_facility_message Send a message to the facility operator managing your mailbox. Messages appear in the shared conversation v... Write send_outbound_mail Submit a document for printing and postal mailing by the facility. Supported formats: PDF, DOCX, JPG, PNG, ... Write update_action Push notes, structured data, or a clarification response to an existing action request. Use this to add age... Write update_webhook Configure webhook endpoint URL and event subscriptions for real-time notifications. Events include package....

DESTRUCTIVE 1 tools

Destructive request_action Request a physical action on a package at the facility. Actions include forwarding to another address, shre...

// FAQ

How many tools does the Mailbox MCP server have? +

The Mailbox MCP server exposes 29 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Mailbox tools? +

Route the Mailbox server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Mailbox tools fall into? +

Mailbox tools are categorised as Read (18), Write (10), Destructive (1). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.