> ## 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.

# (Legacy) Telnyx Remote MCP

> Legacy Telnyx Remote MCP server guide — connect Claude and other AI tools to Telnyx APIs without running MCP locally. New users should use the current docs.

# (Legacy) Telnyx Remote Model Context Protocol (MCP)

## Quickstart with Claude Desktop

### Connect via Portal

\*Requires a Claude / Claude Desktop plan with access to Custom Connectors

Go to Claude > Settings > Connectors

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-desktop-custom-connector.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=59ad97bd4f64e2918ad4b7fd680e5503" alt="Claude Desktop Step 1" width="1467" height="863" data-path="assets/images/claude-desktop-custom-connector.png" />

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-desktop-connector-config.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=2df45aadc4385a944bf0fc87d2c25b0e" alt="Claude Desktop Step 2" width="1426" height="849" data-path="assets/images/claude-desktop-connector-config.png" />

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-desktop-connector-connect.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=6de78d8710321f020084d3d352a5c9dc" alt="Claude Desktop Step 3" width="1451" height="963" data-path="assets/images/claude-desktop-connector-connect.png" />

Grant access in the Telnyx Portal (must be logged in)

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-desktop-portal-grant.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=0b30f0a1ba0ea9b0bdd56dddd4ba5c78" alt="Claude Desktop Step 4" width="619" height="497" data-path="assets/images/claude-desktop-portal-grant.png" />

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-desktop-list-tools.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=5ac64aca25979227f501a23df779c240" alt="Claude Desktop Step 5" width="970" height="774" data-path="assets/images/claude-desktop-list-tools.png" />

### Connect via API Key

1. Get your API key from the Telnyx Portal.
2. Install `node` and `npx`
3. Go to Claude > Settings > Developer > Edit Config > claude\_desktop\_config.json
   to include the following:

```json theme={null}
{
  "mcpServers": {
    "Telnyx-Remote-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.telnyx.com/mcp/sse",
        "--transport",
        "sse-only",
        "--header",
        "Authorization:Bearer <YOUR-TELNYX-API-KEY>"
      ]

    }
  }
}
```

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-desktop-config.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=5c5b008aa1f03dc91c847588c7c292e9" alt="Claude Desktop Config" width="3138" height="1156" data-path="assets/images/claude-desktop-config.png" />

Restart Claude Desktop and you should be able to see the Telnyx MCP server in
the list of available MCP servers.

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-list-tools.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=2a6c14b54bd2175eadd30d4e07e14647" alt="Claude Desktop List Tools" width="1554" height="1458" data-path="assets/images/claude-list-tools.png" />

You can try to search and purchase a number.

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/claude-number-purchase.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=a6221c33383097a5b080068b799c0370" alt="Claude Desktop Purchase numbers" width="1552" height="1738" data-path="assets/images/claude-number-purchase.png" />

## Quickstart with ChatGPT Playground

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/chatgpt-mcp-1.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=1070a781ef9d4f323cdcd5264cf83972" alt="ChatGPT Playground MCP Step 1" width="3820" height="1902" data-path="assets/images/chatgpt-mcp-1.png" />

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/chatgpt-mcp-2.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=f4fe6bac0bf3adefda651ccf6a69e8bc" alt="ChatGPT Playground MCP Step 2" width="3826" height="1922" data-path="assets/images/chatgpt-mcp-2.png" />

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/chatgpt-mcp-3.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=a65ad6d3ee4269bbfe3c7f93ce92f540" alt="ChatGPT Playground MCP Step 3" width="3830" height="1926" data-path="assets/images/chatgpt-mcp-3.png" />

<img src="https://mintcdn.com/telnyx/kwpUfZn-MF78Ulju/assets/images/chatgpt-mcp-4.png?fit=max&auto=format&n=kwpUfZn-MF78Ulju&q=85&s=e92c019e8cfc5ec0c36a438aab32528e" alt="ChatGPT Playground MCP Step 4" width="3826" height="1920" data-path="assets/images/chatgpt-mcp-4.png" />

## Available Tools

### Assistant Tools

* `create_assistant` - Create a new AI assistant
* `get_assistant` - Retrieve details of an existing assistant
* `get_assistant_texml` - Get an assistant's TEXML configuration
* `list_assistants` - List all available assistants
* `mcp_telnyx_delete_assistant` - Delete an existing assistant
* `start_assistant_call` - Initiate a call using an AI assistant
* `update_assistant` - Update an existing assistant's configuration

### Call Control Tools

* `create_call_control_application` - Create a new call control application
* `get_call_control_application` - Get details of a call control application
* `hangup` - End an active call
* `list_call_control_applications` - List all call control applications
* `make_call` - Initiate a new outbound call
* `playback_start` - Start audio playback during a call
* `playback_stop` - Stop audio playback during a call
* `send_dtmf` - Send DTMF tones during a call
* `speak` - Use text-to-speech during a call
* `transfer` - Transfer a call to a new destination

### Cloud Storage Tools

* `cloud_storage_create_bucket` - Create a new storage bucket
* `cloud_storage_list_buckets` - List all available storage buckets
* `cloud_storage_upload_file` - Upload a file to cloud storage
* `cloud_storage_download_file` - Download a file from cloud storage
* `cloud_storage_list_objects` - List objects within a bucket
* `cloud_storage_delete_object` - Delete an object from cloud storage
* `cloud_storage_get_bucket_location` - Get a bucket's region location

### Connection Tools

* `get_connection` - Get details of a connection
* `list_connections` - List all available connections
* `update_connection` - Update an existing connection

### Embeddings Tools

* `create_embeddings` - Create embeddings for a bucket with files
* `embed_url` - Scrape and embed a website's content
* `list_embedded_buckets` - List all embedded buckets

### Messaging Tools

* `send_message` - Send an SMS/MMS message
* `get_message` - Retrieve details of a sent message

### Messaging Profile Tools

* `create_messaging_profile` - Create a new messaging profile
* `get_messaging_profile` - Get details of a messaging profile
* `list_messaging_profiles` - List all messaging profiles
* `update_messaging_profile` - Update an existing messaging profile

### Phone Number Tools

* `initiate_phone_number_order` - Order a new phone number
* `get_phone_number` - Get details of a phone number
* `list_available_phone_numbers` - List available phone numbers for purchase
* `list_phone_numbers` - List all phone numbers in your account
* `update_phone_number` - Update phone number configuration
* `update_phone_number_messaging_settings` - Update messaging settings for a number

### Secrets Manager Tools

* `create_integration_secret` - Create a new integration secret
* `delete_integration_secret` - Delete an integration secret
* `list_integration_secrets` - List all integration secrets
