# Termii MCP

> Termii connects your AI agent to global messaging channels (SMS, WhatsApp, Voice). It lets you send business messages, verify users with OTP codes, and manage API credentials—all from a single chat interface. Check balance, list sender IDs, and programmatically handle multi-channel communication.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** multi-channel-messaging, otp-verification, whatsapp-business, voice-messaging, customer-engagement, api-messaging

## Description

Termii connects your AI agent directly to global messaging channels for two things: sending messages and verifying users. You'll use this server when you need your agent to handle multi-channel communication—whether it’s a simple text blast or a secure login check.

### Sending Messages

**Sending Standard SMS:** Your agent sends a regular text message (SMS) anywhere in the world using `send_sms`. You specify the recipient number, and your agent handles dispatching that standard mobile message. This is for basic communication when you just need to reach someone's phone line.

**Sending WhatsApp Messages:** For business-level chat communication, use `send_whatsapp`. Your agent sends a structured message through the official WhatsApp platform instead of relying on SMS infrastructure. It’s designed specifically for high-volume, professional messaging flows.

### Handling User Verification (OTP)

This server manages secure user onboarding using One-Time Passwords (OTPs). You initiate verification by having your agent use `send_otp`. This function sends a unique, temporary code to the specified recipient number's device. Later, when you need to confirm that the user actually received and knows the code, your agent runs `verify_otp`. You pass the provided code and the associated user details, and the tool checks if that OTP matches an active, unexpired record. It tells you immediately if the login attempt is valid.

### Managing Accounts and IDs

Before sending anything, you gotta know what you're working with. Your agent can run `list_sender_ids` to pull a clean list of every sender ID registered on your account. This ensures that when messages go out, they use recognized, authorized branding—that’s key for delivery rates and trust.

For financial visibility, the server provides `check_balance`. Your agent executes this tool to retrieve your current remaining credit balance and usage data across all messaging services. You always know how much runway you've got left for your campaigns without having to check a separate dashboard.

### How It Works With Your Agent

Your AI client connects to Termii, giving it the necessary API credentials. Instead of writing complex code flows, you just talk to your agent. You tell it: 'Send an OTP to 555-1234,' or 'Check if that code is valid.' The agent then uses these specific tools—`send_otp`, `verify_otp`, `send_sms`, `send_whatsapp`, `check_balance`, and `list_sender_ids`—to execute the commands against your live messaging account. You’re running sophisticated, multi-channel communication flows using simple conversational prompts.

## Tools

### check_balance
Retrieves your current account balance and credit usage for messaging services.

### list_sender_ids
Returns a list of all sender IDs that are registered and ready to use on your account.

### send_otp
Sends a one-time password (OTP) code to the specified recipient number.

### send_sms
Sends a standard SMS text message to a mobile user worldwide.

### send_whatsapp
Sends a business-level chat message using the WhatsApp platform.

### verify_otp
Checks if a provided one-time password (OTP) code is valid for the given user.

## Prompt Examples

**Prompt:** 
```
Send a verification code (OTP) to +15550199.
```

**Response:** 
```
Verification initiated! I've triggered the OTP code delivery to +15550199 via Termii. The request reference ID is pin_88231. I'll let you know when the user provides the code to verify.
```

**Prompt:** 
```
Check my account balance.
```

**Response:** 
```
Fetching balance... You currently have $45.50 in your Termii account. This balance is sufficient for your upcoming automated SMS and WhatsApp campaigns.
```

**Prompt:** 
```
List all Sender IDs registered for my account.
```

**Response:** 
```
I've retrieved your Sender IDs. You have 3 authorized IDs: 'VINKIUS', 'ALERT_MS', and 'AUTH_MSG'. Which one would you like to use for your next campaign?
```

## Capabilities

### Send SMS Messages
Sends a text message (SMS) to a specified recipient number.

### Send WhatsApp Messages
Dispatches a business message via the WhatsApp platform.

### Send One-Time Passwords (OTP)
Triggers the delivery of an OTP code to a user's device, often for verification.

### Verify OTP Codes
Takes a provided code and confirms if it matches an active OTP record.

### Check Account Balance
Retrieves the current remaining credit balance for messaging campaigns.

### List Sender IDs
Returns a list of all registered and authorized sender identifiers available for use.

## Use Cases

### User Login Flow
A user needs to log into the platform. Instead of manually asking a developer to trigger an OTP, they tell their agent: 'Send an OTP code to +15550199.' The agent calls `send_otp` and then waits for confirmation, using `verify_otp` once the user provides the code. Done in three steps.

### Proactive Marketing Campaign
The marketing team needs to run a campaign but isn't sure if they have enough credit. They first call `check_balance`. Once confirmed, they instruct the agent to send 50 messages using `send_whatsapp`, and the system confirms delivery tracking for all of them.

### Developer Integration Test
A developer needs to test if a new feature triggers a message correctly. They run a simple command: 'Send an SMS with the code 12345.' The agent executes `send_sms`, allowing immediate, verifiable testing of the delivery mechanism without manual API calls.

### Audit and Compliance Check
A security analyst needs to know what communication channels are authorized for use. They run `list_sender_ids` via their agent. This confirms all valid sender IDs, ensuring only approved branding is used for critical messages.

## Benefits

- **Multi-Channel Reach:** Send messages via `send_sms` or `send_whatsapp` from one place. You don't need separate tools for SMS and WhatsApp; the agent handles it all.
- **Secure Onboarding:** Use `send_otp` and `verify_otp` together to lock down user accounts. The AI client manages the full verification loop, making security checks simple.
- **Cost Visibility:** Never get caught in an overspend scenario. Run `check_balance` anytime to see exactly how much credit you have left for your campaigns.
- **Branded Messaging:** Before sending anything, use `list_sender_ids` to confirm which sender ID is available. This keeps your messages professional and recognized by the recipient.
- **Global Coverage:** Termii handles messaging across different international channels (SMS, WhatsApp, Voice), so you can reach users regardless of their location.

## How It Works

The bottom line is you manage multi-channel messages and verification by giving direct instructions to your AI client.

1. First, subscribe to the Termii server and provide your API Key.
2. Next, initiate a communication request (e.g., 'Send OTP to X'). The agent calls the relevant tool.
3. Finally, the tool executes the message delivery or data retrieval through Termii's infrastructure.

## Frequently Asked Questions

**How do I check my credit limit using Termii MCP Server?**
You use the `check_balance` tool. Just ask your agent to run 'check_balance.' It will retrieve your current account balance so you know exactly how much messaging credit you have available.

**Can I send both SMS and WhatsApp messages with Termii MCP Server?**
Yes, absolutely. You can use the `send_sms` tool for standard texts or `send_whatsapp` for business chat messages; both are managed through the same unified server.

**What is the best way to verify a user using Termii MCP Server?**
The recommended flow is to first call `send_otp` with the user's number. Once they respond, use the `verify_otp` tool with the code they provide.

**Do I need to worry about my Sender ID when using Termii MCP Server?**
You should always check your registered IDs first by calling `list_sender_ids`. This ensures you use an authorized and active sender ID for maximum delivery reliability.

**How do I use the 'send_otp' tool with Termii MCP Server?**
You must pass the necessary parameters in a JSON object to send an OTP code. This ensures you specify the target phone number and other required details for successful delivery.

**What happens if I use 'send_whatsapp' with Termii MCP Server?**
You pass data as a JSON string when using the send_whatsapp tool. This allows you to format complex message content, ensuring compatibility with WhatsApp Business standards.

**How does 'verify_otp' work within the Termii MCP Server workflow?**
The verify_otp tool requires you to submit a user-provided code for validation. The server checks this submitted code against the active session details to confirm identity.

**Does 'list_sender_ids' help with compliance when using Termii MCP Server?**
Yes, list_sender_ids shows all registered Sender IDs available in your account. Checking this list helps you ensure you are using a recognized and authorized brand name for outgoing messages.

**Can I send an OTP code for user verification via AI?**
Yes! Use the `send_otp` action. Provide the destination number, your Sender ID, and the message type in the JSON payload. Your agent will trigger the OTP delivery instantly.

**How do I check my remaining account balance?**
Run the `check_balance` query. The agent will retrieve your current available credits directly from Termii, helping you monitor your messaging budget.

**Is it possible to see my registered Sender IDs via AI?**
Absolutely. Use the `list_sender_ids` tool. Your agent will retrieve the complete list of all Sender IDs authorized for your account.