Send SMS using an Infobip MCP server and an AI client

This tutorial will show you how to send an SMS message using AI prompts. In this example, we use Claude Desktop but you can use any AI client that supports MCP integrations.

Prerequisites

Infobip account (opens in a new tab). If you do not have one, you can create a free trial account (opens in a new tab).
Infobip API key with the sms:message:send scope. Find out more about API keys and scopes.
An AI client (e.g., Claude Desktop) with the Infobip SMS MCP server. For integration details, see the MCP integration guide.
Sender. If in free trial, the Infobip test sender, ServiceSMS. If you want to configure your custom sender, request a new number or an alphanumeric sender through the Infobip account (opens in a new tab) or using Infobip Numbers API (opens in a new tab).
Destination - a phone number to which the message will be sent. If in free trial, you can only send messages to a verified phone number.

Integrate the Infobip SMS MCP server with your AI client

Navigate to your AI client's MCP settings and add the Infobip SMS MCP server.

json

    {
        "mcpServers": {
            "ib-sms": {
                "command": "uvx",
                "args": [
                    "mcp-proxy",
                    "https://mcp.infobip.com/sms/sse"
                ],
                "env": {
                    "API_ACCESS_TOKEN": "<Your Infobip API Key here>"
                }
            }
        }
    }

Once you restart your AI client, you should see the Infobip SMS MCP server on the list of available tools. For more integration details, see the MCP integration guide.

Use an AI prompt to send an SMS message

In your AI client, write a prompt to send an SMS message.

Key points:

Specify the sender and destination(s).
Specify additional features you wish to include, e.g. URL shortening, tracking, scheduling etc. Check out SMS API reference (opens in a new tab) for more details.
Describe your use case so that the AI can craft an adequate message.
Include limitations (e.g., one SMS) and personalized details (e.g., URL); otherwise, the AI will use made up details to fill in the gaps.

AI prompt

Draft and send a Black Friday SMS to 447415774332 from this sender: 447491163443 and schedule it for tomorrow. Limit the message to one SMS only. Retrieve analytics afterward.

SMS prompt process workflow

This workflow outlines the step-by-step process AI uses for sending an SMS message with the Infobip SMS MCP server enabled. This is to help you determine how to best work with this tool.

Preview

Once you send the prompt. The AI will send you a preview of the SMS using the sms/1/preview (opens in a new tab) endpoint.

sms/1/preview

{
  `text`: `BLACK FRIDAY: 25% OFF! Shop: https://yourstore.com/bf Code: BF25 Reply STOP to opt out`
}

{"originalText": "BLACK FRIDAY: 25% OFF! Shop: https://yourstore.com/bf Code: BF25 Reply STOP to opt out", "previews": [{"textPreview": "BLACK FRIDAY: 25% OFF! Shop: https://yourstore.com/bf Code: BF25 Reply STOP to opt out", "messageCount": 1, "charactersRemaining": 74, "configuration": {}}]}

Send

Once preview's approved, the AI will send the SMS and apply requested features, e.g., schedule.

sms/3/messages

{
  `options`: {
    `includeSmsCountInResponse`: true
  },
  `messages`: [
    {
      `sender`: `447491163443`,
      `content`: {
        `text`: `BLACK FRIDAY: 70% OFF! Code: BF70. Shop now - ends midnight!`
      },
      `options`: {
        `schedule`: {
          `sendAt`: `2025-07-08T09:00:00.000Z`
        }
      },
      `destinations`: [
        {
          `to`: `447415774332`,
          `messageId`: `bf-promo-003`
        }
      ]
    }
  ]
}

{"bulkId": "17518887889834335869795", "messages": [{"messageId": "bf-promo-003", "status": {"groupId": 1, "groupName": "PENDING", "id": 26, "name": "PENDING_ACCEPTED", "description": "Message sent to next instance"}, "destination": "447415774432", "details": {"messageCount": 1}}]}

Report status

Once the AI sends the SMS, it will return a summary of what it did and if prompted will retrieve a delivery report, when available.

AI response

Summary
✅ SMS Successfully Drafted and Scheduled
Message Details:

Text: "BLACK FRIDAY: 70% OFF! Code: BF70. Shop now - ends midnight!"
From: 447491163443
To: 447415774432
Scheduled for: July 8, 2025 at 9:00 AM UTC
SMS Count: 1 (exactly as requested)
Message ID: bf-promo-003
Bulk ID: 17518887889834335869795
Status: PENDING_ACCEPTED

Analytics Note: Since the message is scheduled for tomorrow and hasn't been sent yet, delivery reports and logs aren't available. Analytics will be available after the message is actually sent tomorrow. You can retrieve them using the bulk ID 17518887889834335869795 after 9:00 AM UTC on July 8, 2025.

That's it! You have successfully sent an SMS message using AI and Infobip MPC server.