# Dexatel MCP MCP

> Dexatel MCP lets your agent send SMS messages globally, track delivery status, and manage contacts directly from natural language conversation. It hooks up to your existing Dexatel account via API calls, handling everything from listing message history to checking your current credit balance without you needing to open a dashboard.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-gateway, business-messaging, cloud-communications, delivery-tracking, contact-management, bulk-messaging

## Description

Your agent can handle global communications using this MCP. Instead of logging into a separate platform to send messages or check logs, you just ask the question. You tell it who needs an update and what the content is, and it sends the SMS through your authorized sender IDs. It monitors messaging activity for you, pulling detailed information on every message sent or received. Need to know if a specific customer profile exists? Or maybe you want a list of all contacts in the address book? This MCP handles that retrieval automatically. When you connect this via Vinkius, it becomes just another function your agent performs—no more switching between tools and dashboards. It manages everything from listing templates to checking account credit.

## Tools

### get_account_balance_metadata
Gets your current account balance and usage metadata for Dexatel.

### get_contact_profile
Retrieves the full profile details and message history for a specific contact.

### get_sms_message_details
Pulls detailed status information for one particular SMS message ID.

### list_messaging_contacts
Lists every contact stored in your Dexatel address book.

### list_failed_sms_deliveries
Identifies and lists SMS messages that failed to deliver, along with failure reasons.

### list_sms_messages
Retrieves a list of all SMS messages, both sent and received, in your account.

### list_authorized_sender_ids
Lists all the sender IDs and virtual numbers authorized on your account.

### list_sms_templates
Lists all approved message templates you can use for sending communications.

### search_sms_by_content
Searches through your entire message history using specific keywords or numbers.

### send_sms_message
Sends a brand new SMS text message to a specified phone number.

## Prompt Examples

**Prompt:** 
```
Send an SMS to '+1234567890' saying 'Your order is ready!'.
```

**Response:** 
```
I've successfully sent the SMS to +1234567890. The message ID is 12345. Would you like me to track its delivery status for you?
```

**Prompt:** 
```
Show me the last 5 sent messages.
```

**Response:** 
```
The last 5 sent messages include notifications to '+123...' and '+198...'. All are marked as 'Delivered'. Should I pull the full content for any of them?
```

**Prompt:** 
```
What is my current account balance?
```

**Response:** 
```
Your current balance is $45.20. You have approximately 3,000 SMS credits remaining based on your current rates. Would you like to see your usage for this month?
```

## Capabilities

### Send SMS Messages
Sends a new text message to any number using your authorized sender IDs.

### Check Account Credit
Retrieves the current balance and usage metadata for the Dexatel account.

### Retrieve Contact Details
Pulls a specific contact's full profile, including their messaging history.

### List Message History
Retrieves lists of all sent or received SMS messages within the account timeframe.

### Find Specific Messages
Searches through message logs for specific keywords or numbers in the content.

## Use Cases

### Handling a Customer Complaint
A support agent gets a complaint about an order delay. They ask their agent, 'What's the status of Jane Doe?' The system automatically runs `get_contact_profile` and returns her full history, allowing the agent to respond instantly without switching screens.

### Running a Marketing Campaign Audit
A marketing manager needs to know how many messages went out last week. They ask their agent to 'List all SMS messages from the past seven days.' The system runs `list_sms_messages` and provides an immediate, filtered report.

### Sending Urgent Alerts
A business owner needs to send a critical notification. They prompt their agent: 'Send message X to Y using template Z.' The system uses `send_sms_message` and confirms the delivery attempt immediately.

### Investigating Delivery Issues
The team notices several messages failing. They ask the agent to run diagnostics, triggering `list_failed_sms_deliveries`. The system provides a clear list of failures and their technical reasons.

## Benefits

- Instead of manually checking dashboards, you can immediately check your account credit using `get_account_balance_metadata`. This keeps notifications flowing without manual checks.
- You stop guessing about failed messages. The `list_failed_sms_deliveries` tool reports exactly why a message bounced or failed to deliver.
- Customer support gets instant context. By calling `get_contact_profile`, your agent pulls the full history and profile before you even start typing.
- Never struggle with template creation again. Use `list_sms_templates` to see all approved messages, ensuring compliance every time you send an alert.
- Need to find one specific conversation from months ago? You can use `search_sms_by_content` to pull the exact message by keyword or number.

## How It Works

The bottom line is you tell your agent what needs doing; it figures out which Dexatel function to call to get it done.

1. First, connect the Dexatel MCP to your AI client and authorize it using your API Key.
2. Next, you prompt your agent with a request—for example, 'Send an alert to Jane Doe'.
3. The MCP executes the necessary tool calls (like `send_sms_message`), returns confirmation of success or failure, and reports status back to your conversation.

## Frequently Asked Questions

**How do I check my credit balance using get_account_balance_metadata?**
Just ask your agent to retrieve the account metadata. This tool calls `get_account_balance_metadata` and gives you real-time figures on your current remaining credits.

**What if an SMS fails? Can I use list_failed_sms_deliveries?**
Yes, running `list_failed_sms_deliveries` is the right move. It identifies which messages bounced and provides the technical reason for failure so you know exactly why.

**How do I send a message from my workflow?**
You use `send_sms_message`. Make sure you have first checked your balance with `get_account_balance_metadata` to avoid running into errors mid-process.

**Can I search through old messages easily? Use search_sms_by_content.**
Absolutely. Running `search_sms_by_content` lets you pinpoint specific conversations by keyword or number, saving you from scrolling through every single message log.

**How do I retrieve a full profile and message history for one person using get_contact_profile?**
The tool fetches all available data for a specific contact. You'll receive their complete profile details along with every historical messaging record tied to that phone number.

**If I have an SMS message ID, how do I check its exact delivery status using get_sms_message_details?**
This function retrieves detailed metadata for a single message. It provides more than just 'Delivered,' including precise technical timestamps and the specific carrier information used.

**Before sending messages, how do I verify all available virtual numbers using list_authorized_sender_ids?**
It generates a clear inventory of every Sender ID and virtual number linked to your account. Use this to confirm which identities are active before drafting a message.

**How can I see all the pre-approved messaging structures using list_sms_templates?**
This function pulls a list of every template you've created in your dashboard. It’s essential for reviewing approved messaging formats before running campaigns.

**How do I get a Dexatel API Key?**
Log in to your Dexatel account, navigate to **Settings > API**, and you can retrieve your unique API Key from that section.

**Can the agent receive SMS messages?**
Yes, you can use the list_sms_messages tool to view both sent and received messages in your account history.

**Does the integration show real-time delivery status?**
Yes, when retrieving message details, the agent provides the latest status (e.g., delivered, pending, failed) as reported by the Dexatel platform.