# Tatango MCP

> Tatango MCP Server manages high-volume SMS and MMS campaigns for enterprise marketing. Use your agent to run full outreach cycles—from listing subscribers and checking compliance data, to sending mass broadcasts or one-off alerts. It handles the entire lifecycle of compliant messaging without you leaving your chat client.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-marketing, mms-campaigns, tcpa-compliance, subscriber-management, high-volume-messaging, broadcast-messaging

## Description

The Tatango MCP Server lets your agent manage high-volume SMS and MMS campaigns for enterprise marketing right through chat. You don't need to leave your client or jump into a separate dashboard; your agent handles the entire communication lifecycle.

**Managing Your Lists and Contacts**

You can pull up every marketing list you maintain using `list_sms_marketing_lists`. Need details on one specific directory? Use `get_list_details` to check its status or find out how many people are in it. For a full roster, run `list_sms_subscribers` against any specific list, and you'll get every phone number belonging there. If you need deep info on just one number, use `get_subscriber_details`. To keep things clean and compliant, your agent can add new contacts using `add_new_sms_subscriber`, which triggers the necessary opt-in confirmation process. When a user needs to stop receiving messages, you'll remove them from any list with `unsubscribe_phone_number`.

**Sending Messages: Broadcast vs. One-to-One**

For mass outreach—think big marketing blasts—your agent creates and sends out full campaigns using `create_broadcast_campaign`. You can keep a history of everything you've done by running `list_sms_campaigns` to see all previously run or currently active broadcast efforts. If you only need to send one quick, direct message—like a payment receipt confirmation or an urgent alert—you use `send_transactional_sms`, which handles single sends limited to 160 characters.

**System Checks and Oversight**

You gotta know if your connection is solid before you blast out thousands of texts. Run `check_api_health` first; that confirms the Tatango API link is active and working right now. You can also pull detailed info about your connected account credentials and settings by calling `get_account_profile`. To keep track of external connections, use `list_configured_webhooks` to display all active webhooks so you know exactly which outside systems are talking to this server.

This setup lets you run full outreach cycles—from checking compliance data to sending mass blasts—without leaving your chat client. You just tell your agent what needs doing.

## Tools

### add_new_sms_subscriber
Adds a new phone number, triggering an opt-in confirmation process so the contact can join a list.

### check_api_health
Runs a diagnostic check to confirm that the Tatango API connection is active and working.

### create_broadcast_campaign
Creates and sends out a large, mass SMS message campaign to an entire marketing list.

### get_list_details
Retrieves metadata and specific details for a marketing list, confirming its status and size.

### get_account_profile
Fetches detailed information about your connected Tatango account credentials and settings.

### get_subscriber_details
Gets all available information about one specific phone number in the system.

### list_sms_campaigns
Shows all previously created or running broadcast campaigns, letting you review their history.

### list_sms_marketing_lists
Lists every marketing directory and list you currently maintain in the system.

### list_sms_subscribers
Retrieves a full roster of phone numbers belonging to one specific marketing list.

### list_configured_webhooks
Displays a list of currently active webhooks so you know which external systems are connected.

### send_transactional_sms
Sends a single, direct message (receipt, alert, etc.) to one number. It's limited to 160 characters.

### unsubscribe_phone_number
Removes an existing phone number from any marketing list, ensuring compliance and opt-out status.

## Prompt Examples

**Prompt:** 
```
List all my SMS marketing lists.
```

**Response:** 
```
I've retrieved your marketing lists. You have 3 active directories: 'Main Supporters' (1,250 members), 'Event Leads', and 'Volunteer Alerts'. Which one would you like to see subscribers for?
```

**Prompt:** 
```
Send a broadcast to the 'Volunteer Alerts' list: 'Meeting relocated to Hall B. See you there!'.
```

**Response:** 
```
Broadcast initiated! I've triggered the campaign to the 'Volunteer Alerts' list (ID: 10293). All subscribers in that group will receive the update shortly.
```

**Prompt:** 
```
Add +15550199 to the 'Main Supporters' list.
```

**Response:** 
```
Subscriber added! I've registered +15550199 in the 'Main Supporters' list. They will now receive your upcoming broadcast alerts.
```

## Capabilities

### Manage Subscriber Lists
List existing marketing lists and get specific details about any subscriber or list directory.

### Send Broadcast Messages
Create and send mass SMS campaigns to entire groups of subscribers in one go.

### Handle One-to-One Alerts
Send single, non-marketing messages like transaction receipts or time-sensitive alerts to a specific phone number.

### Maintain Compliance
Programmatically add new subscribers and remove old ones (unsubscribes) while managing list metadata.

### Monitor System Status
Check the API's health and review active webhooks to ensure all integrations are running correctly.

## Use Cases

### Post-Event Followup Blast
The non-profit coordinator needs to remind 1,200 attendees about a follow-up meeting. Instead of exporting and re-importing contacts into an email tool, they ask the agent: 'Send a broadcast campaign using the message: The follow-up is Friday at 3 PM.' The agent uses `create_broadcast_campaign` against the 'Event Leads' list, confirming instant mass delivery.

### Handling Customer Service Alerts
A customer calls to confirm a payment. Instead of sending an email that might fail, the ops lead asks the agent: 'Send a confirmation alert for $50 paid.' The agent uses `send_transactional_sms` directly to the number, ensuring immediate receipt delivery.

### Auditing List Health
The campaign manager suspects an old list is dirty. They instruct the agent: 'List all subscribers for the Main Supporters list and check their details.' The agent runs `list_sms_subscribers` and then uses `get_subscriber_details` on a sample, verifying formatting and status.

### API Troubleshooting
The platform suddenly stops sending messages. The developer doesn't know if it's the code or Tatango itself. They ask the agent: 'Check the API connection health.' The agent runs `check_api_health` and reports back instantly, confirming connectivity is stable.

## Benefits

- Runs full outreach cycles with `create_broadcast_campaign`. You can send mass alerts to entire groups without manually selecting recipients.
- Stays compliant and clean. Use `unsubscribe_phone_number` and the add tools to manage opt-ins and opt-outs correctly, keeping your list clean for TCPA safety.
- Know exactly what's running. Check both `list_sms_campaigns` and `list_configured_webhooks` to verify that all your integrations are healthy.
- Manages the entire subscriber life cycle. You can use `add_new_sms_subscriber` for opt-ins or `get_subscriber_details` to check a number's history.
- Separates purpose clearly. Use `send_transactional_sms` only for receipts and alerts; reserve `create_broadcast_campaign` for true marketing blasts.

## How It Works

The bottom line is you manage high-volume messaging campaigns entirely through conversation, never having to open the Tatango web dashboard.

1. First, subscribe to this server and provide your Tatango API Key.
2. Next, tell your agent the goal: 'Send a broadcast alert for next week's event.'
3. The agent executes the necessary tools—checking lists, drafting content, and initiating the campaign.

## Frequently Asked Questions

**How do I make sure my list is compliant before sending a broadcast with Tatango MCP Server?**
You should use `add_new_sms_subscriber` first. This tool forces an opt-in confirmation, which keeps your campaign data accurate and helps maintain TCPA compliance.

**Can I send a single alert message using the Tatango MCP Server?**
Yes. Use `send_transactional_sms`. This tool is specifically for one-to-one, non-marketing alerts—think payment confirmations or appointment reminders.

**What if I need to remove someone from a list? Do I use Tatango MCP Server?**
Use `unsubscribe_phone_number`. This tool removes the number from any marketing list, which is critical for maintaining accurate opt-out records.

**How do I see all my available mailing lists in Tatango MCP Server?**
Run `list_sms_marketing_lists`. This will show you every directory and list your account maintains, giving you an overview of your subscriber base.

**How do I verify my API connectivity using the Tatango MCP Server?**
You run the `check_api_health` tool. This immediately verifies that your connection credentials and the server link are working correctly. It confirms basic API functionality before you start running complex campaigns or reading data.

**Which tool should I use with the Tatango MCP Server to list all my past broadcast messages?**
Use the `list_sms_campaigns` tool. This command retrieves a history of every campaign you've initiated through the platform. You can check statuses and details for review right from your agent.

**Where can I view my active outbound events using the Tatango MCP Server?**
Call `list_configured_webhooks`. This tool shows every webhook you've set up, which is crucial for monitoring integrations. It lets you confirm that your external systems are receiving data correctly.

**What tool in the Tatango MCP Server helps me check individual subscriber details?**
The `get_subscriber_details` tool retrieves information on a single phone number. This is useful if you need specific metadata or verification for an address that isn't part of a defined marketing list.

**Can I send an SMS to a whole list using the AI?**
Yes! Use the `create_broadcast_campaign` tool. Provide the List ID and your message text. Your agent will trigger the broadcast to all subscribers in that list instantly.

**How do I add a new phone number to a marketing list?**
Use the `add_new_sms_subscriber` action. Provide the phone number and the target List ID. The agent will instantly register the new subscriber in Tatango.

**Is it possible to see my recent broadcast history via AI?**
Absolutely. Run the `list_sms_campaigns` query. The agent will retrieve a history of all broadcast messages sent from your account, allowing you to monitor past outreach.