> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telnyx Local MCP Server

> Run the Telnyx Local Model Context Protocol (MCP) server to integrate Telnyx APIs with Claude Desktop and other AI assistants for agentic workflows.

# Telnyx Local Model Context Protocol (MCP) Server

Official Telnyx Local Model Context Protocol (MCP) Server that enables
interaction with powerful telephony, messaging, and AI assistant APIs.
This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI
Agents and others to manage phone numbers, send messages, make calls, and
create AI assistants.

## Quickstart with Claude Desktop

<Steps>
  <Step title="Get a Telnyx API key">
    Generate or copy an API key in the [Telnyx Mission Control Portal](https://portal.telnyx.com/#/app/apikeys).
  </Step>

  <Step title="Install `uvx`">
    Install the Python package manager with `curl -LsSf https://astral.sh/uv/install.sh | sh`, `brew install uv`, or any other method documented in the [`uv` repository](https://github.com/astral-sh/uv).
  </Step>

  <Step title="Add the MCP server to Claude">
    Go to **Claude > Settings > Developer > Edit Config > claude\_desktop\_config.json**, then add the Telnyx server configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "Telnyx": {
          "command": "uvx",
          "args": ["--from", "git+https://github.com/team-telnyx/telnyx-mcp-server.git", "telnyx-mcp-server"],
          "env": {
            "TELNYX_API_KEY": "<insert-your-api-key-here>"
          }
        }
      }
    }
    ```
  </Step>
</Steps>

If you're using Windows, you will have to enable "Developer Mode" in Claude
Desktop to use the MCP server. Click "Help" in the hamburger menu at the top
left and select "Enable Developer Mode".

## Running After Download

<Steps>
  <Step title="Get a Telnyx API key">
    Copy an API key from the [Mission Control Portal](https://portal.telnyx.com/#/app/apikeys) so the MCP server can authenticate.
  </Step>

  <Step title="Install `uvx`">
    Install the Python package manager via `curl -LsSf https://astral.sh/uv/install.sh | sh`, `brew install uv`, or another method listed in the [`uv` documentation](https://github.com/astral-sh/uv).
  </Step>

  <Step title="Clone the MCP server repository">
    ```bash theme={null}
    git clone https://github.com/team-telnyx/telnyx-mcp-server.git
    cd telnyx-mcp-server
    ```
  </Step>

  <Step title="Point Claude to your local clone">
    Update your Claude config to reference the local folder by using the `--from` argument:

    ```json theme={null}
    {
      "mcpServers": {
        "Telnyx": {
          "command": "uvx",
          "args": ["--from", "/path/to/telnyx-mcp-server", "telnyx-mcp-server"],
          "env": {
            "TELNYX_API_KEY": "<insert-your-api-key-here>"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Run the MCP server locally">
    Claude now invokes the server from the cloned directory. Replace `/path/to/telnyx-mcp-server` with the actual local path.
  </Step>
</Steps>

## Available Tools

### Assistant Tools

* Create AI assistants with custom instructions and configurations
* List existing assistants
* Get assistant details
* Update assistant properties
* Delete assistants
* Get assistant TEXML configurations

### Call Control Tools

* Make outbound phone calls
* Hang up active calls
* Transfer calls to new destinations
* Play audio files during calls
* Stop audio playback
* Send DTMF tones
* Speak text using text-to-speech

### Messaging Tools

* Send SMS and MMS messages
* Get message details

### WhatsApp Tools

* Send WhatsApp messages (template or free-form text)
* List WhatsApp Business Accounts (WABAs)
* List and create message templates
* Get template details and approval status
* List WhatsApp-enabled phone numbers
* Get and update business profiles

### Phone Number Tools

* List your phone numbers
* Buy new phone numbers
* Update phone number configurations
* List available phone numbers

### Connection Tools

* List voice connections
* Get connection details
* Update connection configurations

### Cloud Storage Tools

* Create buckets compatible with Telnyx Cloud Storage
* List buckets across all regions
* Upload files
* Download files
* List objects in a bucket
* Delete objects
* Get bucket location information

### Embeddings Tools

* List existing embedded buckets
* Scrape and embed a website URL
* Create embeddings for your own files

### Secrets Manager Tools

* List integration secrets
* Create new bearer or basic secrets
* Delete integration secrets

## Example Usage

Try asking Claude:

* "Create an AI agent that can handle customer service for an e-commerce business"
* "Send a text message to +5555551234 saying 'Your appointment is confirmed for tomorrow at 3pm'"
* "Make a call to my customer at +5555551234 and transfer them to my support team"
* "Find me a phone number in Chicago with area code 312"
* "Create an auto-attendant system using Telnyx AI assistants and voice features"
* "Upload /Volumes/Drive/contract.pdf to the 'legal-docs' bucket in Telnyx Cloud Storage"
* "Embed the knowledge base at [https://example.com/docs](https://example.com/docs) so the assistant can answer user questions"
* "Create a integration secret named openai-token with my openai key XYZ"

## Contributing

See [https://github.com/team-telnyx/telnyx-mcp-server](https://github.com/team-telnyx/telnyx-mcp-server) for more information.