Sinch Community

Existing alphanumeric Sender IDs cannot be updated or changed.   If you need to make a change then you will need to register a new alphanumeric Sender ID. ... View more

There are several reasons Automatic Recharge (auto-recharge) may fail to activate:   Negative balance: If the account enters a negative balance, only an autoblock notification is sent. The customer must top up manually in this case – refer to Adding credit to your account article. Pending transaction: If a pending transaction exists, it must be completed or updated before auto-recharge can be triggered. Failed or rejected payment: If an auto top-up attempt fails or is rejected, the auto top-up function is deactivated. Manual payment review: If the account requires a manual review before applying a payment, auto-recharge will not proceed.   Solution: Ensure the low balance warning amount is appropriately configured. Consider adding multiple low balance thresholds to improve usage monitoring and proactive account balance management. Verify that the auto-recharge amount is sufficient to cover expected usage. If a pending transaction or failed payment is preventing auto-recharge, contact the Online Support team. Once the issue is resolved, reactivate the auto-recharge prompt as required.   Related Content: How do I enable Automatic Recharge on my account? Why is Automatic Recharge not working? ... View more

If you are experiencing issues with the Automatic Recharge (or auto top up) not working, please review the following guidelines:   Ensure the account has a sufficient available balance. Review the average daily spend to confirm the credit threshold is adequate. Verify that no transactions are currently pending. Confirm that the low credit notification threshold is set high enough to allow for timely top-up before traffic is sent.   Solution: Adjust the low credit notification amount if necessary. If the issue persists, please contact the Online Support team for assistance.   Important Note: If the account runs out of credit, a low balance notification will not be triggered. Instead, an autoblock notification is sent, and a manual top-up is required to resume service.   Related Content: How do I enable Automatic Recharge on my account? Why wasn’t the Automatic Recharge activated? ... View more

The Sinch MCP server enables customers who build Agentic experiences to easily use Sinch services for communication.  The Sinch MCP Server provides AI Assistants such as Claude or code builder such as Cursor or agent builders such as Google, with easy access to various Sinch services including Messaging, Voice, Email and many more.   To get started and to try out the Sinch MCP Server, follow the step by step instructions in our developer blog: Using the Sinch MCP Server. ... View more

Sinch offers communication services that help businesses connect with their customers, on the communication channels of their choice. The Sinch MCP Server makes a number of these services available through a series of tools. Refer to the Sinch MCP Server Tools article for full details of the tools available in the Sinch MCP Server.   This article guides you on how to configure the various Sinch services:   Conversation API   Send and receive messages globally over RCS, WhatsApp, Viber Business, Facebook Messenger and other popular messaging channels.   Take the following steps to setup Conversation API:   Follow steps 1 to 3 of the Conversation API Getting Started guide, and configure the channels of your choice (such as WhatsApp, or Facebook Messenger). Note down your Sinch IDs and Credentials.  Note: If you already have your Conversation API credentials from a previous step, then you can use these same credentials and you can ignore the steps below. CONVERSATION_PROJECT_ID - Go to https://dashboard.sinch.com/settings/project-settings and copy the Project ID 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.   Voice API   Make and receive voice calls.   Take the following steps to setup Voice API:   Follow steps 1 and 2 of the Voice API Getting Started guide. Navigate to the Voice / Apps section of the Sinch Build dashboard and create a new app or select an existing one. You will need to note down the following credentials, from the Your summary section: VOICE_APPLICATION_KEY VOICE_APPLICATION_SECRET.   Verification API   Verify users with SMS, voice, flash-calls, and data.   Take the following steps to setup Verification API:   Try out the verification service to send a message to the number you signed up with. Note down your Sinch IDs and Credentials: VERFICATION_APPLICATION_KEY, VERIFICATION_APPLICATION_SECRET - Go to https://dashboard.sinch.com/verification/apps, go to the app you are using, and copy the key and secret values.   Email Sign in to the Sinch Build Dashboard.  Click on the app switcher, click Mailgun and follow the instructions to add Email capability to your account: Create a Mailgun account if you do not already have one. Follow the instructions and as part of the Mailgun onboarding process you will create a MAILGUN_API_KEY.  To setup a domain, refer to the Domain Verification Setup Guide. ... View more

Here is the list of tools available in the MCP server (all the phone numbers must be provided in E.164 format, e.g., +33612345678 for France).   Conversation Tools   Tool Description Tags send-text-message Send a plain text message to a recipient on a supported channel. Example prompt: "Send a quick update to the phone number +33612345678 on SMS." conversation, notification send-media-message Send an image, video, or document via a media message. Example prompt: "Send the product brochure PDF to the phone number +33612345678 on WhatsApp." conversation, notification send-template-message Send a message using a predefined template (e.g., WhatsApp or omni-template). Example prompt: "Send the appointment reminder template in Spanish to this user on Messenger." conversation, notification send-choice-message Send a message that includes interactive choices (buttons or quick replies). Example prompt: "Send a RCS survey about preferred ice cream flavor to +33662162504 with the following choices: Vanilla, Strawberry, Hazelnut". conversation, notification send-location-message Send a location pin or coordinates to a user. Example prompt: "Send a pin to the Guggenheim Museum location in Bilbao to the phone number +33612345678." conversation, notification list-all-apps List all configured Conversation apps in the Sinch account. Example prompt: "What messaging apps do I have set up in my account?" conversation, notification list-messaging-templates List all omni-channel and channel-specific message templates. Example prompt: "Show me all message templates in my account." conversation, notification     Email tools (Mailgun)   Tool Description Tags send-email Send an email using a predefined HTML template or raw HTML/text content. Example prompt: "Send a welcome email to john@example.com using our onboarding template." email, notification list-email-templates List all email templates available for a specific domain. Example prompt: "What email templates do I have available?" email, notification retrieve-email-info Retrieve metadata, content and delivery status for a specific email message. Example prompt: "Can you get the delivery status of the email with ID ?" email, notification list-email-events Retrieve and group recent email delivery events, such as bounces, opens, or clicks. Example prompt: "Show me all recent email activity for my account." email analytics-metrics Retrieve email analytics metrics, such as open rates or click-through rates. Example prompt: "What are the open rates during the last week?" email     Verification Tools   Tool Description Tags number-lookup Lookup a phone number for its status and capabilities. Example prompt: "Lookup for the following phone number capabilities: +33501020304." verification start-sms-verification Initiate an SMS verification by sending an OTP to a user's phone number. Example prompt: "Start phone verification for the number +33612345678." verification report-sms-verification Submit a one-time password (OTP) to complete SMS verification. Example prompt: "Verify the phone number with this code: 1234." verification     Voice Tools   Tool Description Tags tts-callout Place a voice call and read aloud a message using Text-to-Speech. Example prompt: "Call the phone number +33612345678 and say: 'Your appointment is tomorrow at 10 AM.'" voice, notification conference-call Start a voice call to one or more participants and connect them to a shared conference. Example prompt: "Call John (+33612345678) and Lisa (+34987654321) and connect them to a conference room." voice manage-conference-participant Mute, unmute, hold, or resume an individual participant in a conference call. Example prompt: "Mute the caller with ID xyz789 in the conference." voice close-conference End a conference call by disconnecting all the participants using the ID of the conference. Example prompt: "End the current conference call with ID abc123." voice     Configuration Tools   Tool Description Tags sinch-mcp-configuration List all available tools in the Sinch MCP server and their status. If a tool is disabled, it will display the reason why. Example prompt: "Which tools are available in the Sinch MCP server?"     ... View more

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! ... View more

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.    You can then run the MCP server on a remote machine and connect to it using Server-Sent Events (SSE). This is useful if you want to run the MCP server on a cloud server or a dedicated machine. By default, Claude Desktop will connect to the MCP server using STDIO; we will use the supergateway library to connect to the MCP server using SSE.   To expose the MCP server as an SSE endpoint, follow the steps below:   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   Copy the file  .template.env  and rename it  .env . Then replace the placeholders with your own credentials and delete any key you don't need.  If .env file is not available, create it. The  .env  file should look like this (): # Conversation tools related environment variables CONVERSATION_PROJECT_ID= CONVERSATION_KEY_ID= CONVERSATION_KEY_SECRET= ## Optional but recommended: the App ID holding your channels integration configuration. If not set it must be present in the prompt CONVERSATION_APP_ID= ## Optional, defaults to "us". Other possible values are "eu" and "br" CONVERSATION_REGION= ## Needed only if you want to send SMS messages: it is the number that will be used as the sender for SMS messages DEFAULT_SMS_ORIGINATOR= ## Needed only if you want to send location messages: it converts an address to a latitude/longitude pair GEOCODING_API_KEY= # Verification tools related environment variables VERIFICATION_APPLICATION_KEY= VERIFICATION_APPLICATION_SECRET= # Voice tools related environment variables (Application key and secret can be the same as for Verification) VOICE_APPLICATION_KEY= VOICE_APPLICATION_SECRET= ## Needed only if you want to make calls: it is the number that will be displayed to the user when they receive a call CALLING_LINE_IDENTIFICATION= # Mailgun tools related environment variables MAILGUN_DOMAIN= MAILGUN_API_KEY= MAILGUN_SENDER_ADDRESS=   Start the MCP server: npm run start By default, this command will start the MCP with all the tools available. If you want to filter the tools that are available in the MCP server, you can use the  --tags  option. For example, if you want to only use the conversation tools, you can modify the command as follows: # Original command "start": "tsc && (npx -y supergateway --stdio \"node dist/index.js\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message)" # Modified command to only use conversation tools "start": "tsc && (npx -y supergateway --stdio \"node dist/index.js --tag conversation\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message)"   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: "start": "tsc && (npx -y supergateway --stdio \"node dist/index.js --tag conversation,verification\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message)"   Configure the MCP server in Claude Desktop. You can then configure the MCP server in the Claude configuration file claude_desktop_config.json with the following script as follows: { "mcpServers": { "sinch": { "command": "npx", "args": [ "-y", "supergateway", "--sse", "http://localhost:8000/sse" ] } } }   Note: Replace the  http://localhost:8000/sse  with the URL of your MCP server if it is not running locally. 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.     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! ... View more

The Sinch MCP (Model Context Protocol) server enables you to interact with Claude to perform a wide range of communication tasks using Sinch's powerful APIs. This guide covers everything you can ask Claude to do when connected to the Sinch MCP server.   Messaging Capabilities   Text Messages   Send simple text messages across multiple channels including SMS, WhatsApp, RCS, and many other messaging platforms. What you can ask: "Send an SMS to +1234567890 saying 'Hello from Claude'" "Send a WhatsApp message to +15551234567 with the text 'Meeting reminder: 3 PM today'" "Text my colleague on RCS about the project update". Supported channels: SMS WhatsApp RCS (Rich Communication Services) Facebook Messenger Viber Viber Business Messages MMS Instagram Telegram KakaoTalk LINE WeChat Apple Business Chat.   Media Messages   Share images, videos, documents, and other media files through various messaging channels using publicly accessible URLs.   What you can ask: "Send this image URL via WhatsApp to +1234567890: https://example.com/image.jpg" "Share this document link through SMS to my team: https://example.com/report.pdf" "Send a photo via MMS to +15551234567 from this URL". Supported media types: Images (JPEG, PNG, GIF) Videos (MP4, AVI, MOV) Documents (PDF, DOC, XLS) Audio files Any file accessible via public URL.   Location Messages   Share location information by providing a physical address that gets automatically converted to longitude and latitude coordinates.   What you can ask: "Send my current location '123 Main St, New York, NY 10001' via WhatsApp to +1234567890" "Share the office address '456 Business Ave, San Francisco, CA' through SMS to the new employee" "Send the meeting location 'Central Park, New York' via RCS". Location features: Automatic address-to-coordinates conversion Support for full addresses with street, city, state, ZIP Works across all supported messaging channels Recipients receive interactive location pins they can open in maps.   Contact Messages   Send contact information cards that recipients can easily save to their phone's address book.   What you can ask: "Send contact info for John Smith (+1234567890, john@company.com) via WhatsApp to +1987654321" "Share my business card details through SMS including name, phone, email, and address" "Send the new employee's contact information to the team via RCS". Contact information supported: Full name (required) - First, middle, last name, prefix, suffix Phone numbers (required) - Multiple numbers with types (mobile, home, work) Email addresses - Multiple emails with types Physical addresses - Complete address with city, state, country, ZIP code. Example request: "Send contact card for 'Jane Doe' with phone +1555123456 (mobile), email jane.doe@company.com (work), and address '123 Business St, New York, NY 10001' via WhatsApp".   Template Messages   Send pre-designed message templates for consistent branding and messaging. Supports both omni-channel templates and WhatsApp-specific templates.   What you can ask: "Send template message [template-id] to +1234567890 via WhatsApp with parameters: name='John', date='tomorrow'" "Use the appointment reminder template to notify customers about their upcoming visits" "Send the welcome template in Spanish to new subscribers". Template features: Omni-channel templates - Work across multiple messaging platforms WhatsApp templates - Specialized templates for WhatsApp Business Parameter substitution - Customize templates with dynamic content Multi-language support - Send templates in different languages using BCP-47 language codes. Template management: View all available templates with "List my messaging templates" Templates must be pre-created and approved through your Sinch dashboard Different templates may have different parameter requirements.   Choice Messages (Interactive Buttons)   Send interactive messages with clickable options including call buttons, location buttons, text responses, and URL buttons. You can include up to 3 choices for rich messages or up to 10 text-only choices.   What you can ask: "Send a choice message to +1234567890 asking 'How can we help?' with options: 'Call Support', 'Visit Website', 'Send Location'" "Create an interactive menu via WhatsApp with text options: 'Check Balance', 'Transfer Money', 'Account Info'" "Send a customer service message with call button for +18005551234 titled 'Call Support'". Choice types supported: Call buttons - Phone number + display title (e.g., "Call Support: +18005551234") Location buttons - Latitude/longitude coordinates + display title Text responses - Simple text options for quick replies URL buttons - Clickable links with custom titles. Features: Include optional media (image/video) with your choice message Combine different choice types in one message Works across all supported messaging channels Up to 10 text-only choices or 3 mixed-type choices per message. Example requests: "Send a restaurant menu via WhatsApp with choices: 'View Menu' (URL), 'Call to Order' (phone), 'Get Directions' (location)" "Create a support ticket message with options: 'Technical Issue', 'Billing Question', 'General Inquiry'".   Card Messages   Currently not supported - this message type is not available through the Sinch MCP server.   Carousel Messages   Currently not supported - this message type is not available through the Sinch MCP server.   Phone Number Management   Phone Number Verification   Implement secure phone number verification using SMS-based one-time passwords (OTP). What you can ask: "Start SMS verification for phone number +1234567890" "Verify the code 123456 for phone number +1234567890" "Set up phone verification for user registration".   Number Lookup and Validation   Validate phone numbers and get detailed information about their status and capabilities. What you can ask: "Check if +1234567890 is a valid phone number" "Look up information for this phone number" "Validate these phone numbers before sending messages".   Voice and Calling Features   Text-to-Speech Callouts   Make automated phone calls that read messages aloud using text-to-speech technology. What you can ask: "Call +1234567890 and read this message: 'Your appointment is confirmed for tomorrow at 2 PM'" "Make a TTS call to remind someone about their meeting" "Call this number and announce the weather update".   Conference Calling   Set up and manage conference calls with multiple participants. What you can ask: "Start a conference call with +1234567890 and +1987654321" "Create a conference room and invite these phone numbers" "Set up a team conference call".   Conference Management   Control conference participants with various management actions. What you can ask: "Mute participant [ID] in conference [ID]" "Put participant [ID] on hold" "Unmute all participants in the conference" "Close the conference call".   Email Services   Send Emails   Send professional emails with custom subjects and content. What you can ask: "Send an email to john@example.com with subject 'Meeting Follow-up' and this message..." "Email the quarterly report to the stakeholders" "Send a welcome email to new subscribers".   Email Tracking and Analytics   Retrieve detailed information about sent emails including delivery status, open rates, click-through rates, and engagement metrics. What you can ask: "Get information about email ID [email-id]" "Check the delivery status of the email I sent earlier" "Show me the tracking data for this email campaign" "Retrieve email events for my domain from the last 7 days".   Email Event Management   Track and analyze email events across your campaigns with detailed filtering options. What you can ask: "Show me all delivered emails from yesterday" "List failed email deliveries from this week" "Get all email opens and clicks from the last month" "Show me unsubscribe events for my domain". Available event types: Delivery events - accepted, delivered, failed Engagement events - opened, clicked List management - unsubscribed, complained Storage events - stored. Filtering options: Filter by specific event types Set date ranges for historical analysis Limit results (up to 300 events per query) Domain-specific event tracking. Template and Application Management   List Messaging Templates   View all available messaging templates in your account for consistent branding and automated messaging. What you can ask: "Show me all my available messaging templates" "List the templates I can use for customer communications" "What omni-channel templates do I have configured?".   List Email Templates   View all available email templates in your Mailgun domain for email marketing and communications. What you can ask: "Show me my email templates" "List available email templates for my domain" "What email templates can I use for newsletters?".   List Conversation Apps   View and manage your Sinch Conversation API applications and their configurations. What you can ask: "Show me all my Sinch conversation apps" "List the available conversation applications in my account" "What apps do I have configured for messaging?".   Advanced Features and Use Cases   Multi-Channel Campaigns   Coordinate messaging across different platforms simultaneously. Example requests: "Send the same promotional message via SMS and WhatsApp to these contacts" "Create a multi-channel notification system".   Automated Workflows   Set up automated communication sequences. Example requests: "Create a verification workflow: send SMS code, then verify when user responds" "Set up appointment reminders via both SMS and voice call".   Customer Support Integration   Use various channels for customer service communications. Example requests: "Send a support ticket update via the customer's preferred channel" "Escalate this issue with a phone call if SMS delivery fails".   Best Practices and Tips   Phone Number Format   Always provide phone numbers in E.164 format (e.g., +1234567890) for best results.   Session Tracking   Use session IDs when provided to track related communications and maintain context across multiple interactions.   Error Handling   If a message fails on one channel, Claude can help you try alternative channels or methods.   Getting Started   To begin using these features with Claude and the Sinch MCP server: Ensure your Sinch MCP server is properly configured Have your Sinch credentials and app configurations ready Start by asking Claude to perform simple tasks like sending a test SMS Gradually explore more complex features like conference calling and multi-channel campaigns.   Support and Troubleshooting   If you encounter issues: Verify phone numbers are in the correct E.164 format Check that your Sinch app configurations support the requested channels Ensure you have sufficient credits/permissions for the requested operations Review any error messages Claude provides for specific guidance. The Sinch MCP server integration makes it easy to leverage Sinch's comprehensive communication platform through natural language interactions with Claude. Simply describe what you want to accomplish, and Claude will use the appropriate Sinch APIs to fulfill your request. ... View more