# MailboxPower MCP

> MailboxPower connects physical direct mail marketing to your AI agent. You send personalized gifts, greeting cards, and promotional items directly from conversations, automating tasks like contact list management, group creation, and delivery tracking.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** direct-mail, personalized-gifts, customer-retention, campaign-management, gifting

## Description

You connect MailboxPower straight into your AI agent. You handle physical direct mail marketing—like sending thank-you cards or promotional gifts—right from your chat interface. This server lets you run entire campaigns without ever leaving your conversation.

**Managing Your Contacts:**
When you need to know who you're talking to, you can use `list_contacts` to pull a full list of every contact the system manages. Got details on one person? You invoke `get_contact` to retrieve all known info, like their address and name. If you find someone new, just run `create_contact` to build a brand-new record with all the necessary details.

**Organizing Mailing Lists:**
Targeting is key when you're sending physical items. You can use `create_group` to define and set up an entirely new mailing group for your campaign. Once that group exists, you add existing contacts using `add_contact_to_group`, putting them right where they need to be for the send. To check what groups you've built or which people are in 'em, run `list_groups`.

**Executing Campaigns:**
Sending physical items is simple. You call `send_shipment` and tell it exactly what to mail—a card, a gift, or some merch—and where to send it. The system handles the rest of the mailing process for that specific address.

**Building Automated Workflows:**
MailboxPower doesn't just send stuff; it automates your outreach. You can use `add_contact_to_automation` to trigger a complex workflow sequence for a specific person as soon as they meet certain criteria. To see what kind of automated sequences you've got running, or what triggers are active, you run `list_automations`. This helps you track the status and flow of your ongoing mail campaigns across every recipient.

## Tools

### add_contact_to_automation
Starts an automated workflow sequence for a specific contact.

### add_contact_to_group
Adds an existing contact to one of your defined mailing groups.

### create_contact
Creates a brand-new contact record in the system with necessary details.

### create_group
Defines and creates a new, dedicated group for targeting multiple contacts.

### get_contact
Retrieves all known details (address, name) for a single contact record.

### list_automations
Shows you every automation sequence currently active in your account.

### list_contacts
Pulls a list of every existing contact managed within the system.

### list_groups
Lists all contact groups that have been created for campaign targeting.

### send_shipment
Sends a physical card, gift, or promotional item to a specified recipient address.

## Prompt Examples

**Prompt:** 
```
Show the product catalog and send a thank-you card to a client.
```

**Response:** 
```
Catalog: 45 products. Cards (12): Thank You ($3.50), Birthday ($4.00), Holiday ($4.50). Gifts: Coffee Mug ($15), Gift Box ($35), Premium Basket ($75). Promo: Branded Pen ($5), Notebook ($12). Card sent! ✅ Thank You card to Sarah Chen, 123 Main St, NY 10001. Message: 'Thank you for your partnership!' Est. delivery: May 1-3.
```

**Prompt:** 
```
Create a gift campaign for the top 10 clients.
```

**Response:** 
```
Campaign created! 'Q2 Client Appreciation'. Recipients: 10 top clients. Product: Premium Gift Box ($35 each). Total: $350 + $45 shipping. Personal message: 'Thank you for being an amazing partner!' Schedule: Ships May 1. Estimated delivery: May 3-6. Status: Pending approval. ⬜ Approve to send.
```

**Prompt:** 
```
Show delivery status for all active campaigns and contact lists.
```

**Response:** 
```
Active campaigns: 2. 'Spring Appreciation' (25 gifts, 22 delivered ✅, 3 in transit). 'New Client Welcome' (8 cards, 8 delivered ✅). Delivery rate: 100% (no returns). Avg delivery: 3.1 days. Contact lists: 3. 'Top Clients' (25), 'New Clients Q2' (14), 'Partners' (8). Total contacts: 47.
```

## Capabilities

### Manage Contact Records
Create new contact entries, pull existing details, and list all contacts in your CRM.

### Organize Mailing Lists
Build targeted groups from individual contacts or entire lists for specific campaigns.

### Send Physical Items
Execute the mailing of personalized cards, gifts, and promotional merchandise to specified addresses.

### Automate Contact Workflow
Trigger automations that add a contact to an automation sequence or group membership when needed.

### Track Campaign Status
List and monitor ongoing mailing campaigns and their delivery status across all recipients.

## Use Cases

### The 'Thank You' follow-up after a pitch
A sales rep needs to send a personalized thank-you card and small gift box immediately. They tell their agent: 'Send a Thank You card and a coffee mug gift to Alex Jones.' The agent uses `send_shipment`, pulling the address from the contact record, ensuring the physical item goes out right away.

### Launching an annual client appreciation campaign
Marketing needs to target 50 top clients. Instead of manually listing them, they run `list_contacts` and then use the agent to build a group: 'Add all contacts from the spreadsheet into the Platinum Group.' They then schedule the bulk mailing via `send_shipment`.

### Handling new leads that need nurturing
A lead comes in and needs immediate follow-up. The agent first runs `create_contact` with the new details, then uses `add_contact_to_automation` to put them into a 90-day nurture flow so gifts start sending automatically.

### Checking delivery status for large campaigns
The team runs a multi-state campaign. To check the progress, they ask the agent to 'Show me the active shipments.' The system uses internal tracking data and provides an immediate report on which items are delivered or in transit.

## Benefits

- **Send items instantly.** Use `send_shipment` to send a gift box or thank-you card. You just describe the item and recipient, and it handles the fulfillment details.
- **Stay organized with groups.** Instead of mailing one by one, use `create_group` and `list_groups` to define entire segments (e.g., 'Q2 Platinum Clients') for bulk sending.
- **Verify addresses fast.** Before launching a campaign, run `get_contact` to check if the recipient's address is current. This prevents failed deliveries.
- **Build repeatable workflows.** Use `add_contact_to_automation` when you want an action (like a 3-month follow-up gift) to happen automatically after a key milestone.
- **Know your audience.** Run `list_contacts` or `list_groups` any time you need a master list of who's in the system before building a campaign.

## How It Works

The bottom line is you talk naturally to your AI client, and it handles the entire physical mailing process using MailboxPower's tools.

1. First, subscribe to the server and enter your MailboxPower API Key into your AI client.
2. Next, tell your agent exactly what you want. For example: 'Send a gift box to John Doe' or 'Create a group for all Q2 clients.'
3. The agent uses the underlying tools (like `send_shipment` or `create_group`) to run the action and returns confirmation details, like delivery estimates and costs.

## Frequently Asked Questions

**How do I start a gift campaign using send_shipment?**
You specify the product and the recipient's details in one prompt. The agent uses `send_shipment` to execute the order, providing cost estimates and estimated delivery dates immediately.

**Can I group contacts before sending mail with MailboxPower?**
Absolutely. Use `list_contacts` first to see everyone, then use `create_group` or `add_contact_to_group` to build your target list. You run the shipment against that group.

**What if I need to update an address before sending a card? Should I use get_contact?**
Yes, always use `get_contact`. This pulls the most current, verified data for that person. It ensures `send_shipment` doesn't fail because of outdated information.

**Is there a way to automate follow-up gifts?**
Yes. After sending an item, use `add_contact_to_automation`. This sets up the next touchpoint—like a gift 90 days later—so you don't have to remember it.

**Does MailboxPower handle product catalog browsing?**
Yes, you can browse the available inventory (products, cards, promo items) directly through the conversation. This lets you figure out what gifts fit a budget before running `send_shipment`.

**What credentials do I need to use the `list_groups` tool?**
You must provide a valid MailboxPower API key in your server configuration. The agent uses this key to authenticate your connection and confirm you have the necessary permissions to view group data.

**When using the `send_shipment` tool, how does it handle contacts with incomplete or invalid addresses?**
The tool validates recipient details before attempting shipment. If an address fails validation (e.g., missing zip code), it flags the record and skips sending that specific item, returning a detailed error log.

**Is there a limit when running the `list_contacts` tool on a large dataset of records?**
The tool supports pagination. When querying more than 100 contacts, your agent must iterate through subsequent pages using the provided cursor token to pull all available data.

**Can I send personalized gifts and cards?**
Yes. Browse the product catalog, personalize gifts and cards with custom messages, and send to any US address with delivery tracking.

**Can I run direct mail campaigns?**
Yes. Create campaigns with recipient lists, schedule mailings, and track delivery status for each piece.

**What API does MailboxPower use?**
Bearer authentication against `api.mailboxpower.com/v1`.