# Telnyx MCP for AI Agents AI Agent Connect

> Telnyx MCP lets you manage your global communication infrastructure through your AI client. You can audit phone numbers, check message statuses, pull call logs, and monitor account balances without jumping into a technical dashboard. It turns complex telecom management into a natural conversation.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_UnIXIgwF7XeDaRzftukmg693sdKk54orwaWG9Do0/ai-agent-connect
- **Tags:** telecom, sms-notifications, call-logs, phone-numbers, global-connectivity, api-integration

## Description

Imagine you're trying to track down why a specific SMS didn't land or you need to know exactly how many minutes were spent on a series of outbound calls. Usually, this means logging into a cluttered portal, hunting for the right filter, and copy-pasting data into a spreadsheet. With this Connector, you just ask your agent to do the heavy lifting for you. You can grab a list of all your active phone numbers or check your real-time balance to see how much credit you have left. It's about having a telecom strategist in your pocket who knows your account inside out. Whether you're a dev checking messaging profiles or a manager auditing global voice traffic, this connection gives you direct oversight. It's one of the many ways Vinkius helps you put your tools to work instead of doing the manual clicking yourself. You get answers in seconds, not minutes, and you never have to worry about misinterpreting a technical log again.

## Tools

### get_me
Retrieve your authenticated public key and general account info. Use this to verify your connection status.

### list_messaging_profiles
View all your messaging profiles to see which ones are active. This helps you keep your communication channels organized.

### list_phone_numbers
Get a complete list of all phone numbers currently in your account. Use this to manage your global assets.

### list_verified_numbers
See which of your numbers have been verified for specific services. It helps ensure your messages actually get delivered.

### get_call
Pull specific details for a single call, including its unique metadata. It's useful for deep-diving into a specific interaction.

### get_phone_number
Get the specific details for one of your registered phone numbers. This provides a deep look at individual number stats.

### get_balance
Check your current real-time account balance and credit limits. This keeps your spending under control.

### list_calls
See a list of your most recent voice calls to audit traffic. It's a quick way to see who called and for how long.

### list_messages
Retrieve a history of recent messages sent or received. Use this to verify that your notifications are reaching people.

### send_message
Send an SMS message to a recipient using your Telnyx infrastructure. This is the primary way to trigger alerts.

## Prompt Examples

**Prompt:** 
```
Did my alert SMS go out?
```

**Response:** 
```
I checked your recent messages. The alert sent to **+1 555-0199** was delivered successfully at **10:04 AM**.
```

**Prompt:** 
```
What's my current balance?
```

**Response:** 
```
Your current Telnyx balance is **$142.50**. Your credit limit is set to **$500.00**.
```

**Prompt:** 
```
Show me the last 3 calls.
```

**Response:** 
```
Here are your last 3 voice calls:

| Direction | Duration | Status |
|---|---|---|
| Outbound | 02:15 | Completed |
| Inbound | 00:45 | Completed |
| Outbound | 05:30 | Failed |
```

## Capabilities

### Send SMS messages
Send text alerts or notifications globally using your existing infrastructure.

### Audit call logs
Pull data on recent voice calls including duration and direction.

### Track account balance
Check your current credit and spending limits instantly.

### Manage phone numbers
List and inspect all phone numbers tied to your account.

### Monitor messaging profiles
View verified numbers and active communication profiles.

## Use Cases

### Automated Incident Alerting
An engineer notices a server is down and asks the agent to send an SMS via send_message to the on-call team.

### Voice Traffic Auditing
A manager wants to know the total call volume for the day and asks the agent to pull data using list_calls.

### Global Number Inventory
A team is expanding to a new country and asks the agent to list_phone_numbers to see what's already available.

### Real-time Spend Monitoring
A business owner asks the agent to check their current spend using get_balance before starting a new campaign.

## Benefits

- Stop manual portal logins by using list_calls and list_messages to get data directly into your chat.
- Keep your costs in check by using get_balance to monitor spending without opening a separate billing tab.
- Faster incident response by using send_message to trigger alerts the moment your agent detects an issue.
- Easier inventory management by using list_phone_numbers to keep track of your global assets in one place.
- Better troubleshooting by using get_call to see specific metadata for failed or completed voice interactions.

## How It Works

The bottom line is you get a voice-activated command center for your entire global telecom setup.

1. Subscribe to the Telnyx MCP on Vinkius.
2. Enter your Telnyx API Key in the configuration settings.
3. Ask your AI client to pull call logs, send messages, or check your balance.

## Frequently Asked Questions

**Can I use the Telnyx MCP to send text alerts?**
Yes, the Telnyx MCP lets your agent send SMS messages directly to your users or team members. It's a great way to automate notifications.

**How do I check my Telnyx spending?**
You can ask your agent to check your balance at any time. It will pull your real-time account data and tell you exactly what's left in your credit.

**Can the Telnyx MCP show me my call history?**
Yes, it can list your recent voice calls and provide specific details for any individual call you want to inspect, including duration and direction.

**Is the Telnyx MCP good for managing many phone numbers?**
It's built for that. You can ask your agent to list all numbers in your account to keep your global inventory organized and easily searchable.

**Does the Telnyx MCP work with my current AI client?**
It works with any MCP-compatible client like Claude or Cursor. Once connected, your agent can handle your telecom tasks as part of your normal conversation.

**How do I find my Telnyx API Key?**
Log in to the [**Telnyx Mission Control Portal**](https://portal.telnyx.com/), go to **Account Settings** > **API Keys**, and create a new key. Copy and paste it below.

**Can the agent check my available balance?**
Yes. Use the `get_balance` tool. Your agent will retrieve your current account balance and credit limit from Telnyx instantly.

**Is it possible to send global SMS messages via the agent?**
Yes. The `send_message` tool allows your agent to deliver SMS to any global number using your Telnyx phone numbers, provided your account has the correct messaging profiles.