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

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

Integrate the Infobip SMS MCP server with your AI client

To integrate the server, you’ll need the following:

  • Python version 3.13 and up
  • uvx

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

    {
        "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.

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 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.
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 endpoint.

Request

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

Response
{"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 the preview is approved, the AI will send the SMS and apply requested features, e.g., schedule.

Request

{
  `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`
        }
      ]
    }
  ]
}

Response
{"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.

```
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.