# Authkey MCP MCP

> Authkey MCP sends transactional messages across SMS, email, voice calls, and WhatsApp using one unified gateway. It gives your AI agent full control over automated notifications, security verification (OTPs), and real-time operational reporting. You manage multi-channel communication workflows without jumping between multiple vendor portals.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** cpaas, otp-verification, transactional-email, voice-messaging, multi-channel-messaging, notifications

## Description

Your agent handles all global notifications through a single conversational interface. Instead of manually logging into separate systems for SMS, email campaigns, or voice alerts, you direct your AI client to coordinate the entire workflow. Need to send an order update and then verify the user's identity? Your agent manages both steps automatically. It sends high-fidelity SMS messages, fires off transactional emails using pre-approved templates, or initiates automated voice calls for critical security alerts. You can even monitor usage costs instantly by asking your agent what the current balance is across all channels. This level of communication control makes managing complex customer journeys simple. Because Vinkius hosts this MCP in its catalog, you connect once and gain access to a full-featured CPaaS solution right from your natural language commands.

## Tools

### check_balance
Retrieves a real-time count of available credits for SMS, voice minutes, and emails across all channels.

### check_authkey_status
Checks the overall connection status to ensure the service is currently operational.

### get_email_status
Fetches the status details related to outgoing email messages.

### get_sms_status
Retrieves the current delivery status for specific SMS transmissions.

### get_voice_status
Checks the delivery and connection status of initiated voice calls.

### list_sms_history
Retrieves a log detailing all previously sent SMS messages, including timestamps and recipients.

### list_templates
Provides an inventory of available communication templates for both SMS and email channels.

### send_bulk_sms
Sends a single message to multiple recipients simultaneously, useful for mass announcements or alerts.

### send_email
Dispatches a structured email message using the system's template directory.

### send_otp
Sends an immediate One-Time Password (OTP) to a specified user for verification purposes.

### send_sms
Transmits a single, targeted SMS message to one specific phone number.

### send_voice
Initiates an automated voice call using Text-to-Speech or pre-recorded audio templates.

### verify_otp
Takes a provided code and confirms if it matches the expected OTP for a given session ID.

## Prompt Examples

**Prompt:** 
```
Send a security OTP to '+123456789' using template ID '101'.
```

**Response:** 
```
OTP dispatched! I've successfully sent the security code to +123456789. The Log ID for verification is 'auth_992'. Shall I wait for the user to provide the code?
```

**Prompt:** 
```
Verify OTP code '5566' for Log ID 'auth_992'.
```

**Response:** 
```
OTP Verified! The code 5566 has been successfully confirmed for the provided session. The high-fidelity identity check is complete. Need any further security actions?
```

**Prompt:** 
```
What is my current Authkey account balance across all channels?
```

**Response:** 
```
Scanning account... Your current balance includes 1,500 SMS credits, 500 Voice minutes, and 10,000 Email credits. You are in good standing for your next notification run. Shall I retrieve your template directory?
```

## Capabilities

### Send Notifications
Dispatch high-fidelity SMS messages or transactional emails using pre-defined templates.

### Perform Voice Communication
Initiate automated voice calls for security alerts or customer service updates, supporting Text-to-Speech audio.

### Verify User Identity
Programmatically send and verify One-Time Passwords (OTPs) to build secure two-factor authentication flows.

### Monitor Account Status
Check the current balance and status across all communication channels, including SMS, voice, and email credits.

### Manage Templates
List and reference existing communication templates to ensure brand messaging is consistent for every message type.

## Use Cases

### Onboarding a new client
A security engineer needs to set up 2FA for a new user. Instead of manually calling three different APIs, they tell their agent: 'Send an OTP code via SMS and then confirm the user's response.' The agent runs `send_otp` followed by waiting for and running `verify_otp`. It’s done.

### Handling a failed order shipment
A customer support rep needs to notify a client. They first run `check_balance` to confirm funds, then use the agent to send an update via email (`send_email`) and follow up with a quick SMS alert (`send_sms`). No manual coordination needed.

### Running a compliance audit
A lead needs to prove all outgoing alerts were logged. They ask the agent to retrieve `list_sms_history` and then confirm if any voice calls failed by checking `get_voice_status`. The logs are centralized.

### Running a massive marketing campaign
A marketing team runs a big alert. They use the agent to access approved messaging standards via `list_templates`, then trigger the dispatch using `send_bulk_sms` and monitor usage with `get_email_status` afterward.

## Benefits

- Avoid manual toggling between different vendor portals. You tell your agent what to do, and it executes the flow using `send_sms`, `send_email`, or `send_voice` without you having to switch tabs.
- Build secure authentication flows instantly. Use `send_otp` and then `verify_otp` in a single conversation with your agent for reliable two-factor verification.
- Stop guessing about costs. Before sending anything, always call `check_balance`. This ensures your operations don't fail halfway through an alert run because the credits ran out.
- Coordinate complex campaigns easily. You can list templates using `list_templates` and then use that information to power a `send_bulk_sms` or `send_email` action.
- Get immediate visibility into message delivery. Use tools like `get_sms_status` or `list_sms_history` to audit exactly when and if a message was received by the user.

## How It Works

The bottom line is that you're using one simple instruction set to manage complex communication flows across multiple channels.

1. Subscribe to this MCP, then retrieve your API Key from the Authkey dashboard.
2. Connect the key to your AI client. Your agent can now access all communication tools through natural language commands.
3. Tell your agent exactly what you need—for example, 'Send a security code via SMS and wait for confirmation.' — and it handles the sequence.

## Frequently Asked Questions

**How do I check my spending limit with Authkey MCP?**
Call `check_balance`. This tool gives you a real-time count of credits for SMS, voice, and email across all channels so you know exactly what you're spending.

**Can I send multiple types of messages with Authkey MCP?**
Yes. You can coordinate complex flows by sending an SMS (`send_sms`), followed by a voice call (`send_voice`), and finally wrapping up with an email (`send_email`)—all in sequence.

**What if my message fails using Authkey MCP?**
You can check the failure point using status tools. For SMS, use `get_sms_status`; for voice calls, check `get_voice_status` to find out why it didn't go through.

**How do I create an OTP with Authkey MCP?**
You first dispatch the code using `send_otp`. Once the user provides the code, you run `verify_otp` to confirm identity for your agent.

**How do I check my recent message activity using the `list_sms_history` tool?**
The `list_sms_history` tool retrieves a record of all past SMS communications. You can use this to audit deliveries, confirm timestamps, and verify which messages were sent successfully.

**What should I do if the connection fails? How does `check_authkey_status` help?**
Running `check_authkey_status` verifies your current connectivity to the Authkey gateway. If this tool reports an error, it means the issue is on the platform side; you'll need to check your API credentials or contact support.

**How do I make sure my messages use consistent branding? Should I use `list_templates` first?**
Yes, using `list_templates` lets you see all available communication templates. This ensures that every automated message—from emails to SMS—uses approved language and maintains brand consistency.

**What is the best way to send thousands of alerts at once? Should I use `send_bulk_sms`?**
`Send_bulk_sms` processes large volumes of messages efficiently. This tool groups multiple recipients together, making it ideal for operations like mass campaign notifications or system-wide alerts.

**How do I find my Authkey API Key?**
Log in to your account at [**authkey.io**](https://authkey.io/), navigate to the dashboard, and copy your unique Authkey.

**Can I verify OTPs via AI?**
Yes! The `verify_otp` tool allows your agent to confirm security codes by providing the Log ID from the original request and the code entered by the user.

**How do I check my remaining credits?**
Use the `check_balance` tool to retrieve high-fidelity real-time credit status for SMS, Voice, and Email channels directly through your agent.