Skip to content
Last updated

Using AI tools with Elastic SIP Trunking

Note:

This guide includes best practices for using generative AI tools with Sinch's Elastic SIP Trunking 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.

You can use AI tools to facilitate the generation of code that you can use with Sinch's Elastic SIP Trunking API.

While there are any number of ways to make use of AI tools, we provide guidance on using Sinch's documentation MCP server to utilize our documentation. We also have an MCP server specifically for Elastic SIP Trunking functionality.

Elastic SIP Trunking MCP Server

A Model Context Protocol (MCP) server for managing Sinch EST - enables AI assistants to manage SIP trunks, phone numbers, ACLs, and perform SIP call testing.

Requires Node.js >= 18

Quick Start

# Install globally from npm
npm install -g @sinch/est-mcp

# Or run directly with npx
npx @sinch/est-mcp

# Configure credentials
mkdir -p ~/.config/est-mcp
cat > ~/.config/est-mcp/credentials << 'EOF'
SINCH_PROJECT_ID=your-project-id
SINCH_ACCESS_KEY_ID=your-access-key-id
SINCH_ACCESS_KEY_SECRET=your-access-key-secret
EOF
chmod 600 ~/.config/est-mcp/credentials

Features

44 tools across 8 categories:

CategoryTools
Trunkslist, get, create, update, delete
Numberslist active/available, rent, release, assign, unassign
ACLslist, create, update, delete, link to trunk
Credentialslist, create, delete, link to trunk
Endpointslist, create, delete
SIP TestingOPTIONS ping, test call, audio stream, recording
Call Logslist, get, filter by date/range/direction
ComplianceEmergency addresses, country permissions
Documentationget_operator_guide — loads full EST context into the AI

AI Context Injection

Start every session with:

get_operator_guide({})

This loads the complete Sinch EST mental model into context.

Example Use Cases

Set up a trunk:

"Create a trunk 'my-trunk' with hostname 'my-trunk'"

Test connectivity:

"Run a loopback test on trunk X with phone number +15551234567"

Receive calls:

"Set up a registered endpoint and wait for an inbound call"

Installation

Add to your MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "sinch-est": {
      "command": "npx",
      "args": ["@sinch/est-mcp"]
    }
  }
}

Using Sinch's documentation MCP server

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.

Note:

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.

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:

ToolParametersDescription
whoamiNoneReturns information about the authenticated user.
list-apisname?: stringLists available APIs with their context and purpose.
get-endpointsname: stringReturns all endpoints and their descriptions for a specific API.
get-endpoint-infoname: string``path: string``method: stringReturns comprehensive information about a specific endpoint, including parameters, security, and examples.
get-security-schemesname: string``path: string``method: stringGets the security schemes for a specific API.
get-full-api-descriptionname: stringReturns the complete OpenAPI description.
searchquery: stringSearches documentation and returns relevant content for a query.

Connecting to the MCP server

You may connect to our documentation MCP server by clicking the Connect MCP button:

Note:

The AI tools listed in the 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.

Alternatively, copy the following URL and add it to your AI tool: 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:

Connect Cursor to the MCP server

  1. In Cursor, open the command palette.
  • macOS: Command + Shift + P
  • Windows/Linux: Ctrl + Shift + P
  1. Type "Open MCP settings" in the command palette.
  2. Select "Add custom MCP".

Cursor opens the mcp.json file.

Configure the MCP server

  1. In mcp.json, add your server configuration:
{
  "mcpServers": {
    "sinch-mcp": {
      "url": "https://developers.sinch.com/mcp"
    }
  }
}
  1. Save the mcp.json file.
  2. Return to MCP settings and confirm the connection.

If authentication is required, select Needs login and complete the sign-in flow. After connecting, Cursor displays the list of available tools.

Test the Cursor connection

In Cursor chat (Agent mode), ask a question that triggers an MCP tool.

Using Sinch's skills to streamline AI usage

Skills files (or "skills") provide AI-specific guidance, hints, troubleshooting tips, and use-case information that can help your AI agents better understand various topics. They are especially helpful when using AI tools and agents in coding environments.

Sinch provides skills that help your AI solution navigate our documentation, generate code samples, and perform API calls.

To view Sinch's skills files, visit the Sinch Skills GitHub repo. The sub-sections below provide concise installation, usage, and structural information. For a more thorough explanation of Sinch Skills, see our dedicated developer document on Sinch Skills.

Installing Sinch skills

To make use of our skills files, you must install them in your coding environment. Information on ways to install Sinch's skills files are included on the tabs below:

Installing Sinch's skills using NPM

To install Sinch skills using NPM:

  1. Open your preferred IDE and navigate to the directory or repo in which you project is stored.
    Note:

    Alternatively, you may navigate to your home directory to install Sinch's skill files. They will then be available for use across various coding projects.

  2. Open a terminal and/or command prompt.
  3. Run the command npx skills add sinch/skills.

Using Sinch skills

Once Sinch's skills have been installed, your AI tool or agent should make use of them automatically. AI tools and agents will consult the skills files whenever you make a request.

Sinch skills structure

Each skill lives in its own folder under skills/. The SKILL.md file contains YAML frontmatter (name and description) and markdown sections including Overview, Getting Started, Key Concepts, Common Patterns, Gotchas & Best Practices, and Links sections.

skills/
  <product>/
    SKILL.md            # Main skill file (required)
    scripts/            # Optional helper scripts
    references/         # Optional detailed reference material
    assets/             # Optional images or other assets