cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

To clone the Sinch MCP toolkit repository and run it locally, take the following steps:
 
  1. 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

 

  1. Navigate to the mcp directory and build the MCP server:

    cd sinch-mcp-server
    npm install
    npm run build
     
  2. 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.
  1. 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.

    Shahzad_Ismail_1-1749722978528.png

 

(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!

Featured Article
Version history
Last update:
‎06-19-2025 07:38 AM
Updated by: