Exotel MCP Server

How to use

You interact with ExotelMCP through an MCP client (such as Claude) to perform SMS, voice, and audio tasks. Describe what you want to accomplish using natural language, and Claude routes the request to Exotel via the MCP server. Common workflows include sending an SMS, placing a call, checking delivery status, bridging two numbers, or playing audio from a URL. Each action leverages the configured MCP endpoint and the token-based authentication defined in your setup.

How to install

# Prerequisites
- Node.js and npm
- Access to Claude Desktop with MCP support
- Exotel account with API credentials
- MCP Remote package (mcp-remote)

# Install MCP Remote globally
npm install -g mcp-remote

# Verify installation
npm list -g mcp-remote

Configuration and usage notes

Configure the MCP server as shown in the example configuration. This sets up Claude to communicate with Exotel through the MCP endpoint and passes an authorization header containing your credentials.

{
  "mcpServers": {
    "exotel": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.exotel.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "{'token':'YOUR_EXOTEL_TOKEN','from_number':'YOUR_FROM_NUMBER','dlt_temp':'YOUR_DLT_TEMPLATE','dlt_entity':'YOUR_DLT_ENTITY','caller_id':'YOUR_CALLER_ID','api_domain':'https://YOUR_SUB_DOMAIN','account_sid':'YOUR_ACCOUNT_SID','exotel_portal_url':'YOUR_EXOTEL_DASHBOARD_BASE_URL'}"
      }
    }
  }
}

Required credentials and where to get them

Replace placeholders with your actual Exotel credentials. You obtain these from your Exotel dashboard and convert them into a Base64-encoded token as described below.

# Example: the token is created by encoding api_key:api_secret in Base64
# api_key:api_secret
# Then base64 the string and place the result into YOUR_EXOTEL_TOKEN
```
Note: The configuration snippet expects AUTH_HEADER to contain a Base64-encoded token with your Exotel credentials, plus additional values such as from_number, dlt_temp, dlt_entity, caller_id, account_sid, api_domain, and exotel_portal_url.

Status and audio usage

Beyond SMS and calls, you can access real-time delivery status, call details, and quick audio tools via Claude. Use natural language commands like asking for delivery status, getting call history, or playing audio from a URL.

Security and hosting considerations

This MCP server uses token-based authentication to secure access to Exotel APIs. Ensure you deploy on a public domain with HTTPS, as required for MCP remote connections and Exotel webhooks.

Troubleshooting

If you encounter connectivity or authentication issues, verify your domain is accessible, ensure the MCP remote is correctly installed, and confirm HTTPS is properly configured. Check that your Exotel credentials and the Base64 token are correctly formed and that the configured numbers and DLT IDs are valid.

Send SMS

Send a single SMS message to a recipient with DLT compliance, including support for from numbers and templates.

Send Bulk SMS

Send the same message to multiple recipients in one operation, with DLT compliance.

Send Dynamic Bulk SMS

Send personalized messages to multiple recipients using per-recipient content.

Make Voice Call

Initiate a voice call from your Exotel number to a destination.

Connect Numbers

Bridge two phone numbers in a single conference call.

Call Flow Integration

Connect a number to an Exotel call flow or IVR.

Check SMS Delivery Status

Retrieve real-time delivery status for sent SMS messages.

Get Call History

Fetch bulk call details for analysis and reporting.

Play Audio

Provide quick playback links for audio URLs via a web player or browser.