ExotelMCP
A Model Context Protocol (MCP) server that provides seamless integration between Claude AI and Exotel's communication APIs for SMS and voice calling services, plus quick audio tools.
Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BaşlatYayıncıdan
A Model Context Protocol (MCP) server that provides seamless integration between Claude AI and Exotel's communication APIs for SMS and voice calling services, plus quick audio tools.
A Model Context Protocol (MCP) server that provides seamless integration between Claude AI and Exotel's communication APIs for SMS and voice calling services, plus quick audio tools.
Before using the Exotel MCP Server, ensure you have:
If you don't have mcp-remote installed, run:
npm install -g mcp-remote
Verify installation:
npm list -g mcp-remote
To integrate ExotelMCP with Claude, add the following configuration to your Claude desktop settings:
Location: Claude Desktop → Settings → Developer → Edit Config
{
"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','whatsapp_from':'YOUR_WHATSAPP_SENDER_E164','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','cqa_api_key':'YOUR_CQA_API_KEY','cqa_account_id':'YOUR_CQA_ACCOUNT_ID','cqa_host':'https://cqa-console.in.exotel.com','voicebot_api_key':'YOUR_VOICEBOT_API_KEY','voicebot_api_token':'YOUR_VOICEBOT_API_TOKEN','voicebot_account_id':'YOUR_VOICEBOT_ACCOUNT_ID','calls_api_key':'YOUR_CALLS_API_KEY','calls_api_token':'YOUR_CALLS_API_TOKEN','calls_account_id':'YOUR_CALLS_ACCOUNT_ID','calls_base_url':'https://api.exotel.com'}"
}
}
}
}
Replace the placeholder values with your actual Exotel credentials:
This token is created by encoding your Exotel API Key and Secret in Base64 format.
Step 1: Get your API credentials from Exotel Dashboard
Step 2: Create the Base64 token
Format: api_key:api_secret (colon-separated)
Example: If your API Key is abc123 and API Secret is xyz789, combine them as: abc123:xyz789
Step 3: Encode to Base64
You can use any of these methods:
Online Tool:
api_key:api_secret stringCommand Line (Mac/Linux):
echo -n "your_api_key:your_api_secret" | base64
Command Line (Windows):
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("your_api_key:your_api_secret"))
https://cqa-console.in.exotel.com)Note: Conversational Intelligence credentials are only required if you plan to use the quality analysis tools. SMS and Voice tools work independently.
ameyo5m)https://api.exotel.com)Note: VoiceBot credentials are only required if you plan to use the VoiceBot tools. The VoiceBot management API (list/create/delete bots) uses
voicebot_*credentials, while placing actual calls usescalls_*credentials.
Required for all exotel_aiassist_* tools:
https://ai-assist.in.exotel.com)Auth: provide one of these modes (Twilix Basic is the default for CPaaS tenants):
Optional:
ai-assist/api)Example (Cursor ~/.cursor/mcp.json):
{
"mcpServers": {
"exotel": {
"url": "https://mcp.exotel.com/mcp",
"headers": {
"Authorization": "Bearer {\"ai_assist_base_url\":\"https://ai-assist.in.exotel.com\",\"ai_assist_account_sid\":\"YOUR_ACCOUNT_SID\",\"ai_assist_auth_key\":\"YOUR_API_KEY\",\"ai_assist_auth_secret\":\"YOUR_API_TOKEN\"}"
}
}
}
}
Note: AI Assist credentials are only required for AI Assist tools. SMS, Voice, CQA, and VoiceBot tools work independently.
Write safety: Create/update/publish/archive/delete tools require
confirm=trueon the tool call.
Once configured, you can use Claude to interact with Exotel services using natural language commands. Simply describe what you want to do, and Claude will handle the API calls through the MCP server.
Example Commands:
Audio Commands:
Conversational Intelligence -- Setup Commands:
Conversational Intelligence -- Analysis Commands:
VoiceBot Commands:
AI Assist Commands:
Send a single SMS message to a specific phone number with DLT compliance.
Example:
Send an SMS to +919999999999 with message "Hello from Claude!" using DLT template 1107160086208866373 and entity 1101428740000012125
Send the same message to multiple recipients at once.
Example:
Send "Welcome to our service!" to these numbers: +919999999999, +919888888888, +919777777777
Send personalized messages to multiple recipients with different content for each.
Example:
Send personalized messages: "Hello John" to +919999999999 and "Hello Jane" to +919888888888
Create a static SMS message campaign on Engage (exotel_engage_create_sms_campaign).
Uses the same calls_api_key / calls_api_token / calls_account_id (or CPaaS token + account_sid) as other telephony tools — no separate Engage credentials.
Example:
Create an Engage SMS campaign named "July promo" to list list_sid from EXOTEL,
transactional, template "Hello from Engage https://example.com/promo",
DLT entity 123456 and template id 789012, with URL shortening enabled
Optional schedule and callbacks:
Same campaign, scheduled 2026-08-10T18:00:00+05:30 to 2026-08-10T20:00:00+05:30,
with status_callback and message_status_callback URLs
Send a WhatsApp message through Exotel (Exotel is the WhatsApp BSP) with exotel_whatsapp_send_message.
Uses the CPaaS token + account_sid + api_domain, plus a dedicated whatsapp_from auth field — your WhatsApp-enabled sender number in E.164 with a leading + (usually different from from_number, and not the WABA id). Mumbai accounts use api_domain=https://api.in.exotel.com.
Template (start a conversation):
Send a WhatsApp template "order_confirmation" (language en) to +919999999999
with body variables ["Rahul", "#ORD-12345"]
Free text (reply inside the 24-hour window):
Send a WhatsApp text "Thanks, your request is noted" to +919999999999
Notes (common failures):
token must be base64 of api_key:api_secret (not the secret alone). Build it with printf '%s' 'API_KEY:API_SECRET' | base64. A wrong or placeholder token is the usual cause of a 401.sample_issue_resolution), not the display title.en and en_US are different; a mismatch returns a 400.whatsapp_from number in the last 24h. To start a new conversation, use a template.202 response means Exotel accepted the message (returns a sid); it does not confirm WhatsApp delivery.Initiate a voice call to any phone number using your registered Exotel number.
Example:
Call +919999999999 from my registered number
Bridge two phone numbers in a single call, connecting them together.
Example:
Connect +919999999999 with +919888888888 in a conference call
Connect a phone number to a predefined Exotel call flow or IVR system.
Example:
Connect +919999999999 to call flow app_id 12345
Get real-time delivery status and details for sent SMS messages.
Example:
Check the delivery status of SMS sent to +919999999999
Retrieve call details, duration, and status for voice calls.
Example:
Get call details for calls made to +919999999999
Retrieve bulk call details and history for analysis.
Example:
Get all call details made from +919999999999
Get metadata and information about phone numbers.
Example:
Get information about phone number +919999999999
Quick one-click audio playback and management tools.
Get instant clickable links to play any audio URL in your browser.
Example:
Play audio from https://example.com/song.mp3
Access the web-based audio player interface for full control.
Example:
Open the audio player interface
Get direct download links for any audio file.
Example:
Download audio from https://example.com/song.mp3
Exotel Conversational Intelligence analyzes 100% of customer conversations across voice and digital channels using AI, delivering real-time quality intelligence. The platform reviews thousands of conversations in minutes, maintaining over 90% accuracy in objective evaluations — replacing manual sampling with continuous, automated QA at scale.
Authentication: CQA tools use two authentication methods:
cqa_api_key configured in the MCP auth headerAPI key: Generate your API key from the Conversational Intelligence console or via the exotel_cqa_create_api_key MCP tool, then provide it as cqa_api_key in the MCP configuration.
Authenticate with CQA to get a JWT token required for setup operations (quality profiles, API keys, assignment rules).
Example:
Login to CQA as [email protected] on tenant exotel_support
Create a complete quality profile with categories, sub-categories, and KPIs in a single call. The profile is automatically created with AI analysis enabled.
Example:
Create a quality profile called "Support Evaluation" with category "Communication", sub-category "Clarity", and KPIs: "Clear Speech" (Yes/No, options: Yes=1/No=0), "Professional Tone" (Yes/No, options: Yes=1/No=0)
Supported KPI types: Yes/No, Selection, Rating, Text
Options are REQUIRED for Yes/No, Selection, and Rating types. Each option needs
label(string) andweightage(integer). Rating options also needtype: "STAR". Text KPIs do not support options.Additional optional KPI fields:
is_scoring_allowed,is_critical,is_mandatory,is_comment_mandatory,is_dispute_allowed,criticality_level. All fields provided incategoriesJsonare passed through to the API.Partial failure handling: If a sub-step (category, sub-category, or KPI creation) fails, the tool returns a partial result containing the
profile_idand any categories created before the failure, along with a recovery hint.
Generate an API key for programmatic ingestion and analysis. Keys are scoped to the account.
Example:
Create a CQA API key called "support-api-key"
Note: There is a per-tenant limit on active API keys (currently 2). A 409 response means the limit is reached -- revoke an existing key first.
Create a rule that routes interactions to quality profiles based on metadata filters (e.g., route all calls with source=support to a specific quality profile).
Example:
Create an assignment rule that routes calls with source "support" to quality profile a1b2c3d4-e5f6-7890-abcd-ef1234567890 at 100% sampling
filterGroupJsonis REQUIRED. The tool will return an error if no filter is provided.Supported filter operators: IS, IS_NOT, CONTAINS, NOT_CONTAINS, GREATER_THAN, LESS_THAN, GREATER_OR_EQUAL, LESS_OR_EQUAL
Submit a single call recording or transcript for quality analysis. Provide at least one of audioUrl, transcriptUrl, or inline transcriptText (max 200KB).
Example:
Ingest interaction call-001 (voice channel) with audio at https://s3.example.com/call-001.wav in English
JWT setup tools also support list/get/update/delete/duplicate for profiles, list/update/delete for assignment rules, list/revoke for API keys, metadata config, and list analyses.
Destructive tools (delete_*, revoke_api_key) require confirm=true. Empty KPI wipe on profile update requires confirmWipeKpis=true. accountId must match cqa_account_id in the MCP auth header when that header field is set.
Submit up to 100 interactions as a single batch job.
Example:
Ingest a batch of 3 voice interactions for quality analysis
Submit a CSV file containing multiple interactions for bulk analysis.
Example:
Submit https://s3.example.com/calls.csv as a CSV file for quality analysis ingestion
Check the processing status of an ingested interaction.
Example:
Check the status of interaction call-2026-04-01-001
Monitor the progress of a batch or file ingestion job.
Example:
Track ingestion job d4f5a6b7-c8d9-4e0f-a1b2-c3d4e5f6a7b8
Retrieve the full quality scoring breakdown for a completed analysis.
Example:
Get the quality analysis for analysis ID a1b2c3d4-e5f6-7890-abcd-ef1234567890
Create and manage AI-powered VoiceBots that handle entire phone conversations autonomously.
List all VoiceBots on your account with pagination and status filtering.
Example:
List all my active VoiceBots
Create a new VoiceBot by describing its personality and purpose in natural language.
Example:
Create a VoiceBot that handles customer support for Acme Corp. It should be friendly, help with order tracking, and offer to escalate to a human agent if needed.
Place a phone call powered by a VoiceBot — the bot handles the entire conversation.
Example:
Call +919999999999 using my order-confirmation bot
Check the status, duration, and recording URL of a bot-powered call.
Example:
Get details of call abc123def456
List all phone numbers (DIDs) available on the account for use as caller IDs.
Example:
What phone numbers are available on my account?
View recent call history with status and outcomes.
Example:
Show me the last 5 bot calls
Real-time agent assist: transcription, sentiment, smart replies, disposition hints, and knowledge-base grounding for contact-center agents. Tools are prefixed exotel_aiassist_*.
Authentication: Configure ai_assist_base_url, ai_assist_account_sid, and one auth mode in the Authorization header (see AI Assist Credentials). Use exotel_aiassist_whoami to verify setup.
Read tools: list/get assistants, attachments, KB upload jobs, description templates, ASR providers, LLM languages, agents, interactions, settings, stream URLs.
Write tools: create/update/publish/archive/delete assistants and custom templates; attach/detach KB files; update descriptions. All writes require confirm=true.
Testing: exotel_aiassist_smoke_test_chat runs a WebSocket handshake against the assistant stream; exotel_aiassist_wait_for_kb_ready polls until KB indexing completes.
Example:
Run exotel_aiassist_whoami
Example:
List all AI Assist assistants on my account
Create with exotel_aiassist_create_assistant, configure ASR/language via tool args, then publish with exotel_aiassist_publish_assistant (confirm=true).
Example:
Create an AI Assist assistant named "Support Copilot" for source ameyo_6x with English STT and smart reply enabled
Attach files from a public HTTPS URL or local path, then wait for indexing.
Example:
Attach https://example.com/returns-policy.pdf to assistant abc123, then wait for KB to be ready
Security: URL fetch only allows
https://and blocks private/loopback addresses (SSRF guard).
The Exotel MCP Server uses secure token-based authentication. All your Exotel credentials are configured in the Claude desktop configuration and are used to authenticate with Exotel's APIs.
All these credentials should be properly formatted and added to your Claude configuration as shown above.
This application MUST be hosted with a public domain and HTTPS enabled for the following reasons:
FROM openjdk:21-jdk-slim
WORKDIR /app
COPY target/mcp_api-0.0.1-SNAPSHOT.jar app.jar
EXPOSE 8080
CMD ["java", "-jar", "app.jar"]
# Build and run
docker build -t exotel-mcp .
docker run -p 8080:8080 -e EXOTEL_BASE_URL=https://your-domain.com exotel-mcp
version: '3.8'
services:
app:
build: .
ports:
- "8080:8080"
environment:
- EXOTEL_BASE_URL=https://your-domain.com
nginx:
image: nginx:alpine
ports:
- "80:80"
- "443:443"
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf
- ./ssl:/etc/ssl/certs
# Server Configuration
SERVER_PORT=8080
SPRING_PROFILES_ACTIVE=production
# Application URL (CRITICAL - must match your domain)
EXOTEL_BASE_URL=https://your-domain.com
# Security
SPRING_SECURITY_REQUIRE_SSL=true
# Logging
LOGGING_LEVEL_ROOT=WARN
LOGGING_LEVEL_COM_EXAMPLE_MCP_API=INFO
{
"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','whatsapp_from':'YOUR_WHATSAPP_SENDER_E164','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','cqa_api_key':'YOUR_CQA_API_KEY','cqa_account_id':'YOUR_CQA_ACCOUNT_ID','cqa_host':'https://cqa-console.in.exotel.com','voicebot_api_key':'YOUR_VOICEBOT_API_KEY','voicebot_api_token':'YOUR_VOICEBOT_API_TOKEN','voicebot_account_id':'YOUR_VOICEBOT_ACCOUNT_ID','calls_api_key':'YOUR_CALLS_API_KEY','calls_api_token':'YOUR_CALLS_API_TOKEN','calls_account_id':'YOUR_CALLS_ACCOUNT_ID','calls_base_url':'https://api.exotel.com'}"
}
}
}
}
Note: If your server is running on plain HTTP during local development, add
"--allow-http"to theargsarray before"--header".
Use a local server when developing or when cloud MCP is unavailable. Engage SMS campaigns and all other tools work the same as production.
# From the ExotelMCP repo root
./mvnw spring-boot:run
# MCP endpoint: http://localhost:8080/mcp
# Optional: ENGAGE_BASE_URL=https://engage.exotel.com (default)
Or with Docker Compose:
docker compose up --build
Cursor — add to ~/.cursor/mcp.json (reload window after saving):
{
"mcpServers": {
"exotel-local": {
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "{'calls_api_key':'YOUR_CALLS_API_KEY','calls_api_token':'YOUR_CALLS_API_TOKEN','calls_account_id':'YOUR_ACCOUNT_SID','token':'YOUR_EXOTEL_TOKEN','account_sid':'YOUR_ACCOUNT_SID'}"
}
}
}
}
Claude Desktop / CoWork — CoWork loads the same claude_desktop_config.json. Bridge HTTP with mcp-remote and --allow-http:
{
"mcpServers": {
"exotel-local": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://localhost:8080/mcp",
"--allow-http",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "{'calls_api_key':'YOUR_CALLS_API_KEY','calls_api_token':'YOUR_CALLS_API_TOKEN','calls_account_id':'YOUR_ACCOUNT_SID','token':'YOUR_EXOTEL_TOKEN','account_sid':'YOUR_ACCOUNT_SID'}"
}
}
}
}
Fully quit and reopen Claude Desktop so CoWork picks up the server. Keep the local Java process running while you orchestrate.
Quick Audio Tools:
curl https://your-domain.com/mcp
# Should return data: {"type": "connection_established"}
nslookup your-domain.comcurl -I https://your-domain.comtail -f logs/mcp-server.logcurl https://your-domain.com/mcpmcp-remote installation: npm list -g mcp-remoteapi_key:api_secret format:) separator is included between API Key and Secret before encoding🌐 Remember: This application requires a public domain with HTTPS for production use. The domain is essential for Claude Desktop connectivity and Exotel webhook delivery.
🚀 Ready to deploy? Follow the hosting guide above and start sending SMS, making calls, and using audio tools through Claude AI!
A Model Context Protocol (MCP) server that provides seamless integration between Claude AI and Exotel's communication APIs for SMS and voice calling services, plus quick audio tools.
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
ExotelMCP yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-10-27. A Model Context Protocol (MCP) server that provides seamless integration between Claude AI and Exotel's communication APIs for SMS and voice calling services, plus quick audio tools.