# Courier MCP for AI Agents MCP

> Courier connects your AI agent directly to multi-channel notification infrastructure. Use this MCP to send messages across email, SMS, push alerts, and chat apps, while also monitoring their real-time delivery status. It gives you full visibility into whether a message was sent, delivered, opened, or clicked by the recipient.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** notifications, multi-channel, api-integration, message-delivery, real-time-sync, workflow-automation

## Description

Managing communications across different channels used to mean jumping between multiple dashboards—checking email sends here, looking up phone numbers there, and manually tracking status updates in a third system. This MCP changes that. Instead of dealing with siloed data, your AI agent handles complex notification workflows using natural conversation.

It lets you trigger messages through any channel (email, SMS, push) and, critically, gives you real-time visibility into the message life cycle. You can monitor who received a message and when they opened it or clicked a link. Need to check user details? The MCP provides tools to list user profiles and even audit previous communication history. If your current system makes tracking deliveries feel like a job for an intern, Vinkius hosts this Courier integration so your agent handles it all automatically. You just tell the AI what needs to be sent, and it manages the rest.

## Tools

### get_message_history
Retrieves detailed event logs showing the full status (sent, delivered, opened) of a specific message ID.

### get_message_details
Gets deep details about a single message, including provider responses and rendering metadata.

### get_user_profile
Pulls basic contact information like email or phone number for a specific user ID.

### list_audiences
Lists the names and IDs of saved groups used to target notifications, helping segment your recipients.

### list_brands
Retrieves a list of custom brands configured in Courier for white-labeling purposes.

### list_subscription_lists
Lists the IDs and names of subscriber groups, useful for managing large lists of potential recipients.

### list_messages
Lists all messages sent by ID, providing current statuses like DELIVERED or CLICKED along with timestamps.

### list_templates
Retrieves a list of available notification templates and the channels they support for sending.

### list_users
Lists all user accounts registered within your Courier workspace environment.

### send_notification
Sends a new notification to the specified recipient, routing it through the best available channel and template.

## Prompt Examples

**Prompt:** 
```
What was the delivery status of the alert sent last Tuesday to user 456?
```

**Response:** 
```
**Message Status Report**

The message (ID: XYZ-987) was successfully **DELIVERED** on June 10th, 2024. It shows a history of:
*   `SENT`: 2024-06-10T09:00:00Z
*   `DELIVERED`: 2024-06-10T09:05:12Z (via Email)
*   `OPENED`: 2024-06-10T09:07:30Z
*   `CLICKED`: Link to pricing page @ 2024-06-10T09:07:30Z

The last action was a link click. Do you want me to check the full event log?
```

**Prompt:** 
```
Send a welcome message with template ID 'welcome_v2' to user john@testcorp.com.
```

**Response:** 
```
**Action Taken:** 

A 'Welcome' notification has been queued for john@testcorp.com.

*   **Template Used:** Welcome Series v2
*   **Target Channel:** Email and Push Alert (Best available)
*   **Status Check:** We are monitoring the delivery status in real time. You will receive an alert when we confirm 'Delivered' or if any error occurs.
```

**Prompt:** 
```
List all notification templates and tell me which ones support SMS.
```

**Response:** 
```
**Available Notification Templates**

| Template Name | ID | Supported Channels |
| :--- | :--- | :--- |
| Password Reset | TPL-100 | Email, Push |
| New Login Alert | TPL-205 | Email, SMS |
| Monthly Digest | TPL-330 | Email only |

SMS support is currently limited to the 'New Login Alert' and other system alerts. The 'Monthly Digest' must be sent via email.
```

## Capabilities

### Send notifications via various channels
Sends messages using templates across email, SMS, push alerts, and chat apps.

### Check message delivery history
Retrieves detailed logs showing if a sent message was delivered, opened by the user, or clicked on.

### Get specific user contact details
Pulls basic contact information like email or phone number for a specific user ID.

### Segment users into target groups
Retrieves specific saved audience groups and subscription lists for targeted marketing efforts.

## Use Cases

### Tracking a failed onboarding sequence
The marketing team needs to know if the welcome email and subsequent SMS reminder actually went out. Asking the agent to list messages allows them to see which steps succeeded (using list_messages) and where the process stalled.

### Investigating a user complaint
A customer claims they never received a critical alert. The support specialist asks the agent to get message details for that specific ID, instantly showing whether the platform recorded a 'DELIVERED' status or if it failed entirely.

### Segmenting users for a promotion
The sales team wants to run a special campaign only on premium subscribers. The agent uses list_subscription_lists and then combines that data with get_user_profile to build the precise target group.

### Validating system alerts post-update
A developer needs to confirm that a new critical alert (like an account lock) is properly sent. They use send_notification, and then follow up with list_messages to check the immediate delivery status.

## Benefits

- Verify critical system notifications instantly. Instead of guessing if a password reset email worked, use the Send API to trigger messages and monitor their success.
- Pinpoint why communications fail. If users are complaining about emails not arriving, audit message history or get message details to find out if the issue was delivery failure or simply not opened.
- Stop manual list management. You can use list_audiences and list_subscription_lists to target campaigns precisely without manually sorting through spreadsheets.
- Better support interactions. With get_user_profile, your agent pulls all necessary contact details and channel preferences in one step, making customer service faster.
- Build reliable workflows. By listing available notification templates using list_templates, you ensure that every message sent adheres to proper branding and messaging standards.

## How It Works

The bottom line is: You talk to your agent in plain English, and it translates that into specific API calls to manage communications for you.

1. Connect the Courier MCP to your AI client using an API token. This authorizes your agent to access message logs, user profiles, and sending capabilities.
2. Your agent identifies the necessary data points—like the target recipient's profile or a specific audience list ID—and calls the relevant tools within this MCP.
3. The MCP executes the request against the Courier system, returning structured data that your AI client uses to formulate a final answer for you.

## Frequently Asked Questions

**How can I check if a message actually got delivered using the Courier MCP for AI Agents?**
You don't have to guess. The agent checks the full history of that specific message, confirming its delivery status (delivered, opened, etc.). This is critical for knowing your communication actually made it to the user.

**Do I need technical skills to use the Courier MCP for AI Agents?**
No. You just talk to your agent in natural language. Tell it what you want—like 'Check the status of my last campaign'—and the MCP handles all the complex API calls behind the scenes.

**What if I need to send a notification through multiple channels?**
The MCP makes that easy. You can ask your agent to send one message, and it routes it automatically across email, SMS, or push notifications based on what's best for the recipient.

**Can I use Courier MCP for AI Agents to find out user details?**
Yes. You can ask your agent to get a user profile by ID. It pulls contact info, like email and phone number, plus their specific channel preferences all in one place.

**How does Courier MCP for AI Agents help with marketing campaigns?**
It lets you run highly segmented campaigns. You can list saved audiences or subscription lists to ensure your messages only go out to the right people, saving time and avoiding mistakes.