Summary
Bridges LLMs to JustCall's telephony platform so your AI agents can actually make calls and send texts. Exposes 66+ tools across calls, SMS, contacts, users, analytics, and webhooks. You get functions for sending messages, initiating voice calls, managing contact lists, updating agent availability, and pulling conversation threads. Includes OAuth2 authentication and works with both streamable HTTP and SSE transports. Reach for this when you need Claude or ChatGPT to handle real phone interactions, like having an AI assistant schedule calls, follow up via SMS based on conversation context, or pull call analytics without leaving the chat interface. Requires JustCall API credentials from your dashboard.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
29 tools
list_callsLists all JustCall calls17 params
Lists all JustCall calls
Parameters* required
agent_idnumberID of the agent for whom the calls are to be fetched. Agent ID can be accessed using List all users API
call_directionstringEnter the direction of calls (incoming/outgoing) to be fetchedone of
Incoming · Outgoingcall_traitsarraySelect one or more traits associated with a call to fetch all calls containing those traits
call_typestringEnter the type of calls (answered, unanswered, missed, voicemail, abandoned) that need to be fetchedone of
OUTGOING_ANSWERED · OUTGOING_UNANSWERED · OUTGOING_BUSY · OUTGOING_FAILED · OUTGOING_RESTRICTED · OUTGOING_BLOCKEDcontact_numbernumberNumber of the contact for which calls are to be fetched. Please provide a valid contact number with country code
disposition_codesarrayFilter calls by the disposition code (call outcome) added by the agent at the end of each call
fetch_ai_databooleanSet fetch_ai_data to true to fetch coaching data by Justcall AI. Default entry is false
fetch_queue_databooleanSet fetch_queue_data to true to fetch queue data like callback time, callback status, callback wait duration, etc. Default entry is false
from_datetimestringDatetime in yyyy-mm-dd hh:mm:ss or yyyy-mm-dd format starting from when the calls are to be fetched in user's timezone
ivr_digitnumberEnter the IVR digit the calls routed through which need to be filtered (optional). Note: call_direction and call_type filter won't work in case you send ivr_digit
justcall_numbernumberJustCall number for which the calls are to be fetched
last_call_id_fetchednumberId of the last call fetched in the previous query. This Id ensures that you won't receive any duplicate data when using the next_page_link parameter
orderstringOrder in which the calls list should appear based on the sort parameter selected aboveone of
asc · descpagenumberPage number for which calls are to be fetched
per_pagenumberNumber of calls to be fetched per page. Default value is 20 and maximum value is 100
sortstringSelect a parameter to sort the order of calls. By default we apply sorting on id fieldone of
id · datetimeto_datetimestringDatetime in yyyy-mm-dd hh:mm:ss or yyyy-mm-dd format till when the calls are to be fetched in user's timezone
get_callGet a specific JustCall call by ID3 params
Get a specific JustCall call by ID
Parameters* required
fetch_ai_databooleanSet fetch_ai_data to true to fetch coaching data by Justcall AI. Default entry is false
fetch_queue_databooleanSet fetch_queue_data to true to fetch queue data like callback time, callback status, callback wait duration, etc. Default entry is false
idnumberUnique id of the call generated by JustCall
update_callUpdate a JustCall call4 params
Update a JustCall call
Parameters* required
dispositionstringCall disposition
idnumberUnique id of the call generated by JustCall
notesstringCall notes
ratingnumberCall rating
get_call_journeyGet call journey details1 params
Get call journey details
Parameters* required
idnumberUnique id of the call generated by JustCall
get_voice_agent_dataGet voice agent data1 params
Get voice agent data
Parameters* required
idnumberUnique id of the call generated by JustCall
list_usersList all users/agents in the account3 params
List all users/agents in the account
Parameters* required
pagenumberPage number for pagination
per_pagenumberNumber of users per page
statusstringFilter users by statusone of
active · inactive · allget_userGet detailed information for a specific user/agent1 params
Get detailed information for a specific user/agent
Parameters* required
idnumberUnique identifier of the user
send_smsSend an SMS/text message to a contact4 params
Send an SMS/text message to a contact
Parameters* required
bodystringText message content
fromstringSender JustCall phone number
media_urlsarrayArray of media URLs to attach to the message
tostringRecipient phone number with country code
list_smsRetrieve all SMS/text messages4 params
Retrieve all SMS/text messages
Parameters* required
contact_numberstringContact phone number to filter messages
directionstringMessage direction filterone of
sent · received · failedfrom_datetimestringStart datetime in yyyy-mm-dd hh:mm:ss or yyyy-mm-dd format
to_datetimestringEnd datetime in yyyy-mm-dd hh:mm:ss or yyyy-mm-dd format
get_smsGet detailed information for a specific SMS/text message1 params
Get detailed information for a specific SMS/text message
Parameters* required
idnumberUnique identifier of the SMS/text message
check_sms_replyCheck for the most recent inbound SMS reply from a specific contact2 params
Check for the most recent inbound SMS reply from a specific contact
Parameters* required
contact_numberstringContact phone number to check for replies (E.164 format)
justcall_numberstringJustCall number to filter replies (E.164 format)
list_sms_tagsRetrieve all SMS tags used for organizing text messages2 params
Retrieve all SMS tags used for organizing text messages
Parameters* required
pagenumberPage number for pagination
per_pagenumberNumber of tags per page
get_sms_tagGet detailed information for a specific SMS tag1 params
Get detailed information for a specific SMS tag
Parameters* required
idnumberUnique identifier of the SMS tag
create_sms_tagCreate a new tag for organizing SMS conversations2 params
Create a new tag for organizing SMS conversations
Parameters* required
colorstringColor code for the tag (hex format)
namestringName of the SMS tag
delete_sms_tagDelete a specific SMS tag1 params
Delete a specific SMS tag
Parameters* required
idnumberUnique identifier of the SMS tag to delete
list_contactsRetrieve all contacts from the CRM6 params
Retrieve all contacts from the CRM
Parameters* required
contact_numberstringPhone number of the contact
first_namestringFirst name of the contact
last_namestringLast name of the contact
orderstringOrder in which the contacts list should appear based on the 'id' of the contact. Recently added contacts are represented by larger 'id' values. Defaults to DESC (descending order).one of
asc · descpagenumberPage number for which contacts are to be fetched. Page number '0' indicates first page containing records.
per_pagenumberNumber of contacts to be fetched per page. Default value is 50 and maximum value is 500.
create_contactCreate a new contact in the CRM12 params
Create a new contact in the CRM
Parameters* required
across_teambooleanChoose to add a contact for all agents or only for the account owner
addressstringAddress of the contact
agent_idnumberSpecify the agent_id to create contact only for a specific agent
agent_idsarraySpecify the agent_ids to create contact only for a specific agents
companystringCompany with which the contact is associated
contact_numberstringPhone number of the contact
emailstringEmail id of the contact
extensionnumberAssign an extension to the contact
first_namestringFirst name of the contact
last_namestringLast name of the contact
notesstringAdditional information added for the contact in JustCall
other_numbersarrayOther phone numbers associated with the contact
get_agent_analyticsRetrieve agent analytics data for specified date range3 params
Retrieve agent analytics data for specified date range
Parameters* required
agent_idnumberAgent ID to filter analytics
from_datestringStart date (yyyy-mm-dd)
to_datestringEnd date (yyyy-mm-dd)
get_account_analyticsRetrieve account analytics data for specified date range2 params
Retrieve account analytics data for specified date range
Parameters* required
from_datestringStart date (yyyy-mm-dd)
to_datestringEnd date (yyyy-mm-dd)
get_number_analyticsRetrieve number analytics data for specified date range3 params
Retrieve number analytics data for specified date range
Parameters* required
from_datestringStart date (yyyy-mm-dd)
justcall_numbernumberJustCall number for which the analytics are to be fetched.
to_datestringEnd date (yyyy-mm-dd)
list_webhooksRetrieve all configured webhooks4 params
Retrieve all configured webhooks
Parameters* required
event_typestringFilter webhooks by event type
pagenumberPage number for pagination
per_pagenumberNumber of webhooks per page
statusstringFilter webhooks by statusone of
active · inactive · failedcreate_webhookCreate a new webhook endpoint to receive real-time notifications4 params
Create a new webhook endpoint to receive real-time notifications
Parameters* required
descriptionstringDescription of the webhook
eventsarrayArray of event types to subscribe to
secretstringSecret key for webhook signature verification
urlstringWebhook URL endpoint
list_numbersRetrieve all JustCall phone numbers5 params
Retrieve all JustCall phone numbers
Parameters* required
country_codestringFilter numbers by country code
pagenumberPage number for pagination
per_pagenumberNumber of phone numbers per page
statusstringFilter numbers by statusone of
active · inactive · pendingtypestringFilter numbers by typeone of
local · toll_free · internationalget_numberRetrieve detailed information for a specific JustCall phone number1 params
Retrieve detailed information for a specific JustCall phone number
Parameters* required
idnumberUnique identifier of the phone number
list_campaignsRetrieve all sales dialer campaigns9 params
Retrieve all sales dialer campaigns
Parameters* required
contact_numberstringContact number to filter by
from_datetimestringStart datetime for filtering campaigns
last_campaign_id_fetchednumberLast campaign ID fetched
orderstringOrder for sorting
pagenumberPage number for pagination
per_pagenumberNumber of campaigns per page
sales_dialer_numberstringSales dialer number to filter by
to_datetimestringEnd datetime for filtering campaigns
typestringCampaign type filter
get_campaignRetrieve detailed information for a specific sales dialer campaign1 params
Retrieve detailed information for a specific sales dialer campaign
Parameters* required
idnumberUnique identifier of the campaign
create_campaignCreate a new sales dialer campaign12 params
Create a new sales dialer campaign
Parameters* required
abandoning_message_idnumberID of the abandoning audio message
assign_agentsstringComma separated IDs of agents to assign to the campaign
call_forwarding_numberstringNumber to which incoming calls should be forwarded
call_scriptsstringComma separated IDs of Call Scripts
contact_dialing_orderstringOrder in which contacts are dialedone of
first_in_first_out · last_in_first_outcountry_codestringDefault country code for phone numbers where the country code is not present
default_numberstringSet a default phone number for the campaign
disposition_groupsstringComma separated IDs of Disposition Groups
maximum_calls_per_agentnumberMaximum number of calls allowed per agent (2-10, only for Predictive)
namestringProvide a name for the campaign
typestringSelect a type from Autodial, Predictive, or Dynamicone of
Autodial · Predictive · Dynamicvoicemail_message_idnumberID of the voicemail audio message
update_campaignUpdate campaign details including name, description, status, and assignments12 params
Update campaign details including name, description, status, and assignments
Parameters* required
abandoning_message_idnumberUpdated abandoning message ID
assign_agentsstringUpdated comma separated agent IDs
call_forwarding_numberstringUpdated call forwarding number
call_scriptsstringUpdated call scripts
contact_dialing_orderstringUpdated dialing orderone of
first_in_first_out · last_in_first_outdefault_numberstringUpdated default phone number
disposition_groupsstringUpdated disposition groups
idnumberUnique identifier of the campaign
maximum_calls_per_agentnumberUpdated maximum calls per agent
namestringUpdated name of the campaign
typestringUpdated campaign typeone of
Autodial · Predictive · Dynamicvoicemail_message_idnumberUpdated voicemail message ID
get_sales_dialer_analyticsRetrieve comprehensive analytics data for sales dialer campaigns5 params
Retrieve comprehensive analytics data for sales dialer campaigns
Parameters* required
agent_idnumberSpecific agent ID to filter analytics
campaign_idnumberSpecific campaign ID to filter analytics
from_datestringStart date for analytics (yyyy-mm-dd)
to_datestringEnd date for analytics (yyyy-mm-dd)
typestringType of analytics to retrieveone of
overview · detailed · performanceJustCall MCP Server
The JustCall Model Context Protocol (MCP) Server lets Large Language Models (LLMs) and AI agents make real-world voice calls and send SMS directly through JustCall’s APIs — securely, contextually, and programmatically.
It provides a function-calling interface for conversational AI systems, enabling:
- 📞 AI-powered calling: Let your LLM initiate, manage, or transcribe calls using JustCall.
- 💬 Smart messaging: Allow your AI agent to send or respond to SMS within conversations.
- ⚙️ Seamless integration: Use the MCP standard to connect JustCall’s telephony capabilities with any LLM runtime or orchestration framework.
In short: It gives your LLMs a voice and a phone number — turning chatbots into truly conversational agents.
Claude Desktop Setup
- Open
Claude Desktopand pressCMD + ,to go toSettings. - Click on the
Connectorstab. - Click on the
Add Custom Connectorbutton. - Add name as
JustCalland Remote Server Url ashttps://mcp.justcall.host/mcp. - Now on
JustCallfrom the Connectors list click onConnectbutton for JustCall. - It will open a JustCall page requesting API key and secret.
- Get your JustCall API Key & Secret from the JustCall dashboard (https://app.justcall.io/app/developersApiCredentials).
- Enter the API key and Secret and press Continue, it should redirect back you to Claude.
Claude Web - https://claude.ai
- Open connectors url in your Browser - https://claude.ai/settings/connectors.
- Click on the
Connectorstab. - Click on the
Add Custom Connectorbutton. - Add name as
JustCalland Remote Server Url ashttps://mcp.justcall.host/mcp. - Now on
JustCallfrom the Connectors list click onConnectbutton for JustCall. - It will open a JustCall page requesting API key and secret.
- Get your JustCall API Key & Secret from the JustCall dashboard (https://app.justcall.io/app/developersApiCredentials).
- Enter the API key and Secret and press Continue, it should redirect back you to Claude.
Chat GPT (Only available on Plus, Pro, Business and Enterprise)
- Open connectors url in your Browser - https://chatgpt.com/#settings/Connectors.
- Click on the
Apps & Connectorstab. - Ensure developer mode is enabled in advanced settings
- Click on the
Createbutton. - Add name as
JustCalland MCP Server Url ashttps://mcp.justcall.host/mcp. You can skip other fields. - Now on
JustCallfrom the Connectors list click onConnectbutton for JustCall. - It will open a JustCall page requesting API key and secret.
- Get your JustCall API Key & Secret from the JustCall dashboard (https://app.justcall.io/app/developersApiCredentials).
- Enter the API key and Secret and press Continue, it should redirect back you to Chat GPT.
Remote MCP
To connect to JustCall's MCP server remotely:
Streamable HTTP (Recommended)
The default and recommended way to connect is via Streamable HTTP Transport:
- Connect to
https://mcp.justcall.host/mcpfrom any MCP client using Streamable HTTP Transport - Include your JustCall API key as a bearer token in the request headers
- Example header:
Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>
Authentication & Security
The JustCall MCP Server implements OAuth2 authentication for secure access to all endpoints.
OAuth2 Configuration
The server supports OAuth2 authorization with the following features:
- Authorization Endpoint: OAuth2 authorization server metadata is available at
/.well-known/oauth-authorization-server - Grant Type: Authorization code flow with PKCE (Proof Key for Code Exchange)
- Code Challenge Method: S256 (SHA-256)
- Token Authentication: All MCP and SSE endpoints require Bearer token authentication
Protected Endpoints
The following endpoints require valid Bearer token authentication:
/mcp- Main MCP endpoint/sse- Server-Sent Events endpoint/sse/message- SSE message endpoint
Authentication Header Format
Include your JustCall API credentials as a Bearer token:
Authorization: Bearer <JWT_TOKEN_BY_OAUTH>
Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>
Public Endpoints
The following endpoints are publicly accessible:
/health- Health check endpoint (returns 200 OK)/.well-known/oauth-authorization-server- OAuth2 authorization server metadata
API Usage & Rate Limits
This MCP server uses the JustCall Developer API. All API requests are subject to the rate limits associated with your JustCall API key. Please refer to your JustCall API credentials configuration.
Available Tools
The JustCall MCP Server provides 66 tools organized into the following categories:
JustCall API Tools
📞 Calls (6 tools)
- list_calls - Lists all JustCall calls with various filtering options
- get_call - Get a specific JustCall call by ID
- update_call - Update a JustCall call (disposition, notes, rating)
- get_call_journey - Fetch the sequence of events for a specific call
- get_voice_agent_data - Get voice agent data for a specific call (deprecated, use get_voice_agent_call)
- get_voice_agent_call - Retrieve voice agent related data for a specific call
👥 Users & Agents (3 tools)
- list_users - List all users/agents in the account
- get_user - Get detailed information for a specific user/agent
- update_user_availability - Update a user's availability status to available or unavailable for calls
💬 SMS & Messaging (11 tools)
- send_sms - Send an SMS/text message to a contact
- list_sms - Retrieve all SMS/text messages
- get_sms - Get detailed information for a specific SMS/text message
- check_sms_reply - Check for the most recent inbound SMS reply from a specific contact
- list_sms_tags - Retrieve all SMS tags used for organizing text messages
- get_sms_tag - Get detailed information for a specific SMS tag
- create_sms_tag - Create a new tag for organizing SMS conversations
- delete_sms_tag - Delete a specific SMS tag
- list_sms_threads - Retrieve all SMS threads/conversations associated with a JustCall number
- get_sms_thread - Retrieve a specific SMS thread/conversation by ID
- add_sms_thread_tag - Add tag to an SMS thread/conversation
📇 Contacts (6 tools)
- list_contacts - Retrieve all contacts from the CRM
- get_contact - Retrieve detailed information for a specific contact by ID
- create_contact - Create a new contact in the CRM
- update_contact - Update/modify details of an existing contact
- update_contact_status - Add or remove a contact from DND/DNM/Blacklist lists
- add_contacts_blacklist - Add one or more contacts to the global blacklist in bulk
📊 Analytics (4 tools)
- get_agent_analytics - Retrieve agent analytics data for specified date range
- get_account_analytics - Retrieve account analytics data for specified date range
- get_number_analytics - Retrieve number analytics data for specified date range
- get_sales_dialer_analytics - Retrieve comprehensive analytics data for sales dialer campaigns
🔔 Webhooks (2 tools)
- list_webhooks - Retrieve all configured webhooks
- create_webhook - Create a new webhook endpoint to receive real-time notifications
📱 Phone Numbers (2 tools)
- list_numbers - Retrieve all JustCall phone numbers
- get_number - Retrieve detailed information for a specific JustCall phone number
👥 User Groups (2 tools)
- list_user_groups - Retrieve all user groups defined in the account
- get_user_group - Retrieve detailed information for a specific user group by ID
📅 Appointments (3 tools)
- list_appointment_slots - Retrieve all available time slots for appointments on a specific calendar
- create_appointment - Schedule a new appointment on a specific calendar
- get_appointment - Retrieve details of a specific appointment by its ID
💚 WhatsApp (5 tools)
- list_whatsapp_messages - Retrieve all WhatsApp messages associated with the account
- get_whatsapp_message - Retrieve detailed information for a specific WhatsApp message by ID
- send_whatsapp_message - Send a new WhatsApp message to a contact number
- list_whatsapp_templates - Retrieve all WhatsApp message templates available in the account
- check_whatsapp_message_reply - Check for the most recent inbound WhatsApp message from a contact
🤖 AI Analysis (4 tools)
- list_calls_ai_analysis - Retrieve AI-generated analysis (transcription, summary, insights) for all calls
- get_call_ai_analysis - Retrieve AI-generated analysis for a specific call by Call ID
- list_meetings_ai_analysis - Retrieve AI-generated analysis for recorded meetings (Zoom, Google Meet)
- get_meeting_ai_analysis - Retrieve AI-generated analysis for a specific meeting by Instance ID
🎙️ Voice Agents (2 tools)
- list_voice_agents - Retrieve all AI voice agents associated with the account
- create_voice_agent_call - Initiate an outbound call from a configured AI voice agent to a contact
Sales Dialer Tools
📢 Campaigns (6 tools)
- list_campaigns - Retrieve all sales dialer campaigns
- get_campaign - Retrieve detailed information for a specific sales dialer campaign
- create_campaign - Create a new sales dialer campaign
- update_campaign - Update campaign details including name, description, status, and assignments
- list_salesdialer_campaign_contacts - Retrieve all contacts in a specific campaign
- add_salesdialer_campaign_contact - Add contact to a specific campaign
👥 Contacts (8 tools)
- list_salesdialer_contacts - Retrieve all contacts from Sales Dialer
- get_salesdialer_contact - Retrieve detailed information for a specific contact by ID
- create_salesdialer_contact - Create a new contact in Sales Dialer
- update_salesdialer_contact - Update/modify details of an existing contact
- import_salesdialer_contacts - Import multiple contacts into Sales Dialer or a campaign in bulk
- import_salesdialer_contacts_status - Check the status of a bulk import job by batch ID
- add_salesdialer_contacts_dnca - Add one or more contacts to the "Do Not Call Again" list in bulk
- list_salesdialer_custom_fields - Fetch all custom contact fields defined in Sales Dialer
📞 Calls (2 tools)
- list_salesdialer_calls - Retrieve all calls made via the Sales Dialer
- get_salesdialer_call - Retrieve detailed information for a specific Sales Dialer call by ID
📊 Analytics (2 tools)
- get_sales_dialer_analytics - Retrieve comprehensive analytics data for sales dialer campaigns
- get_salesdialer_agent_analytics - Retrieve call performance analytics of a specific agent for a campaign.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Registryactive
TransportHTTP, SSE
UpdatedDec 2, 2025
