Tutorials
Build a no-code SMS agent with Microsoft Azure AI Foundry and Infobip
Build a no-code SMS agent with Microsoft Azure AI Foundry and Infobip

Build a no-code SMS agent with Microsoft Azure AI Foundry and Infobip

Copy as markdown

|

View as Markdown

As an outcome of this guide, you will have a working AI agent inside Microsoft Azure AI Foundry that can send SMS messages on demand through the Infobip SMS MCP server.

Scenario overview

MCP servers (opens in a new tab) let AI agents call external services as tools. Microsoft Azure AI Foundry can connect to the Infobip SMS MCP server directly from its Tools catalog to make it available to any agent you build in the platform.

In this guide, you will build an agent called sms-communicator that accepts natural-language requests, fetches live data, and sends the results in an SMS message.

Foundry supports two ways to authenticate the MCP server connection, API key and OAuth. This guide covers both, so you can choose the right one for your use case.

Choose your authentication method

Foundry supports two authentication methods for MCP server connections. Read the comparison below and pick one before starting.

OAuth Identity PassthroughAPI key
How it worksEach user signs in to their own Infobip account via a browser popup on first use.A single Infobip API key is stored in Foundry and used for all requests.
Setup effortN/ARequires creating a scoped API key in the Infobip account.
Best forAgents used by individual users who each have their own Infobip account.Shared or automated agents where one service account sends on behalf of everyone.
Credential managementNone. Microsoft manages the OAuth app.You own the key lifecycle (rotation, expiry, revocation).
Runtime promptSign-in popup on first use per session.No prompt. Seamless for the end user.

Prerequisites

Difficulty level

Beginner. No programming knowledge required. You should be comfortable navigating web-based admin portals.

Summary of the steps

  • Create an agent in Azure AI Foundry and configure its model and instructions.
  • API key only: Generate a scoped Infobip API key in the Infobip account.
  • Connect the Infobip SMS MCP server using your chosen authentication method.
  • Add Bing Web Search to the agent for live data lookups.
  • Test the agent by requesting an SMS.
  • Verify the SMS is delivered to the destination phone number.

Step 1. Create the agent

  1. Go to ai.azure.com (opens in a new tab) and open your Foundry project.
  2. In the left navigation, select Agents.
  3. Select Create agent.
  4. Enter sms-communicator as the agent name and select Create.
Create an agent dialog with the agent name field

Once the agent is created, the agent playground opens up.

Step 2. Configure the agent

Do the following steps in the sms-communicator playground.

Agent playground showing the sms-communicator agent with the model and instructions configured

Set up the model

Select a deployed model for your project. gpt-4o-mini is a good default for this use case.

Write the system instructions

In the Instructions field, enter:

You are an expert communicator. You use Infobip's MCP server to send SMS text messages to user's phones. You are using InfoSMS sender for those SMS messages.
NOTE

The InfoSMS sender name used in this guide is a shared sender you can use for testing. For live traffic, check your Infobip account for available senders to purchase.

You will add tools in the steps below.

Step 3. Connect the Infobip SMS MCP server

The connection steps differ depending on the authentication method you chose. Follow the tab that matches your choice.

Step 4. Add Bing Web Search

Adding Bing Web Search lets the agent fetch live data, such as weather forecasts, before composing an SMS.

  1. In the Tools section of your agent's playground, expand the Add menu button and enable Web search.
  2. Select Search the web with Bing Search and select Add. The agent now has two tools: Infobip SMS MCP server and Bing Web Search.
  3. Save your progress.

Step 5. Test the agent

  1. From within your agent's playground, select Preview to open the agent chat interface.

  2. Type a prompt that includes a destination phone number, for example:

    What's the weather going to be like in Redmond tomorrow? Send it to my phone on number 13859993791711
  3. The agent will search the web for weather data, then display the SMS API call for review. For OAuth only, the first call in each session triggers an Infobip sign-in popup. Enter your Infobip credentials and select SIGN IN.

    Infobip OAuth sign-in popup with username and password fields
  4. Review the payload and select Approve.

    Agent showing the pending Infobip SMS MCP server tool call with weather payload and Approve/Deny buttons
Tool call approval in production

In the agent playground, each tool call requires manual approval. When deploying the agent via the Foundry API or embedding it in an application, you can configure automatic approval for trusted tools.

Track message delivery

After approval, the SMS is sent immediately. Check the destination phone. The message should arrive within seconds.

SMS received on the destination phone showing the Redmond weather forecast

To monitor delivery programmatically, use the Infobip Delivery Reports API. See SMS API reference (opens in a new tab) for details on querying delivery status by messageId or bulkId.

You can also view sent messages and delivery status in the Infobip account (opens in a new tab).

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary
Service status

Copyright @ 2006-2026 Infobip ltd.

Service Terms & ConditionsPrivacy policyTerms of use