Integrate a remote MCP server with an MCP Client
MCP is an open protocol that standardizes how applications provide context to AI models. The Infobip MCP server allows LLMs to use Infobip CPaaS Platform tools.
As an outcome of this guide, you will have an Infobip MCP server connected to an MCP client and be able to use Infobip APIs through an AI assistant. The steps use Cursor as an example, but the same approach applies to any MCP-compatible client.
If you use Claude Desktop, see the separate Claude Desktop integration tutorial.
Prerequisites [#prerequisites]
- Node.js 18 or later.
- Infobip account. If you do not have one, create a free trial account.
- An MCP-compatible client, such as Cursor.
Connect Cursor to the Infobip MCP server [#cursor-mcp-integration-steps]
- Open Cursor and navigate to Cursor Settings.
- On the left-hand side, click MCP.
- Click +Add new global MCP server.
- Populate the
mcp.jsonfile with the Infobip MCP server settings (see Infobip MCP Server settings below). - Confirm the MCP server is enabled and the list of tools appears.
- Open the chat and prompt the AI to use an Infobip tool, for example, ask it to send an SMS.
Infobip MCP Server settings [#infobip-mcp-server-settings]
Each Infobip API endpoint is served as a separate MCP server to narrow down the context for the AI agent in use. Add each endpoint as a separate server.
To configure an MCP server:
-
Choose an authentication method, OAuth or API Key, and which server you want to connect to. For the list of all supported MCP endpoints, check out the Infobip MCP documentation.
Integration example with OAuth
Key points:
- Your MCP client must support OAuth 2.1 authentication and dynamic OAuth authorization server metadata discovery.
- For MCP clients that don't support automatic
scopes_supporteddiscovery, you must manually configure scopes available to view:{mcp-server-url}/.well-known/oauth-authorization-server
REQUEST SAMPLESjson1{2 "mcpServers": {3 "infobip-sms": {4 "command": "npx",5 "args": [6 "https://mcp.infobip.com/sms"7 ]8 }9 }10}json1{2 "mcpServers": {3 "infobip-sms": {4 "command": "npx",5 "args": [6 "mcp-remote",7 "https://mcp.infobip.com/sms",8 "--debug",9 "--static-oauth-client-metadata",10 "{\"scope\":\"sms:manage profile\"}"11 ]12 }13 }14}Integration example with an API key
Key points:
- You can access and edit your API key from your Infobip account.
- Your API key must include the correct scope depending on the MCP server you want to integrate. For example, if you want to use the
SMS MCP server, your API Key needs thesms:message:sendscope. Find out more about scopes in API Authorization.
json1{2 "mcpServers": {3 "ib-viber": {4 "command": "npx",5 "args": [6 "https://mcp.infobip.com/viber",7 "--header",8 "Authorization: App ${INFOBIP_API_KEY}"9 ],10 "env": {11 "INFOBIP_API_KEY": "<Your Infobip API Key here>"12 }13 }14 }15} -
Restart your MCP client.