# MessageBird MCP > MessageBird helps your AI agent manage all global communications in one place. Send SMS messages, check real-time account balances, and audit large contact lists without ever logging into a dashboard. Use this MCP to automate everything from sending verification codes to checking message history across any compatible client. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** omnichannel, sms-gateway, contact-management, messaging-api, customer-engagement, real-time-sync ## Description This MCP lets your agent handle your entire global communication strategy. Instead of jumping between multiple portals—one for contacts, another for billing, and a third for messaging—your AI client handles it all in one conversation. You can tell your agent to send an SMS message, check the recipient's full contact history, and confirm if you have enough funds for the campaign, all at once. It’s like having a real-time communications coordinator on staff. Whether you need to run mass marketing broadcasts or just verify a single user's number before sending a code, your agent manages it. You can also list configured channels and audit past messages, ensuring everything is tracked correctly. By connecting MessageBird through the Vinkius catalog, your workflow moves from complex manual steps to simple conversation. ## Tools ### list_hlr Lists Home Location Register requests, helping verify number validity and network status. ### list_messages Retrieves a list of your most recent SMS messages sent through the platform. ### get_group Retrieves details about a specified contact group. ### list_channels Lists all communication channels that are currently configured for your account. ### list_contacts Retrieves a list of all existing contacts stored in MessageBird. ### list_groups Provides a listing of the contact groups available to you. ### get_message Fetches the full content and status of one specific message ID. ### get_balance Retrieves the current financial balance for your MessageBird account. ### get_contact Gets all detailed information for a specific contact ID. ### send_sms Sends a new text message to a specified global recipient number. ## Prompt Examples **Prompt:** ``` Check my MessageBird account balance. ``` **Response:** ``` I've retrieved your balance. You currently have $50.00 available in your account. The payment type is set to PREPAID. ``` **Prompt:** ``` List the last 5 SMS messages sent from my account. ``` **Response:** ``` I've found your recent messages. You have 5 sent SMS, including one to +123456789 with status 'delivered'. Would you like the full text for any of them? ``` **Prompt:** ``` Send SMS 'Your discount code is VINKIUS20' to +15550123. ``` **Response:** ``` Message delivered! I've successfully sent the discount code to +15550123. The originator was set to 'Vinkius'. The message ID is xxxxxxxx. ``` ## Capabilities ### Send global SMS alerts Your agent sends text messages to any recipient worldwide and tracks detailed delivery status. ### Audit contact databases You can list, retrieve details for specific contacts or groups, giving you a full view of your audience data. ### Monitor communication costs The agent checks the current account balance so you always know how much money you've spent and what's left. ### Review message history Retrieve and list recent SMS messages, including delivery status and full content for auditing purposes. ### Verify number validity The agent performs HLR requests to check if a phone number is valid and connected to the network. ## Use Cases ### Campaign Launch Readiness Check A marketing lead needs to send a discount code. They ask their agent: 'Check the account balance, verify if I have enough contacts in Group A, and then send an SMS.' The agent uses `get_balance`, `list_groups`, and `send_sms` to complete the whole process without any manual intervention. ### Investigating Failed Deliveries A support agent notices a customer claim their messages aren't going through. They tell their agent, 'Show me the last 10 messages for this user.' The agent runs `list_messages` and provides the full delivery history, identifying exactly where the message failed. ### Data Hygiene Audit An operations manager needs to clean up an old contact list. They ask their agent to run a check on 50 numbers using `list_hlr`. The agent reports which numbers are invalid or inactive, saving hours of manual phone number validation. ### Pre-Broadcast Validation A business owner is launching a new product and needs to make sure the contact list is current. They ask the agent to run `list_contacts` and check for any missing metadata fields, guaranteeing that all recipients are up to date. ## Benefits - You instantly know your financial status. Using `get_balance` means you never have to manually check a dashboard just to see if you can afford another campaign. - Auditing contact lists is fast. With `list_contacts` and `list_groups`, your agent pulls all the data you need without you having to navigate deep menus or copy/paste hundreds of names. - Messaging becomes simple. Instead of writing a multi-step process, simply ask your agent to `send_sms`. It handles the recipient details and tracks delivery status for you. - Support workflow improves immediately. You can use `list_messages` to give a customer support agent full visibility into message history in seconds, making issue resolution much faster. - Connectivity is verified upfront. Before launching a campaign, run `list_hlr` to check number validity and make sure your audience data isn't wasted on dead numbers. ## How It Works The bottom line is, your agent turns complex messaging tasks into simple conversational commands. 1. Subscribe to this MCP on Vinkius. 2. Enter your MessageBird API Key into your AI client. 3. Tell your agent what you need—like 'Check my balance and send an SMS'—and it uses the tools to get the answer. ## Frequently Asked Questions **How do I check my MessageBird account balance using this MCP?** Use the `get_balance` tool. Your agent runs this command and tells you your current spending limits, so you never run out of funds unexpectedly. **Can I use MessageBird to send SMS messages from a group list?** Yes. You can first run `list_groups` to identify the target contacts and then instruct your agent to execute `send_sms`, handling the message dispatch for you. **What is the difference between `get_contact` and `list_contacts`?** Use `list_contacts` when you need an overview of every contact. Use `get_contact` only when you know the specific ID and want all detailed information for just that one person. **Does MessageBird help me verify phone numbers?** Yes, run `list_hlr`. This tool checks the Home Location Register to validate if a number is active on the network before you send an expensive message. **Can I audit old messages with MessageBird MCP?** Absolutely. Use `list_messages` to retrieve and review recent communication history, helping your team solve support issues faster than manual logging allows. **How do I find my MessageBird API Key?** Log in to your [**MessageBird Dashboard**](https://dashboard.messagebird.com/), navigate to **Developers** > **API Access**, and you will find your Access Key there. Copy and paste it into the field below. **Can the agent check my current credit balance?** Yes. Use the `get_balance` tool. Your agent will retrieve your current account balance and payment type (prepaid/postpaid) instantly. **Is it possible to send SMS to multiple recipients at once?** Yes. The `send_sms` tool accepts a comma-separated list of recipient numbers. Your agent will deliver the message to all recipients and provide the overall delivery status.