# Courier MCP for AI Agents AI Agent Connect > Courier MCP lets you send multi-channel notifications across email, SMS, and push channels while tracking delivery status in real-time. Use it to manage templates, audience lists, and user profiles through your AI client. It turns complex notification logic into simple chat commands. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_hncOJsHhxey2h41jZqElueYbnMXqfsh2X92gJEYa/ai-agent-connect - **Tags:** notifications, multi-channel, api-integration, message-delivery, real-time-sync, workflow-automation ## Description This integration lets you manage your entire notification infrastructure through your AI client. Instead of jumping between different dashboards to check if an email landed or if an SMS was delivered, you can just ask your agent for the status. It handles the heavy lifting of routing messages to the right channel, whether that's a push notification, a text, or an email. You can check if a message was opened or if it bounced without ever leaving your chat window. Because Vinkius hosts this, you can plug it into your existing workflow and start managing your communication strategy through natural language. It's about getting the right message to the right person at the right time without the manual overhead of switching tabs or copy-pasting IDs. You can ask your agent to trigger complex notification workflows or hunt down a specific user's preference without digging through settings. It handles the routing logic across different providers automatically. You can audit your message history to see exactly how a campaign performed or troubleshoot why a specific user didn't receive a critical alert. It gives you a bird's eye view of your subscription lists and user data, so you can manage your entire communication strategy without the usual friction of a complex UI. ## Tools ### get_message_history Get the delivery history logs for a specific message. This lets you see every event that happened during the delivery process. ### get_message_details Get details for a specific message by ID. This includes provider responses and rendering metadata. ### get_user_profile Get the profile data for a specific user. This includes contact details and channel-specific delivery preferences. ### list_audiences List saved audiences for targeted notifications. This shows you the IDs, names, and filter criteria for your segments. ### list_brands List custom brands configured in Courier. You can see brand names, colors, and logo settings for white-labeling. ### list_subscription_lists List subscription lists for managing recipients. This shows list IDs, names, and subscriber counts. ### list_messages List sent messages and their current status. You can see recipient identifiers and timestamps for messages sent, delivered, or opened. ### list_templates List available notification templates. This shows the template names, IDs, and the channels they support. ### list_users List users registered in the Courier workspace. This provides user IDs, roles, and account association details. ### send_notification Send a notification to a recipient. This triggers a message using your template engine and routes it to the correct provider. ## Prompt Examples **Prompt:** ``` Did the password reset go through for user_88? ``` **Response:** ``` Yes, the password reset for user_88 was successfully **DELIVERED** via SendGrid. It was opened 2 minutes ago. **Details:** - **Status:** Delivered - **Provider:** SendGrid - **Timestamp:** 10:42 AM ``` **Prompt:** ``` Send a welcome message to the new user. ``` **Response:** ``` I've enqueued the **Welcome** notification for the new user. Courier will route it to their preferred channel. Would you like me to monitor the delivery status for you? ``` **Prompt:** ``` What templates do I have? ``` **Response:** ``` You have 12 templates available, including: - **Password Reset** - **Order Shipped** - **Weekly Digest** Would you like to see the details for a specific one? ``` ## Capabilities ### Send multi-channel notifications Trigger messages to any recipient via email, SMS, push, or chat apps. ### Track real-time delivery status Check if a message was sent, delivered, or opened in real time. ### Manage notification templates Browse and organize your pre-made message styles and brand settings. ### Audit message history Look back at logs to see every event that happened during a past send. ### Manage user profiles Retrieve contact details and delivery preferences for any user. ### Organize audience segments List and filter groups for targeted messaging across different channels. ## Use Cases ### Troubleshooting a failed verification code A user complains they didn't get a code. The agent uses get_message_history to check the status and get_user_profile to see if the phone number is correct. ### Sending a system maintenance alert You need to send a maintenance alert. The agent uses list_templates to find the right one and send_notification to blast it to the All Users audience. ### Checking marketing list sizes A marketing lead wants to know how many people are in a specific list. The agent uses list_subscription_lists to provide a quick count of subscribers. ### Auditing brand assets You need to update a brand's logo. The agent uses list_brands to show current settings and help you plan the update. ## Benefits - Stop manual status checking. Use list_messages to see exactly what happened with every send without refreshing a dashboard. - Get instant user insights. Pull data with get_user_profile to understand a customer's preferences before you respond to a ticket. - Simplify template management. Use list_templates to quickly find the right message style for any situation. - Audit delivery issues faster. Use get_message_history to see provider logs and find the root cause of a failed notification. - Target better audiences. Use list_audiences to see your segments and ensure your AI agent is sending to the right group. - Streamline multi-channel sends. Use send_notification to let your agent handle the routing logic across different providers. ## How It Works The bottom line is you get a central command center for all your app's outgoing communications without leaving your chat interface. 1. Connect the Courier MCP to your AI client and provide your API key from the Courier settings. 2. Describe the notification you want to send or the data you need to check in plain English. 3. Receive the confirmation of the send or a detailed report on message delivery history. ## Frequently Asked Questions **Can the Courier MCP send SMS and emails?** Yes, it handles multi-channel notifications across SMS, email, push, and various chat apps in one place. **How do I check if a message was opened?** You can ask your agent to check the delivery status of any message, and it will pull the real-time status for you. **Can I manage my notification templates with Courier?** Yes, you can list and browse all your active templates directly through your AI client. **Does the Courier MCP support audience segmentation?** It allows you to list and view your saved audience segments and their filter criteria. **How do I see user contact preferences?** Your agent can pull specific user profiles to check their email, phone, and channel preferences. **Can I use Courier MCP to troubleshoot delivery failures?** Yes, it can pull detailed provider logs and event histories to help you find out why a message failed. **How do I get a Courier Auth Token?** Log in to your Courier dashboard, navigate to **Settings > API Keys**, and you will find your Auth Token there. Use the 'Published' key for production environments. **What channels are supported?** Courier supports dozens of providers for Email (SendGrid, Mailgun), SMS (Twilio, MessageBird), Push (Firebase, OneSignal), and Chat (Slack, Discord). **Can I track if a message was opened?** Yes, the agent can use the get_message_details tool to check the status of a specific message, which includes tracking events like 'OPENED' or 'CLICKED' if supported by the provider.