{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sms/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"product":"SMS","type":"markdown"},"seo":{"title":"SMS Services AI Best Practices | SMS Services | Sinch","siteUrl":"https://developers.sinch.com","llmstxt":{"title":"Sinch Developer Documentation","description":"LLMs.txt containing a map of all the documentation files for Sinch.","sections":[{"title":"SMS API","description":"The SMS API allows you to send and receive SMS messages with a few easy steps. You can also send bulk SMS messages to multiple customers using the Sinch SMS service.","includeFiles":["docs/sms/**/*.md","docs/sms/**/*.yaml"],"excludeFiles":["docs/sms/index.md"]},{"title":"Numbers API","description":"The Numbers API enables you to search for, view, and activate numbers. It's considered a precursor to other APIs in the Sinch product family. The numbers API can be used in tandem with any of our APIs that perform messaging or calling.","includeFiles":["docs/numbers/**/*.md","docs/numbers/**/*.yaml"],"excludeFiles":["docs/numbers/index.md"]},{"title":"Conversation API","description":"Send and receive messages globally on many popular channels with ease and confidence when using Sinch's Conversation API. Conversation API is the preferred API for sending mobile messages on SMS and other social channels with Sinch. It is a simple API with unified error messages, consistent request payloads, and common webhook payloads that are channel-agnostic.","includeFiles":["docs/conversation/**/*.md","docs/conversation/**/*.yaml"],"excludeFiles":["docs/conversation/index.md"]},{"title":"Voice API","description":"The Voice API works as a big telephony switch. The Voice API handles incoming phone calls (also known as incoming call “legs”), sets up outgoing phone calls (or outgoing call “legs”), and bridges the two. The incoming call leg may come in over a data connection (from a smartphone or web application using the Sinch SDKs) or through a local phone number (from the PSTN network). Similarly, the outgoing call leg can be over data (to another smartphone or web application using the Sinch SDKs) or the PSTN network.","includeFiles":["docs/voice/**/*.md","docs/voice/**/*.yaml"],"excludeFiles":["docs/voice/index.md"]},{"title":"Verification API","description":"The Verification API is a platform for phone number verification. It consists of the API and different software development kits (the Sinch SDKs) that you integrate with your smartphone or web application and cloud based back-end services. Together they enable SMS, Flashcall, Phone Call and Data verification in your application.","includeFiles":["docs/verification/**/*.md","docs/verification/**/*.yaml"],"excludeFiles":["docs/verification/index.md"]},{"title":"Provisioning API","description":"Provisioning API allows you to programmatically set up your senders, accounts and templates on your favorite messaging platforms on the Conversation API. For now, you can create your first WhatsApp channel through Meta's Embedded sign up, you can configure your first SMS App and configure your webhooks. As development continues, we will be adding the most commonly used channels.","includeFiles":["docs/provisioning-api/**/*.md","docs/provisioning-api/**/*.json"],"excludeFiles":["docs/provisioning-api/index.md"]},{"title":"Elastic SIP Trunking API","description":"With Elastic SIP Trunking you can create and manage your SIP trunks and phone numbers programmatically.","includeFiles":["docs/est/**/*.md","docs/est/**/*.yaml"],"excludeFiles":["docs/est/index.md"]},{"title":"Fax API","description":"Send and receive HIPAA compliant faxes on our modern fax platform using our developer-friendly API.","includeFiles":["docs/fax/**/*.md","docs/fax/**/*.yaml"],"excludeFiles":["docs/fax/index.md"]},{"title":"In-app Voice and Video SDK","description":"The In-app Voice and Video SDK enables you to add voice and video calling capabilities directly into your mobile or web application using the Sinch SDKs.","includeFiles":["docs/in-app-calling/**/*.md"],"excludeFiles":["docs/in-app-calling/index.md"]}],"hide":false,"excludeFiles":[]},"description":"How to use various AI tools with SMS API"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"using-ai-tools-with-sinchs-sms-services","__idx":0},"children":["Using AI tools with Sinch's SMS services"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note:"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide includes best practices for using generative AI tools with Sinch's ","SMS"," API. Generative AI can make mistakes, and Sinch has limited influence over the output of any given generative AI tool. Ensure you review any code produced by generative AI to confirm its accuracy, stability, and security against our documentation, your environment, and your needs."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use AI tools to facilitate the generation of code that you can use with Sinch's SMS services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While there are any number of ways to make use of AI tools, we provide guidance on using ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#using-sinchs-documentation-mcp-server"},"children":["Sinch's documentation MCP server"]}," to utilize our documentation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"using-sinchs-documentation-mcp-server","__idx":1},"children":["Using Sinch's documentation MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order to generate code samples using AI tools, you may connect directly to Sinch's documentation MCP server. This will make several tools available to your system that facilitate endpoint identification, information lookups, and general context-setting."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note:"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sinch's documentation MCP server provides tools that help you navigate Sinch's documentation. Because Sinch's documentation includes various code samples, it can also help you generate code samples. It will not make calls to the identified endpoints for you; you must include any provided code in your solution and customize it to correctly reference your account and credentials."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The tools are described in the table below. Note that, while you may not have to explicitly call out these tools when designing your prompt (or using the prompts we provide later in this document), you must still ensure the tools are activated in whatever AI environment you work in:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameters"},"children":["Parameters"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whoami"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns information about the authenticated user."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-apis"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name?: string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lists available APIs with their context and purpose."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-endpoints"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name: string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns all endpoints and their descriptions for a specific API."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-endpoint-info"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name: string``path: string``method: string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns comprehensive information about a specific endpoint, including parameters, security, and examples."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-security-schemes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name: string``path: string``method: string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gets the security schemes for a specific API."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-full-api-description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name: string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns the complete OpenAPI description."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["query: string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Searches documentation and returns relevant content for a query."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connecting-to-the-mcp-server","__idx":2},"children":["Connecting to the MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may connect to our documentation MCP server by clicking the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect MCP"]}," button: ",{"$$mdtype":"Tag","name":"ConnectMCP","attributes":{"placement":"bottom","alignment":"start","options":["cursor","vscode","copy"]},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note:"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The AI tools listed in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect MCP"]}," button drop-down list and the tools described below are for illustrative purposes. You may use our documentation MCP server with any AI tool that can connect to MCP servers."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alternatively, copy the following URL and add it to your AI tool: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://developers.sinch.com/mcp"]},". Some examples of how to add the Sinch documentation MCP server tools to your AI solution are detailed in the tabs below:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Cursor","disable":false},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"connect-cursor-to-the-mcp-server","__idx":3},"children":["Connect Cursor to the MCP server"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Cursor, open the command palette."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["macOS: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Command + Shift + P"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Windows/Linux: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ctrl + Shift + P"]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Type \"Open MCP settings\" in the command palette."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select \"Add custom MCP\"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cursor opens the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]}," file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"configure-the-mcp-server","__idx":4},"children":["Configure the MCP server"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]},", add your server configuration:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"sinch-mcp\": {\n      \"url\": \"https://developers.sinch.com/mcp\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]}," file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to MCP settings and confirm the connection."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If authentication is required, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Needs login"]}," and complete the sign-in flow."," ","After connecting, Cursor displays the list of available tools."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"test-the-cursor-connection","__idx":5},"children":["Test the Cursor connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Cursor chat (Agent mode), ask a question that triggers an MCP tool."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Claude Code","disable":false},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"connect-claude-code-to-the-mcp-server","__idx":6},"children":["Connect Claude Code to the MCP server"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude mcp add ${MCP_SERVER_NAME} https://developers.sinch.com/mcp --transport http"]}," where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${MCP_SERVER_NAME}"]}," is your desired server name (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sinch_mcp"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Claude Code CLI, type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," and complete authentication if prompted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Claude Code lists the available tools with descriptions and parameters."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"test-the-claude-code-connection","__idx":7},"children":["Test the Claude Code connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Claude Code CLI, ask the AI agent to perform an instruction that uses an MCP tool."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"VS Code","disable":false},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"connect-vs-code-to-the-mcp-server","__idx":8},"children":["Connect VS Code to the MCP server"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In VS Code, open the command palette."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["macOS: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Command + Shift + P"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Windows/Linux: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ctrl + Shift + P"]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Type \"MCP: Add Server\" in the command palette."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select \"HTTP\" to connect to a remote MCP server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the MCP server URL (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://developers.sinch.com/mcp"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a name for the connection."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"test-the-vs-code-connection","__idx":9},"children":["Test the VS Code connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open Chat with AI in Agent mode and select the Tools icon."," ","Confirm that your MCP connection appears with a list of available tools."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ask the AI to perform a query that uses an MCP tool."]}]}]}]},"headings":[{"value":"Using AI tools with Sinch's SMS services","id":"using-ai-tools-with-sinchs-sms-services","depth":1},{"value":"Using Sinch's documentation MCP server","id":"using-sinchs-documentation-mcp-server","depth":2},{"value":"Connecting to the MCP server","id":"connecting-to-the-mcp-server","depth":3},{"value":"Connect Cursor to the MCP server","id":"connect-cursor-to-the-mcp-server","depth":4},{"value":"Configure the MCP server","id":"configure-the-mcp-server","depth":4},{"value":"Test the Cursor connection","id":"test-the-cursor-connection","depth":4},{"value":"Connect Claude Code to the MCP server","id":"connect-claude-code-to-the-mcp-server","depth":4},{"value":"Test the Claude Code connection","id":"test-the-claude-code-connection","depth":4},{"value":"Connect VS Code to the MCP server","id":"connect-vs-code-to-the-mcp-server","depth":4},{"value":"Test the VS Code connection","id":"test-the-vs-code-connection","depth":4}],"frontmatter":{"seo":{"title":"SMS Services AI Best Practices | SMS Services | Sinch","description":"How to use various AI tools with SMS API"},"markdown":{"toc":{"depth":3}}},"lastModified":"2026-02-23T22:46:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/sms/ai-support","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}