Sinch MCP Server

Sinch MCP Server is your central communications hub integrating email, voice, verification and major messaging channels (SMS, MMS, RCS, WhatsApp, FB Messenger, Instagram, Viber, Telegram, KakaoTalk, LINE, WeChat and Sinch Chat).

Setup and configure your account

1. Sinch account - You can sign up for a free Sinch account on the Sinch Build Dashboard.

2. Onboard Sinch services – Setup the Sinch service that you want to test. To get started quickly the recommended path-to-quick-success is to start with SMS channel on Conversation API:

3. 1. A free virtual number is created for each trial account. To view your free number, navigate to the Numbers section and select the Your Virtual Numbers option. If your free virtual number is not displayed, click the Activate button to activate your free number, which you can use to send test messages. This test Sender Number will be your DEFAULT_SMS_ORIGINATOR (E.g. +14252345678), meaning the SMS message will originate from this number. Note: During the trial, you can only send SMS to the mobile number with which you signed up.
4. 2. Navigate to the Messaging section, Conversation API, then Getting Started. Click the check box to agree to the terms and conditions and click Get Access. Create the Conversation API app. Ensure the region for your Conversation API app is set to US. This is the value for CONVERSATION_REGION.
5. 3. Next step is to set up your channels. Find the SMS channel in the list and click Setup Channel link. Use the drop down to select the Service Plan ID that has been automatically created. Click Save to save your configuration. It will take a few moments to activate this channel.
6. 4. Next, let's get the value for CONVERSATION_PROJECT_ID. Go to https://dashboard.sinch.com/settings/project-settings and make a note of the Project ID.
7. 4. Next, you need to note down the values for CONVERSATION_KEY_ID, CONVERSATION_KEY_SECRET. Go to https://dashboard.sinch.com/settings/access-keys, click the Create access key button and create a key and secret. The secret will be displayed just once. You can use an existing key and secret if you choose.

Sinch MCP server supports many additional services, such as RCS, WhatsApp, Voice, Email and many more. Refer to the Onboarding Sinch Services article to learn how you can set these up later.

The MCP server can be used with any MCP client.

{
  "mcpServers": {
    "sinch": {
      "command": "node",
      "args": [
        "/your/path/to/sinch-mcp-server/mcp/dist/index.js"
      ],
      "env": {
        "CONVERSATION_PROJECT_ID": "",
        "CONVERSATION_KEY_ID": "",
        "CONVERSATION_KEY_SECRET": "",
        "CONVERSATION_APP_ID": "",
        "CONVERSATION_REGION": "",
        "DEFAULT_SMS_ORIGINATOR": "",
        "GEOCODING_API_KEY": "",
        "VERIFICATION_APPLICATION_KEY": "",
        "VERIFICATION_APPLICATION_SECRET": "",
        "VOICE_APPLICATION_KEY": "",
        "VOICE_APPLICATION_SECRET": "",
        "CALLING_LINE_IDENTIFICATION": "",
        "MAILGUN_API_KEY": "",
        "MAILGUN_DOMAIN": "",
        "MAILGUN_SENDER_ADDRESS": ""
      }
    }
  }
}

Note: If you want to run a quick test of the MCP Server using the SMS channel via Conversation API then you only need to add the following keys: CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, CONVERSATION_KEY_SECRET, CONVERSATION_REGION, DEFAULT_SMS_ORIGINATOR. You can leave the other settings with their default values and come back to complete these later.

Now you can use search queries like "list all my apps" or "lookup my number" or "send SMS" and those queries will start using the Sinch tools. Refer to the Sinch MCP Server Tools article for full details of the tools available in the Sinch MCP Server.

Note: The 'Free test number' that comes with the Sinch trial account, the "send SMS" tool can only send SMS to the mobile number you signed up with; the MCP server will have the same compliance restrictions as the underlying Sinch services. Once you sign up for a non-test 'virtual number' for production use, you can start sending messages to other mobile numbers, still respecting regional compliance rules.

There are a few other options to connect to the MCP Server:

• Cloning the Sinch MCP toolkit repository and running it locally
• Exposing the MCP server as an SSE endpoint.