Sinch Engage MCP Server

This repository contains the source code for the Sinch Engage (Sinch MessageMedia in AU) MCP server, which provides Sinch Engage APIs as MCP tools.

Tools Overview

Here is the list of tools available in the MCP server (all the phone numbers must be provided in E.164 format, e.g., `+61400000000` for Australia).

Messaging

Reporting

Contacts

Getting Started

Prerequisites

• Node.js >= 16.0
• A provisioned Sinch Engage account
• Claude Desktop (or any other MCP client). This README is focused on Claude Desktop, but the MCP server can be used with any MCP client.

API credentials

To use the APIs used by the MCP tools, you will need the following credentials:

• `SINCH_ENGAGE_API_KEY` and `SINCH_ENGAGE_API_SECRET` Sinch Engage Credentials

MCP Server Configuration

The Sinch Engage MCP server is available as an NPM package to the executed. Here is how to set it up in the Claude Desktop configuration file (`claude_desktop_config.json`). Remember to fill in the environment variables with your own credentials and the region (currently supported `EU` & `AU`):

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "npx",
      "args": [
        "-y",
        "@sinch-engage/mcp-server"
      ],
      "env": {
        "SINCH_ENGAGE_API_KEY": "",
        "SINCH_ENGAGE_API_SECRET": "",
        "SINCH_ENGAGE_REGION": "",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

Running the MCP Server locally

Option 1: Start the MCP server with stdio using Claude Desktop

To run the MCP server locally with Claude Desktop, you will need to clone the repository and build the MCP server. This option is useful for local development and testing.

Step 1: Clone the repository

git clone https://github.com/messagemedia/sinch-engage-mcp-server.git

Step 2: Install dependencies

cd sinch-engage-mcp-server
npm install

Step 3: Setup Claude Desktop configuration

Here is an example of how to configure the MCP server in the Claude Desktop configuration file (`claude_desktop_config.json`) where you can provide your Sinch Engage credentials and region (`EU` or `AU`):

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "node",
      "args": ["/path/to/sinch-engage-mcp-server/src/index.js"],
      "env": {
        "SINCH_ENGAGE_API_KEY": "",
        "SINCH_ENGAGE_API_SECRET": "",
        "SINCH_ENGAGE_REGION": "",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

Step 4: (Optional) Filter the tools available in the MCP server

Too many tools mean bigger context, mean higher tokens usage and more confusion for the LLM to select the right tool to use.

You can filter the tools that are available in the MCP server by providing `MCP_TOOL_CATEGORIES` in Claude Desktop configuration options.

If you want to filter tool by permissions, you can use `MCP_TOOL_MODES` to only choose tools that can either read, write or delete data or any combination of them