Cloning the Sinch MCP toolkit repository and running it locally

Shahzad_Ismail — Thu, 19 Jun 2025 14:38:38 GMT

To clone the Sinch MCP toolkit repository and run it locally, take the following steps:

Go to https://github.com/sinch/sinch-mcp-server/blob/main/README.md, go over the pre-requisites such as node.js version greater than 19, npm version greater than 9. Clone the Sinch MCP toolkit repository:
```
git clone https://github.com/sinch/sinch-mcp-server.git
```

Navigate to the mcp directory and build the MCP server:
```
cd sinch-mcp-server
npm install
npm run build
```

Edit the claude_desktop_config.json file with the following script. Replace the "dummy text" with the actual keys and values:

{
  "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": ""
      }
    }
  }
}

Save the file.

If Claude desktop is open, close it, and restart it. It will now use the latest config file. Create a new chat, click on the 'Search and Tools' icon next to the + icon and you should see the tools from Sinch listed. 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.

(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 using the tags options. For example, if you want to only use the conversation tools, you can add the following options to the args array:

      "args": [
        "/your/path/to/sinch-mcp-server/mcp/dist/index.js",
        "--tags", 
        "conversation"
      ],

You can combine multiple tags by separating them with commas. For example, if you want to use both conversation and verification tools, you can use the following command:

      "args": [
        "/your/path/to/sinch-mcp-server/mcp/dist/index.js",
        "--tags", 
        "conversation,verification"
      ],

If you want to use all the tools, you can omit the --tags option, or use the tag all:

      "args": [
        "/your/path/to/sinch-mcp-server/mcp/dist/index.js",
        "--tags", 
        "all"
      ],

What's next

Hope that helped you set up the Sinch MCP server - please give it a whirl.

If you have any questions or feedback, please share them in our Developer Forum.

We plan to release more updates about the Sinch MCP server and how we participate in the Agentic AI experience, stay tuned!

article Cloning the Sinch MCP toolkit repository and running it locally in Sinch MCP Server - Developer Preview

Cloning the Sinch MCP toolkit repository and running it locally

(Optional) Filter the tools available in the MCP server

What's next