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.
Features
📱 : Send single, bulk, and dynamic SMS messages with DLT compliance
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.
星标
5
工具
—
可用率
—
SMS Services
📨 Engage SMS Campaigns: Create static SMS message campaigns via Engage API
☎️ Voice Calling: Initiate voice calls, connect numbers, and integrate with call flows
📊 Status Tracking: Real-time delivery status and callback management
🎵 Quick Audio Tools: One-click audio playback, download, and web player access
🔍 Conversational Intelligence: AI-powered quality analysis of 100% of conversations across voice and digital channels
🤖 VoiceBot: Create, manage, and place AI-powered outbound calls with VoiceBots
🎧 AI Assist: Configure real-time agent assist (smart reply, transcription, KB) via MCP
🔐 Secure Authentication: Per-user token-based authentication via Authorization header
🤖 Claude AI Integration: Direct integration with Claude through MCP protocol
Note: Conversational Intelligence credentials are only required if you plan to use the quality analysis tools. SMS and Voice tools work independently.
VoiceBot Credentials:
YOUR_VOICEBOT_API_KEY: API key from the VoiceBot platform
YOUR_VOICEBOT_API_TOKEN: API token from the VoiceBot platform
YOUR_VOICEBOT_ACCOUNT_ID: Your VoiceBot account ID (e.g. ameyo5m)
YOUR_CALLS_API_KEY: Exotel CPaaS API key for placing bot-powered calls
YOUR_CALLS_API_TOKEN: Exotel CPaaS API token for placing bot-powered calls
YOUR_CALLS_ACCOUNT_ID: Exotel CPaaS account SID for calls (can differ from VoiceBot account)
calls_base_url: Exotel Calls API base URL (default: 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 uses calls_* credentials.
AI Assist Credentials:
Required for all exotel_aiassist_* tools:
ai_assist_base_url: AI Assist API host (prod: https://ai-assist.in.exotel.com)
ai_assist_account_sid: Your AI Assist tenant ID (account SID)
Auth: provide one of these modes (Twilix Basic is the default for CPaaS tenants):
Mode
Fields
Twilix Basic (recommended)
ai_assist_auth_key, ai_assist_auth_secret
Auth0 M2M
ai_assist_client_id, ai_assist_client_secret
Manual bearer
ai_assist_auth_token
Session cookie
ai_assist_session_cookie
Optional:
ai_assist_context_path: API context path (default: ai-assist/api)
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=true on the tool call.
Usage
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:
"Send an SMS to +919999999999 saying 'Hello from Claude!'"
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 Bulk SMS (Same Message)
Send the same message to multiple recipients at once.
Example:
Send "Welcome to our service!" to these numbers: +919999999999, +919888888888, +919777777777
Send Dynamic Bulk SMS
Send personalized messages to multiple recipients with different content for each.
Example:
Send personalized messages: "Hello John" to +919999999999 and "Hello Jane" to +919888888888
Engage SMS Campaigns
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
WhatsApp Services
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.
Template name is the lowercase identifier (e.g. sample_issue_resolution), not the display title.
Language code must match Meta exactly — en and en_US are different; a mismatch returns a 400.
Free text works only inside the 24-hour window — i.e. the recipient messaged your whatsapp_from number in the last 24h. To start a new conversation, use a template.
A 202 response means Exotel accepted the message (returns a sid); it does not confirm WhatsApp delivery.
Voice Services
Make Voice Call
Initiate a voice call to any phone number using your registered Exotel number.
Example:
Call +919999999999 from my registered number
Connect Two Numbers
Bridge two phone numbers in a single call, connecting them together.
Example:
Connect +919999999999 with +919888888888 in a conference call
Call Flow Integration
Connect a phone number to a predefined Exotel call flow or IVR system.
Example:
Connect +919999999999 to call flow app_id 12345
Status & Tracking Services
Check SMS Delivery Status
Get real-time delivery status and details for sent SMS messages.
Example:
Check the delivery status of SMS sent to +919999999999
Check Voice Call Status
Retrieve call details, duration, and status for voice calls.
Example:
Get call details for calls made to +919999999999
Get Call History
Retrieve bulk call details and history for analysis.
Example:
Get all call details made from +919999999999
Number Information
Get metadata and information about phone numbers.
Example:
Get information about phone number +919999999999
Audio Services
Quick Audio Tools
Quick one-click audio playback and management tools.
Quick Play Audio
Get instant clickable links to play any audio URL in your browser.
Example:
Play audio from https://example.com/song.mp3
Open Audio Player
Access the web-based audio player interface for full control.
Example:
Open the audio player interface
Quick Download
Get direct download links for any audio file.
Example:
Download audio from https://example.com/song.mp3
Conversational Intelligence Services
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:
Setup tools (login, quality profiles, API keys, assignment rules) use JWT authentication obtained via the login tool -- no pre-configured credentials needed
Ingestion & analysis tools (ingest, status, results) use your cqa_api_key configured in the MCP auth header
API 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.
Login
Authenticate with CQA to get a JWT token required for setup operations (quality profiles, API keys, assignment rules).
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) and weightage (integer). Rating options also need type: "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 in categoriesJson are 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_id and any categories created before the failure, along with a recovery hint.
Create API Key
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 Assignment Rule
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
filterGroupJson is REQUIRED. The tool will return an error if no filter is provided.
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
Quality Profile / Rule / API Key Management
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.
Ingest Batch
Submit up to 100 interactions as a single batch job.
Example:
Ingest a batch of 3 voice interactions for quality analysis
Ingest File
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
Get Interaction Status
Check the processing status of an ingested interaction.
Example:
Check the status of interaction call-2026-04-01-001
Track Job
Monitor the progress of a batch or file ingestion job.
Retrieve the full quality scoring breakdown for a completed analysis.
Example:
Get the quality analysis for analysis ID a1b2c3d4-e5f6-7890-abcd-ef1234567890
VoiceBot Services
Create and manage AI-powered VoiceBots that handle entire phone conversations autonomously.
List VoiceBots
List all VoiceBots on your account with pagination and status filtering.
Example:
List all my active VoiceBots
Create VoiceBot
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 Outbound Bot Call
Place a phone call powered by a VoiceBot — the bot handles the entire conversation.
Example:
Call +919999999999 using my order-confirmation bot
Get Call Details
Check the status, duration, and recording URL of a bot-powered call.
Example:
Get details of call abc123def456
List Phone Numbers
List all phone numbers (DIDs) available on the account for use as caller IDs.
Example:
What phone numbers are available on my account?
List Recent Calls
View recent call history with status and outcomes.
Example:
Show me the last 5 bot calls
AI Assist Services
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.
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.
Verify Credentials
Example:
Run exotel_aiassist_whoami
List Assistants
Example:
List all AI Assist assistants on my account
Create and Publish Assistant
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
Knowledge Base Upload
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).
Authentication
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.
Security Features
Secure Token Handling: Your Exotel API tokens are securely processed
User Isolation: Each user's data is kept separate and secure
DLT Compliance: Built-in support for DLT (Distributed Ledger Technology) requirements for SMS in India
🌐 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!
E
ExotelMCP
exotel·5 个星标·
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.
上次检查时间: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.