Sinch Community

Shahzad_Ismail

To expose the MCP server as an SSE endpoint, follow the steps below.

If you want to use the MCP server in hosted environments, you need to access it via a publicly accessible URL. To do this, you need to expose the MCP server as an SSE endpoint, then use a reverse proxy such as NGROK to expose this SSE endpoint via a public URL.

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/mcp
npm install
npm run build

Copy the following lines at <your_project_root>/packages/mcp/.env and replace the values with your own credentials. If .env file is not available, create it:

CONVERSATION_PROJECT_ID=YOUR_PROJECT_ID
CONVERSATION_KEY_ID=YOUR_ACCESS_KEY_ID
CONVERSATION_KEY_SECRET=YOUR_ACCESS_KEY_SECRET
CONVERSATION_REGION=YOUR_REGION // Optional, defaults to "us"
DEFAULT_SMS_ORIGINATOR=YOUR_SINCH_PHONE_NUMBER  // Needed only if you want to send SMS messages: it is the number that will be used as the sender for SMS messages
GEOCODING_API_KEY=YOUR_GOOGLE_GEOCODING_API_KEY // Needed only if you want to send location messages: it converts an address to a lat/lon
# Verification tools related environment variables
VERIFICATION_APPLICATION_KEY=YOUR_APP_KEY
VERIFICATION_APPLICATION_SECRET=YOUR_APP_SECRET
# Voice tools related environment variables
VOICE_APPLICATION_KEY=YOUR_APP_KEY              // Can be the same value as VERIFICATION_APPLICATION_KEY
VOICE_APPLICATION_SECRET=YOUR_APP_SECRET        // Can be the same value as VERIFICATION_APPLICATION_SECRET
CALLING_LINE_IDENTIFICATION=YOUR_CALLING_NUMBER // Needed only to make calls: it is the number that will be displayed to the user when they receive a call
# Mailgun tools related environment variables
MAILGUN_DOMAIN=YOUR_MAILGUN_DOMAIN
MAILGUN_API_KEY=YOUR_MAILGUN_API_KEY
MAILGUN_SENDER_ADDRESS=YOUR_MAILGUN_SENDER_ADDRESS

Expose the MCP server as an SSE endpoint. By default, this would be using port 8000.

cd sinch-mcp-server/mcp
npm run start

Sign up for a reverse proxy like NGROK. Open the and point it to the server running on port 8000. Copy the 'Forwarding' URL from NGROK:

ngrok http 8000

Edit the claude_desktop_config.json file with the following script. Paste the NGROK URL that you copied in the previous step, add /sse at the end. Save the file.

{
  "mcpServers": {
    "sinch": {
      "command": "npx",
      "args": [
        "-y", "supergateway", "--sse", "https://<guid>.ngrok-free.app
/sse"
      ]
    }
  }
}

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.

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!

Sinch Community

Exposing the MCP server as an SSE endpoint

What's next