# TextGrid MCP > TextGrid MCP Server connects your AI agent directly to global SMS, MMS, and voice communication APIs. It lets you send messages, initiate calls, check usage costs, and audit account details—all through natural language commands. Manage all cloud telephony operations from one spot. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** cloud-telephony, sms-api, voice-api, mms-messaging, communication-platform, textgrid ## Description **TextGrid MCP Server** connects your AI agent directly to global SMS, MMS, and voice APIs. You manage all cloud telephony operations from one spot—no need to jump into a separate dashboard or mess with complex dashboards. Your agent handles everything using natural language commands. **Messaging Capabilities.** Send brand-new **SMS or MMS messages** to any worldwide recipient; your agent tracks the delivery status on every send. You'll get full visibility when you run `list_sms_messages`, which pulls both sent and received message records based on a time frame or specific list of recipients. If you need granular data, calling `get_message_details` lets you pull up everything about one single message record. **Voice Communication.** Initiate outbound calls immediately using `initiate_voice_call`. You can then run `list_voice_calls` to get a complete, structured history of every inbound and outbound call attempt made through the service. **Account & Usage Audit.** You'll keep tabs on your account health by running `check_api_health`, which verifies the current operational status of the TextGrid API endpoint. To check your money situation, you can pull detailed usage reports and cost records via `get_usage_statistics`. Getting an overall picture is easy with `get_account_details`, which fetches your general profile along with your current service balance information. **Number & Credential Management.** Managing numbers and keys is straightforward. Use `list_active_phone_numbers` to pull a list of every number currently assigned on the account. If you need more lines, running `search_available_numbers` lets you look for blocks of new phone numbers available for purchase in specific regions. For compliance or setup checks, your agent can call `list_account_addresses` to list all physical addresses linked to the account. To manage access credentials, `list_api_keys` shows every API key generated for the account. **How It Works.** Just subscribe to the TextGrid MCP Server and configure your AI client with your TextGrid Account SID and Auth Token. Your agent then handles all the complex API calls so you can manage global communications just by talking to it. ## Tools ### check_api_health Verifies the current operational status of the TextGrid API endpoint. ### initiate_voice_call Starts a new outbound voice call immediately through the TextGrid platform. ### get_account_details Fetches your overall account profile and current service balance information. ### get_message_details Retrieves the specific details for any single, identified message record. ### get_usage_statistics Pulls detailed usage reports and cost records for billing oversight. ### list_account_addresses Lists all physical addresses associated with your account, useful for compliance records. ### search_available_numbers Searches for blocks of new phone numbers that are available for purchase in target regions. ### list_voice_calls Pulls a chronological history of all inbound and outbound voice calls made through the service. ### list_active_phone_numbers Retrieves a list of every phone number currently assigned and active on your TextGrid account. ### list_api_keys Shows all API keys generated for the account, allowing you to manage access credentials. ### list_sms_messages Lists both sent and received SMS/MMS messages within a specified time frame or recipient list. ### send_sms_message Sends a brand-new SMS or MMS message to a specified recipient number. ## Prompt Examples **Prompt:** ``` Send an SMS to +15550199 saying 'Your verification code is 12345'. ``` **Response:** ``` SMS sent! I've triggered the message to +15550199 from your TextGrid number. The message SID is MSG-88231. Shall I track its delivery status for you? ``` **Prompt:** ``` Show me the last 3 voice calls from my history. ``` **Response:** ``` I've fetched your call history. You had: 1 Incoming from +123456 (Completed, 5m), 1 Outbound to +987654 (Failed), and 1 Incoming from Unknown (Missed). Would you like details on any specific call? ``` **Prompt:** ``` Search for available mobile numbers in the United Kingdom. ``` **Response:** ``` Fetching available numbers... I found 5 numbers available in the UK (Country Code: GB) including +447700... and +447701... Shall I retrieve the pricing and feature list for these? ``` ## Capabilities ### Send global messages The agent sends SMS or MMS messages to any worldwide recipient and tracks the delivery status. ### Manage voice calls You initiate outbound calls and retrieve a complete, structured history of past call attempts. ### Audit account credentials The agent lists active phone numbers, API keys, and physical addresses for compliance or setup checks. ### Track usage costs You pull detailed records showing message volume, call minutes, and associated billing usage. ## Use Cases ### Onboarding a new client location. A regional manager needs to expand into Germany. They ask their agent: 'What numbers are available for me in the DE region?' The agent uses `search_available_numbers`, returns several blocks, and then runs `list_account_addresses` so they can update compliance records immediately. ### Investigating a failed customer contact. A support specialist is told a client never received a verification code. They ask the agent to 'Check the message logs for +1555...'. The agent runs `list_sms_messages` and finds the message was delivered, but shows a failure status on the recipient's side. ### Testing call flow before launch. A developer needs to test an outbound notification system. They ask the agent to 'Test calling this number'. The agent executes `initiate_voice_call`, and if it fails, they can immediately run `list_voice_calls` to check the failure code. ### Quarterly financial audit. The finance team needs a report on last quarter's communication spend. They ask their agent to 'Get usage stats for Q2'. The agent runs `get_usage_statistics`, pulling the necessary data without manual export or calculation. ## Benefits - You can instantly check service health with `check_api_health`. Before running any complex workflow, the agent confirms connectivity first. This prevents failed runs due to simple API hiccups. - Never manually track costs again. Running `get_usage_statistics` gives you a detailed breakdown of message counts and call minutes, keeping your budget clear in real-time. - The inventory process is faster. Use `list_active_phone_numbers` to see exactly what numbers you own, or use `search_available_numbers` to plan for expansion into new countries. - Message logging is simplified. Instead of digging through multiple dashboards, running `list_sms_messages` pulls a unified feed of all communication history right where your agent works. - Audit compliance tasks quickly. You can run `list_account_addresses` and check your API keys with `list_api_keys`, centralizing critical operational metadata in one call. ## How It Works The bottom line is you manage all TextGrid communications by directing your AI client, instead of logging into separate billing and API dashboards. 1. First, subscribe to the TextGrid MCP Server on Vinkius. You'll need your Account SID and Auth Token. 2. Next, connect these credentials to your preferred AI client (Claude, Cursor, etc.) via the agent setup. 3. Then, ask the agent to perform a task—like 'Show me last month's usage' or 'Send an SMS to 123-4567'. The agent handles the rest. ## Frequently Asked Questions **How do I check if TextGrid is online using the TextGrid MCP Server?** You run `check_api_health`. This tool verifies the API status and tells you right away if there's an issue with connectivity before you send any messages or initiate calls. **Can I list all my phone numbers using the TextGrid MCP Server?** Yes, use `list_active_phone_numbers`. This pulls a complete list of every number currently assigned and active to your account for quick auditing. **What tool do I use to send an SMS message via the TextGrid MCP Server?** Use `send_sms_message`. You provide the recipient's number and the content, and the agent handles sending the new SMS or MMS. **How can I view past voice calls with the TextGrid MCP Server?** Run `list_voice_calls`. This retrieves a chronological history of all inbound and outbound communication attempts for your account, including status codes. **If I suspect a security issue, how do I use the `list_api_keys` tool to manage my TextGrid access?** The `list_api_keys` tool lets you see all generated API keys for your account. This is crucial for auditing and revoking old or compromised credentials immediately. You can ensure only active, necessary keys are in use. **How do I use the `get_usage_statistics` tool to audit my communication spending?** Calling `get_usage_statistics` retrieves detailed records of your SMS, MMS, and voice usage. It provides granular data on costs incurred over specific time periods, helping you manage your monthly budget. **If an SMS message fails to deliver, what information does `get_message_details` provide?** `get_message_details` pulls the full record for a single message ID. You can check the specific failure reason code and timestamp, which helps you determine if the issue was network-related or recipient-side. **When should I use the `list_account_addresses` tool?** You must run `list_account_addresses` when fulfilling regulatory requirements. It retrieves your official, physical business addresses and metadata needed for compliance audits or legal documentation. **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.