# Authkey MCP MCP

> Authkey provides unified messaging capabilities for sending SMS, transactional emails, voice OTPs, and WhatsApp messages through a single gateway. Use it to build automated notification flows that handle everything from two-factor authentication to bulk order updates across multiple channels.

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

## Description

Stop managing separate logins and protocols just to send a message. This MCP lets you orchestrate all your company’s outgoing communications—SMS, email, voice calls, and more—from a single conversation with your AI agent. Whether you're sending time-sensitive security codes or running large marketing campaigns, it handles the complexity of multi-channel delivery. You can use the agent to verify credentials by sending an OTP, then immediately send a follow-up confirmation email, all in one go. If you build complex sequences that need billing oversight, Vinkius AI Analytics keeps track of every call and credit used, so you never lose visibility into your operational costs. It’s about treating communication as one service, not three separate portals.

## Tools

### check_authkey_status
Checks if the communication gateway connection is currently active and working.

### check_balance
Gets a real-time count of remaining credits for SMS, Voice, and Email channels.

### get_email_status
Retrieves the current operational status or health check for email communications.

### get_sms_status
Checks the specific operational status of SMS messaging services.

### get_voice_status
Verifies that automated voice calling capabilities are active and functional.

### list_sms_history
Retrieves a list of past SMS messages sent through the gateway for review.

### list_templates
Shows all saved message templates (for SMS or email) that can be used in future sends.

### send_bulk_sms
Sends a single text message to many phone numbers simultaneously for large campaigns.

### send_email
sends a formal, structured email to one or more recipients.

### send_otp
Automatically sends a time-sensitive One-Time Password code to a user's device.

### send_sms
Sends a single, targeted text message to one specific phone number.

### send_voice
Initiates an automated outbound voice call using either TTS or a stored script.

### verify_otp
Confirms whether a user-provided code matches the expected One-Time Password for verification.

## 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

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Use Cases

### Handling New User Signups
A user signs up, and your agent automatically runs `send_otp` to the phone number. Once verified using `verify_otp`, the agent then uses `send_email` to deliver a full welcome package.

### Customer Order Updates
The support team needs to alert 50 customers about a delay. Instead of logging into multiple portals, they prompt the agent to run `send_bulk_sms` for immediate notification, followed by an email using `send_email` with tracking links.

### Security Breach Simulation
A security incident requires immediate action. The agent calls `get_voice_status`, then executes `send_voice` to call affected users, informing them of the breach and requiring verification via a new OTP sent using `send_otp`.

### Daily Reporting
An ops lead needs to know if last night's messages went out. They ask the agent to run `list_sms_history` or `list_email_history`, getting instant, verifiable logs for their report.

## Benefits

- Reliably verify users with the `send_otp` tool for immediate 2FA flows; this is critical for secure client onboarding.
- Run massive campaigns using `send_bulk_sms`, knowing you can track the performance and credits used via Vinkius AI Analytics.
- Automate crucial alerts by running a voice call via `send_voice`. This lets you deliver high-fidelity security messages without manual phone time.
- Maintain brand consistency by first calling `list_templates` to access your curated message library before sending anything out.
- Never run into unexpected costs. Use the `check_balance` tool to monitor credits across all channels and prevent overspending.

## How It Works

The bottom line is you get a centralized brain that manages every outbound message from multiple channels without manual switching or complex code writing.

1. Subscribe to the MCP and grab your API key from Authkey.io.
2. Your AI agent connects using that single credential set, giving it access to all channels (SMS, Email, Voice).
3. You talk naturally to your agent—'Send an OTP for user X'—and it executes the multi-step communication flow.

## Frequently Asked Questions

**How do I check if my account has enough credits before sending messages using send_sms?**
You call the `check_balance` tool first. This instantly tells you your current credit count for SMS, Voice, and Email channels so you don't risk running out mid-campaign.

**Can I use Authkey MCP to verify a user's identity?**
Yes. You send the One-Time Password using `send_otp`, and then your agent uses `verify_otp` to confirm if the code provided is correct for that session.

**What happens when I run send_bulk_sms?**
It sends a single message to multiple recipients simultaneously. This tool is best used for mass announcements or campaign rollouts rather than personal messages.

**Is there a way to see what emails were sent using Authkey MCP?**
While it doesn't list every email, you can use `get_email_status` and the broader communication history tools to ensure that your email system is operational and performing correctly.

**What happens when I use the `verify_otp` tool to confirm a user's identity?**
The tool confirms identity by checking the provided code against an active session record. Your agent sends the verification request and the unique Log ID, which completes the secure authentication flow and prevents unauthorized access.

**How do I use `list_sms_history` to review past messages?**
It retrieves a chronological log of all SMS communications sent through the gateway. You can filter this history by date range or recipient ID within your AI client, providing a full audit trail for reporting.

**Before sending out campaigns, how do I manage my message formats using `list_templates`?**
This tool lists every available template for SMS and email. Checking this output confirms the necessary Template IDs before you send anything, helping keep your messaging consistent with brand guidelines.

**If a voice call fails, what information does `get_voice_status` provide?**
It gives real-time feedback on the status of scheduled or completed calls. You'll see if the call connected successfully, failed due to an invalid number, or was disconnected early.