> ## 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/d2AUJO5qdne_WnZI/img/claude-desktop-custom-connector.png?fit=max&auto=format&n=d2AUJO5qdne_WnZI&q=85&s=2c5ae7c9f2d5ec7e6da85d630394d972" alt="Claude Desktop Step 1" width="1467" height="863" data-path="img/claude-desktop-custom-connector.png" />

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

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

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

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

<img src="https://mintcdn.com/telnyx/d2AUJO5qdne_WnZI/img/claude-desktop-list-tools.png?fit=max&auto=format&n=d2AUJO5qdne_WnZI&q=85&s=d877a9e8001b9d315f3bb597bd0f09f2" alt="Claude Desktop Step 5" width="970" height="774" data-path="img/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/d2AUJO5qdne_WnZI/img/claude-desktop-config.png?fit=max&auto=format&n=d2AUJO5qdne_WnZI&q=85&s=25f29756fee7db421ce3934d8d40f49b" alt="Claude Desktop Config" width="3138" height="1156" data-path="img/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/d2AUJO5qdne_WnZI/img/claude-list-tools.png?fit=max&auto=format&n=d2AUJO5qdne_WnZI&q=85&s=048d66d275e9e51272c6f04a2c40db8d" alt="Claude Desktop List Tools" width="1554" height="1458" data-path="img/claude-list-tools.png" />

You can try to search and purchase a number.

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

## Quickstart with ChatGPT Playground

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

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

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

<img src="https://mintcdn.com/telnyx/d2AUJO5qdne_WnZI/img/chatgpt-mcp-4.png?fit=max&auto=format&n=d2AUJO5qdne_WnZI&q=85&s=132a3940045e9c651a35808afaa4a620" alt="ChatGPT Playground MCP Step 4" width="3826" height="1920" data-path="img/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
