# TextGrid MCP for AI Agents AI Agent Connect > TextGrid MCP lets you manage global SMS, MMS, and voice communications directly through your AI client. It handles everything from sending verification codes to tracking your monthly spend and managing your phone number inventory. Instead of jumping between dashboards, you can just ask your agent to send a message or check a call log. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_rTPKxAMq92I1EN6bkTBLDZLuV7D9RfUfH9uMv2ja/ai-agent-connect - **Tags:** cloud-telephony, sms-api, voice-api, mms-messaging, communication-platform, textgrid ## Description Imagine you're trying to manage a fleet of international phone numbers while also handling a sudden spike in customer SMS requests. Usually, this means having dozens of tabs open, constantly checking delivery statuses, and manually logging costs in a spreadsheet. With this Connector, you can just tell your agent to do the heavy lifting. You can ask it to find a local UK number, send out a batch of MMS messages, or pull a report on how much you spent on voice calls last week. It turns your AI into a communications hub. Because Vinkius hosts this Connector, you get a clean way to plug your TextGrid credentials into any tool you already use, like Claude or Cursor, so you can manage your entire CPaaS setup without ever touching a raw API endpoint or a cluttered admin panel again. ## Tools ### list_account_addresses List your addresses for regulatory compliance. This is essential for keeping your account legal. ### search_available_numbers Search for new phone numbers in different regions. Use this to find the right local presence. ### list_active_phone_numbers List all your active phone numbers. This keeps your inventory organized in one place. ### list_api_keys List your account API keys. This makes it easier to manage your security credentials. ### list_sms_messages List all sent and received SMS messages. Use this to audit your recent communication history. ### send_sms_message Send a new SMS or MMS message. This is the primary tool for reaching out to customers. ### get_account_details Pull your current account profile and balance. It's the quickest way to see your remaining funds. ### get_message_details Get specific data for a single message. Use this to check the exact status of a sent SMS. ### get_usage_statistics Pull your usage and cost records. This helps you keep your communication budget on track. ### list_voice_calls List your entire voice call history. You can quickly see who called and when. ### check_api_health Verify the TextGrid API status. Use this to make sure your connection is live before running tasks. ### initiate_voice_call Start a new outbound voice call. This lets your agent make calls on your behalf. ## Prompt Examples **Prompt:** ``` Send a text to +1234567890 saying 'Your appointment is confirmed for 3 PM'. ``` **Response:** ``` Done! I've sent that confirmation text to +1234567890. **Message Details:** - **Status:** Sent - **Timestamp:** 2026-07-15 14:30:05 - **Message SID:** SMS-99283 Would you like me to check the delivery status in a few minutes? ``` **Prompt:** ``` What is my current account balance and how much did I spend on SMS this month? ``` **Response:** ``` Here is your current account status: | Metric | Value | | :--- | :--- | | **Current Balance** | $450.25 | | **Monthly Spend (SMS)** | $124.10 | | **Total Messages Sent** | 1,204 | Your balance is healthy for the rest of the month. ``` **Prompt:** ``` Find me some available mobile numbers in France and tell me the pricing. ``` **Response:** ``` I found a few available numbers in France (GB): - +33 6 12 34 56 78 ($15.00/mo) - +33 6 98 76 54 32 ($15.00/mo) - +33 6 55 44 33 22 ($18.50/mo) Would you like me to list more options or help you activate one of these? ``` ## Capabilities ### Send SMS and MMS globally Trigger instant messages to recipients worldwide with full status tracking. ### Initiate and log voice calls Start outbound calls and retrieve a full history of your inbound and outbound communication. ### Manage phone number inventory Search for new numbers in different countries and list your currently active ones. ### Track usage and costs Get detailed statistics to monitor your communication budget in real time. ### Handle account oversight Fetch your API keys and physical addresses for regulatory compliance. ### Verify API health Check your connection status directly through your agent to ensure everything is running. ## Use Cases ### Sending verification codes A developer asks the agent to send a 6-digit code via send_sms_message for a new user signup to skip writing a custom script. ### Auditing call logs A support lead asks to see the last 5 calls from list_voice_calls to troubleshoot a reported issue from a customer. ### Procuring international numbers An ops manager asks the agent to find a UK mobile number using search_available_numbers for a new regional branch. ### Budget reporting A manager asks for a summary of last month's spend using get_usage_statistics to prepare for a quarterly review. ## Benefits - Stop jumping between tabs by using send_sms_message to reach customers instantly. - Keep your budget in check by pulling real-time costs with get_usage_statistics. - Find local numbers faster by using search_available_numbers to expand your global reach. - Audit your communications easily by using list_sms_messages to see every interaction. - Stay compliant without the headache by using list_account_addresses for regulatory checks. - Verify your system is live with check_api_health to avoid errors during critical tasks. ## How It Works The bottom line is you replace manual dashboard clicking with direct natural language commands for your telephony. 1. Grab your Account SID and Auth Token from your TextGrid dashboard. 2. Enter those credentials into your AI client's configuration. 3. Start giving commands like 'Send an SMS' or 'Show me my latest calls'. ## Frequently Asked Questions **Can the TextGrid MCP send MMS messages?** Yes, you can send both SMS and MMS messages to recipients globally. Your agent can handle the full delivery and status tracking for you. **How do I use TextGrid MCP to track my spending?** You can simply ask your agent to pull your usage statistics. It will show you your current spend, costs, and message counts in a clear summary. **Can I find international phone numbers with TextGrid MCP?** Yes, you can search for available numbers in different countries directly through your agent. It's a great way to find local presence without searching manually. **Does TextGrid MCP support voice calls?** It does. You can initiate outbound voice calls and pull a full history of your inbound and outbound call logs using natural language. **How do I see my message history using TextGrid MCP?** Just ask your agent to list your sent and received messages. It will pull your recent communication history so you can audit interactions quickly. **Can I manage my API keys through TextGrid MCP?** Yes, you can use the Connector to list your account API keys and fetch metadata. This helps you keep your credentials organized and accessible. **Can I check the delivery status of a specific message via AI?** Yes! Use the `get_message_details` tool and provide the Message SID. Your agent will retrieve the real-time delivery status (e.g., sent, delivered, failed) and other metadata. **How do I find a new available phone number in the US?** Run the `search_available_numbers` query and set the `countryCode` parameter to 'US'. The agent will return a list of phone numbers available for purchase in that region. **Is it possible to see the costs associated with my messaging usage?** Absolutely. Use the `get_usage_statistics` tool to retrieve detailed usage records and associated costs for your SMS and voice services directly from TextGrid.