# Send RCS using an Infobip MCP server and an AI client

This tutorial will show you how to send an RCS message using AI prompts. We use Claude Desktop but you can use any AI client that supports an MCP integration.

## Prerequisites

1. [Infobip account](https://portal.infobip.com/login/?callback=https%3A%2F%2Fportal.infobip.com%2F). If you do not have one, create a [free trial account](https://www.infobip.com/signup).
2. If using **API key authorization**, an Infobip API key with the `rcs:message:send` scope. Find out more about [API keys and scopes](https://www.infobip.com/docs/essentials/api-essentials/api-authorization). **Skip this step for OAuth.**
3. An AI client (e.g., Claude Desktop) with the capability to integrate an Infobip RCS MCP server. For details, see the [MCP integration guide](https://www.infobip.com/docs/tutorials/integrate-infobip-mcp-server-with-mcp-client).
4. **RCS Sender**. Request it through your [Infobip account](https://portal.infobip.com/channels-and-numbers/my-requests/request-channel) or use the [Create RCS Sender](https://www.infobip.com/docs/api/channels/rcs/rcs-service-management/rcs-sender-management/create-rcs-sender) endpoint.
5. **RCS Destination** - a phone number to which the message will be sent. When testing, make sure that the device has the RCS option enabled in its messaging settings.

## Integrate the Infobip RCS MCP server with your AI client

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

```json
{
  "mcpServers": {
    "infobip-rcs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.infobip.com/rcs",
        "--header",
        "Authorization: App ${INFOBIP_API_KEY}"
      ],
      "env": {
        "INFOBIP_API_KEY": "<your api here infobip key>"
      }
    }
  }
}
```

```json
{
  "mcpServers": {
    "infobip-rcs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.infobip.com/rcs"
      ]
    }
  }
}
```

Once you restart your AI client, you should see the Infobip RCS MCP server on the list of available tools.
For more integration details, see the [MCP integration guide](https://www.infobip.com/docs/tutorials/integrate-infobip-mcp-server-with-mcp-client).

## Send an RCS message

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

Key points about the prompt:

- Specify the sender and destination(s).
- Specify additional features you wish to include, e.g. buttons, media sending and managing, tracking, scheduling, etc. The more details you provide the better context AI will have to create the correct API request. Check out [RCS](https://www.infobip.com/docs/api/channels/rcs/rcs-outbound-messages/send-rcs-messages) API reference.
- Describe your use case so that the AI can craft an adequate message.
- Include limitations (e.g., one message, specific delivery window) and personalized details (e.g., specific URL, image, etc.); otherwise, the AI will use made-up details to fill in the gaps.

```curl
send a card message from DemoSender to 447415774332.
1. the message should briefly introduce Infobip RCS solution and its capabilities.
2. the message should use this img: __ and some title and description. Orientation should be HORIZONTAL and and alignment LEFT
3. the message should include a url to: __https://www.infobip.com/rcs__ for the reader to find out more about RCS. The URL should open in the webview window taking half of the mobile screen.
```

The AI will create a request that you can then review and change if need be. Once you approve the message, the AI will send it.

```bash
{
  "messages": [
    {
      "sender": "DemoSender",
      "content": {
        "type": "CARD",
        "content": {
          "media": {
            "file": {
              "url": "https://i.postimg.cc/QdpVWNsd/Infobip-Demo.png"
            },
            "height": "MEDIUM"
          },
          "title": "Discover Infobip RCS",
          "description": "Transform your customer communications with Rich Communication Services. Send interactive messages with rich media, suggested actions, and verified business branding to create engaging mobile experiences.",
          "suggestions": [
            {
              "url": "https://www.infobip.com/rcs",
              "text": "Learn More",
              "type": "OPEN_URL",
              "application": "WEBVIEW",
              "postbackData": "RCS_LEARN_MORE",
              "webviewViewMode": "HALF"
            }
          ]
        },
        "alignment": "LEFT",
        "orientation": "HORIZONTAL"
      },
      "destinations": [
        {
          "to": "447415774432"
        }
      ]
    }
  ]
}
```

```bash
{
 "bulkId": "17528356386858989599978",
 "messages": [
   {
     "messageId": "17528356386858989599979",
     "status": {
       "groupId": 1,
       "groupName": "PENDING",
       "id": 26,
       "name": "PENDING_ACCEPTED",
       "description": "Message sent to next instance"
     },
     "destination": "447415774332"
   }
 ]
}
```

### Report status

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

```curl
Perfect! Your RCS card message has been successfully sent. Here are the details:
Message Status: ✅ Accepted and queued for delivery

Message ID: 17639864224703538899059
Bulk ID: 17639864224703538899058
Destination: 447415774332
Sender: DemoSender

Message Content:

Title: "Discover Infobip RCS"
Description: Brief introduction to RCS capabilities and benefits
Image: Your specified demo image with horizontal orientation and left alignment
Interactive Button: "Learn More" button that opens the RCS page in a half-screen webview

The message is now in the delivery queue and should reach the recipient shortly. The card format will provide an engaging introduction to Infobip's RCS solution with the rich media and interactive elements you requested.
Would you like me to check the delivery status or send any additional messages?
```

That's it! You have successfully sent an RCS using AI and an Infobip MCP server.

## Useful links

- [Infobip MCP docs](https://www.infobip.com/mcp/)
- <apidocslink href="channels/rcs">RCS API reference</apidocslink>
- [Response status and error codes](https://www.infobip.com/docs/essentials/api-essentials/response-status-and-error-codes)