Send SMS using an Infobip MCP server and an AI client

View as Markdown

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. If you do not have one, you can create a free trial account.
If using API key authorization, an Infobip API key with the sms:message:send scope. Find out more about API keys and scopes. Skip this step for OAuth.
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 or using Infobip Numbers API.
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.

REQUEST SAMPLES

json

2 "mcpServers": {

3 "infobip-sms": {

4 "command": "npx",

5 "args": [

6 "mcp-remote",

7 "https://mcp.infobip.com/sms",

8 "--header",

9 "Authorization: App ${INFOBIP_API_KEY}"

10 ],

11 "env": {

12 "INFOBIP_API_KEY": "<Your Infobip API Key here>"

13 }

14 }

15 }

16}

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

sms/1/preview

bash

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

Send

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

sms/3/messages

bash

2 `options`: {

3 `includeSmsCountInResponse`: true

4 },

5 `messages`: [

6 {

7 `sender`: `447491163443`,

8 `content`: {

9 `text`: `BLACK FRIDAY: 70% OFF! Code: BF70. Shop now - ends midnight!`

10 },

11 `options`: {

12 `schedule`: {

13 `sendAt`: `2025-07-08T09:00:00.000Z`

14 }

15 },

16 `destinations`: [

17 {

18 `to`: `447415774332`,

19 `messageId`: `bf-promo-003`

20 }

21 ]

22 }

23 ]

24}

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

1Summary

2✅ SMS Successfully Drafted and Scheduled

3Message Details:

5Text: "BLACK FRIDAY: 70% OFF! Code: BF70. Shop now - ends midnight!"

6From: 447491163443

7To: 447415774432

8Scheduled for: July 8, 2025 at 9:00 AM UTC

9SMS Count: 1 (exactly as requested)

10Message ID: bf-promo-003

11Bulk ID: 17518887889834335869795

12Status: PENDING_ACCEPTED

14Analytics 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 an Infobip MCP server.