# Telnyx MCP > Telnyx MCP connects your AI agent directly to global communication data. Use it to list active phone numbers, check account balances, audit call logs, and send SMS messages—all without logging into a web portal. It turns complex telecom operations into simple conversation prompts. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** telecom, sms-notifications, call-logs, phone-numbers, global-connectivity, api-integration ## Description Managing a global communications stack used to mean jumping through multiple vendor dashboards just to get basic data points. Now, your agent handles it all. By connecting Telnyx via this MCP, you treat your entire communication infrastructure like an extension of your own workflow. Your AI client can instantly pull the latest account balance or list every phone number registered to your account. Need to know if a message went through? Just ask, and it retrieves detailed status and history. It’s built for real-time telecom strategy. You don't need specialized knowledge; you just talk to it. This MCP lives on Vinkius, making it accessible from any compatible AI client, so your agent is ready wherever you work. ## Tools ### get_call Fetch specific details for a single voice call using its identifier. ### get_me Retrieve basic authenticated information about your Telnyx public key setup. ### get_phone_number Get specific details for a single phone number by its ID or credentials. ### get_balance Check your current account balance to know exactly how much credit you have remaining. ### list_calls Retrieve a list of recent voice calls, providing essential metadata for each entry. ### list_messages Get a comprehensive list of your most recently sent and received messages. ### list_messaging_profiles List all currently configured messaging profiles within the Telnyx environment. ### list_phone_numbers Retrieve a full list of every phone number registered and active on your account. ### list_verified_numbers List all the numbers that have successfully passed verification checks. ### send_message Initiate and send a new SMS message to any destination number. ## Prompt Examples **Prompt:** ``` List all my Telnyx phone numbers. ``` **Response:** ``` I've retrieved your phone numbers. You have 2 active numbers: '+1 234 567 890' and '+1 987 654 321'. Both are active and ready for voice/SMS. ``` **Prompt:** ``` Check my Telnyx account balance. ``` **Response:** ``` I've retrieved your balance. You currently have $125.50 available in your Telnyx account. Credit limit is $0.00. ``` **Prompt:** ``` Show me the last 5 calls for my project. ``` **Response:** ``` I've found 5 recent calls. Notable interactions include an outbound call to '+1 111 2222' with status 'completed'. Would you like the full metadata for any specific call? ``` ## Capabilities ### Audit call and message history You can list all recent voice calls or fetch the full metadata for a specific call to see details like duration and direction. ### Manage phone numbers The MCP lets you retrieve detailed information about any specific number or list every phone number associated with your account. ### Send SMS messages globally You can use the agent to send an SMS message directly, confirming delivery and managing global outreach campaigns. ### Check financial status It retrieves your real-time account balance, helping you track communications spending on the fly. ### Monitor messaging setup You can list all active messaging profiles and verified numbers to confirm that your communication paths are open. ## Use Cases ### Verifying compliance after an outage A field operations manager needs proof of delivery for a week's worth of critical alerts. Instead of manually checking the web portal, they prompt their agent to use `list_messages` and then specify key dates, allowing the MCP to retrieve all necessary message history details automatically. ### Pre-launch network audit A telecom engineer is setting up a new service line. They ask the agent to run `list_phone_numbers` and then use `get_phone_number` on the target number repeatedly to validate its status, ensuring it’s ready for voice and SMS traffic before deployment. ### Investigating a dropped call A customer service agent receives a complaint about a missed connection. They prompt their AI client to use `list_calls` to find the date range, then specify the problematic time slot so the MCP can run `get_call` and deliver full metadata for review. ### Checking readiness before expansion A business owner plans a global campaign. They ask the agent to check both `list_verified_numbers` and `get_balance`. This confirms not only that they have enough credit but also that the target numbers are verified and ready for immediate use. ## Benefits - Instantly audit every call and message. Instead of downloading log CSVs, your agent pulls the full metadata for calls using `list_calls` or detailed status from `get_call`, giving you instant context without manual file handling. - Control number inventory effortlessly. You can run `list_phone_numbers` to see every active asset on your account and then use `get_phone_number` to deep-dive into the specs of a single line, all in one conversation. - Manage spending proactively. Before launching a campaign, check your real-time cost status using `get_balance`. This prevents unexpected overages by keeping financial data front-and-center with every action you take. - Never miss an update. Sending critical alerts is simple; just ask the agent to execute `send_message` and confirm delivery status instantly. It's reliable, actionable messaging from your workflow. - Consolidate all communication oversight. You get a single point of truth for everything—from listing profiles via `list_messaging_profiles` to checking message history with `list_messages`. No more jumping between tabs. ## How It Works The bottom line is that it lets you talk to your telecom platform as if it were just another API endpoint in your workflow. 1. Subscribe to the MCP and provide your Telnyx API Key. 2. Connect your preferred AI client (like Claude or Cursor) through Vinkius. 3. Tell your agent what you need. It executes the necessary calls and gives you a clean, conversation-ready answer. ## Frequently Asked Questions **How do I check my Telnyx account balance with the Telnyx MCP?** You ask your agent to retrieve the account balance. The MCP uses the `get_balance` tool, which returns your real-time available credit and any associated limits in a single response. **Can I send an SMS message using the Telnyx MCP?** Yes, you can. Use the agent to execute `send_message` by providing the recipient number and the body text. It handles the transmission of the message globally. **What is the difference between listing calls and getting a specific call detail with Telnyx MCP?** Listing calls (`list_calls`) gives you a summary list (date, destination). Getting details (`get_call`) requires a specific ID and returns the full metadata for that one interaction. **Does the Telnyx MCP help me manage my phone numbers?** Absolutely. You can use `list_phone_numbers` to see all registered assets, and then use `get_phone_number` on any specific number for detailed configuration checks. **Can the Telnyx MCP handle message history?** Yes. You can run `list_messages` to retrieve a list of recent messages, giving you visibility into your ongoing communication flow without manual effort.