saaslabsco avatar

JustCall MCP Server

saaslabsco/justcall-mcp-server

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.

GitHub stars
26
tools
29
transport
HTTP, SSE
last updated
Dec 2, 2025

Tools

29 tools

Public tool metadata for what this MCP can expose to an agent.

list_callsLists all JustCall calls17 params

Lists all JustCall calls

Parameters* required
agent_idnumber
ID of the agent for whom the calls are to be fetched. Agent ID can be accessed using List all users API
call_directionstring
Enter the direction of calls (incoming/outgoing) to be fetchedone of Incoming · Outgoing
call_traitsarray
Select one or more traits associated with a call to fetch all calls containing those traits
call_typestring
Enter 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_BLOCKED
contact_numbernumber
Number of the contact for which calls are to be fetched. Please provide a valid contact number with country code
disposition_codesarray
Filter calls by the disposition code (call outcome) added by the agent at the end of each call
fetch_ai_databoolean
Set fetch_ai_data to true to fetch coaching data by Justcall AI. Default entry is false
fetch_queue_databoolean
Set fetch_queue_data to true to fetch queue data like callback time, callback status, callback wait duration, etc. Default entry is false
from_datetimestring
Datetime 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_digitnumber
Enter 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_numbernumber
JustCall number for which the calls are to be fetched
last_call_id_fetchednumber
Id 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
orderstring
Order in which the calls list should appear based on the sort parameter selected aboveone of asc · desc
pagenumber
Page number for which calls are to be fetched
per_pagenumber
Number of calls to be fetched per page. Default value is 20 and maximum value is 100
sortstring
Select a parameter to sort the order of calls. By default we apply sorting on id fieldone of id · datetime
to_datetimestring
Datetime 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_databoolean
Set fetch_ai_data to true to fetch coaching data by Justcall AI. Default entry is false
fetch_queue_databoolean
Set fetch_queue_data to true to fetch queue data like callback time, callback status, callback wait duration, etc. Default entry is false
idnumber
Unique id of the call generated by JustCall
update_callUpdate a JustCall call4 params

Update a JustCall call

Parameters* required
dispositionstring
Call disposition
idnumber
Unique id of the call generated by JustCall
notesstring
Call notes
ratingnumber
Call rating
get_call_journeyGet call journey details1 params

Get call journey details

Parameters* required
idnumber
Unique id of the call generated by JustCall
get_voice_agent_dataGet voice agent data1 params

Get voice agent data

Parameters* required
idnumber
Unique 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
pagenumber
Page number for pagination
per_pagenumber
Number of users per page
statusstring
Filter users by statusone of active · inactive · all
get_userGet detailed information for a specific user/agent1 params

Get detailed information for a specific user/agent

Parameters* required
idnumber
Unique identifier of the user
send_smsSend an SMS/text message to a contact4 params

Send an SMS/text message to a contact

Parameters* required
bodystring
Text message content
fromstring
Sender JustCall phone number
media_urlsarray
Array of media URLs to attach to the message
tostring
Recipient phone number with country code
list_smsRetrieve all SMS/text messages4 params

Retrieve all SMS/text messages

Parameters* required
contact_numberstring
Contact phone number to filter messages
directionstring
Message direction filterone of sent · received · failed
from_datetimestring
Start datetime in yyyy-mm-dd hh:mm:ss or yyyy-mm-dd format
to_datetimestring
End 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
idnumber
Unique 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_numberstring
Contact phone number to check for replies (E.164 format)
justcall_numberstring
JustCall 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
pagenumber
Page number for pagination
per_pagenumber
Number 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
idnumber
Unique 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
colorstring
Color code for the tag (hex format)
namestring
Name of the SMS tag
delete_sms_tagDelete a specific SMS tag1 params

Delete a specific SMS tag

Parameters* required
idnumber
Unique identifier of the SMS tag to delete
list_contactsRetrieve all contacts from the CRM6 params

Retrieve all contacts from the CRM

Parameters* required
contact_numberstring
Phone number of the contact
first_namestring
First name of the contact
last_namestring
Last name of the contact
orderstring
Order 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 · desc
pagenumber
Page number for which contacts are to be fetched. Page number '0' indicates first page containing records.
per_pagenumber
Number 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_teamboolean
Choose to add a contact for all agents or only for the account owner
addressstring
Address of the contact
agent_idnumber
Specify the agent_id to create contact only for a specific agent
agent_idsarray
Specify the agent_ids to create contact only for a specific agents
companystring
Company with which the contact is associated
contact_numberstring
Phone number of the contact
emailstring
Email id of the contact
extensionnumber
Assign an extension to the contact
first_namestring
First name of the contact
last_namestring
Last name of the contact
notesstring
Additional information added for the contact in JustCall
other_numbersarray
Other 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_idnumber
Agent ID to filter analytics
from_datestring
Start date (yyyy-mm-dd)
to_datestring
End 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_datestring
Start date (yyyy-mm-dd)
to_datestring
End 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_datestring
Start date (yyyy-mm-dd)
justcall_numbernumber
JustCall number for which the analytics are to be fetched.
to_datestring
End date (yyyy-mm-dd)
list_webhooksRetrieve all configured webhooks4 params

Retrieve all configured webhooks

Parameters* required
event_typestring
Filter webhooks by event type
pagenumber
Page number for pagination
per_pagenumber
Number of webhooks per page
statusstring
Filter webhooks by statusone of active · inactive · failed
create_webhookCreate a new webhook endpoint to receive real-time notifications4 params

Create a new webhook endpoint to receive real-time notifications

Parameters* required
descriptionstring
Description of the webhook
eventsarray
Array of event types to subscribe to
secretstring
Secret key for webhook signature verification
urlstring
Webhook URL endpoint
list_numbersRetrieve all JustCall phone numbers5 params

Retrieve all JustCall phone numbers

Parameters* required
country_codestring
Filter numbers by country code
pagenumber
Page number for pagination
per_pagenumber
Number of phone numbers per page
statusstring
Filter numbers by statusone of active · inactive · pending
typestring
Filter numbers by typeone of local · toll_free · international
get_numberRetrieve detailed information for a specific JustCall phone number1 params

Retrieve detailed information for a specific JustCall phone number

Parameters* required
idnumber
Unique identifier of the phone number
list_campaignsRetrieve all sales dialer campaigns9 params

Retrieve all sales dialer campaigns

Parameters* required
contact_numberstring
Contact number to filter by
from_datetimestring
Start datetime for filtering campaigns
last_campaign_id_fetchednumber
Last campaign ID fetched
orderstring
Order for sorting
pagenumber
Page number for pagination
per_pagenumber
Number of campaigns per page
sales_dialer_numberstring
Sales dialer number to filter by
to_datetimestring
End datetime for filtering campaigns
typestring
Campaign type filter
get_campaignRetrieve detailed information for a specific sales dialer campaign1 params

Retrieve detailed information for a specific sales dialer campaign

Parameters* required
idnumber
Unique identifier of the campaign
create_campaignCreate a new sales dialer campaign12 params

Create a new sales dialer campaign

Parameters* required
abandoning_message_idnumber
ID of the abandoning audio message
assign_agentsstring
Comma separated IDs of agents to assign to the campaign
call_forwarding_numberstring
Number to which incoming calls should be forwarded
call_scriptsstring
Comma separated IDs of Call Scripts
contact_dialing_orderstring
Order in which contacts are dialedone of first_in_first_out · last_in_first_out
country_codestring
Default country code for phone numbers where the country code is not present
default_numberstring
Set a default phone number for the campaign
disposition_groupsstring
Comma separated IDs of Disposition Groups
maximum_calls_per_agentnumber
Maximum number of calls allowed per agent (2-10, only for Predictive)
namestring
Provide a name for the campaign
typestring
Select a type from Autodial, Predictive, or Dynamicone of Autodial · Predictive · Dynamic
voicemail_message_idnumber
ID 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_idnumber
Updated abandoning message ID
assign_agentsstring
Updated comma separated agent IDs
call_forwarding_numberstring
Updated call forwarding number
call_scriptsstring
Updated call scripts
contact_dialing_orderstring
Updated dialing orderone of first_in_first_out · last_in_first_out
default_numberstring
Updated default phone number
disposition_groupsstring
Updated disposition groups
idnumber
Unique identifier of the campaign
maximum_calls_per_agentnumber
Updated maximum calls per agent
namestring
Updated name of the campaign
typestring
Updated campaign typeone of Autodial · Predictive · Dynamic
voicemail_message_idnumber
Updated 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_idnumber
Specific agent ID to filter analytics
campaign_idnumber
Specific campaign ID to filter analytics
from_datestring
Start date for analytics (yyyy-mm-dd)
to_datestring
End date for analytics (yyyy-mm-dd)
typestring
Type of analytics to retrieveone of overview · detailed · performance

Sponsors

Readme

JustCall 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


View the full README on GitHub

Details

Repository
github.com/saaslabsco/justcall-mcp-server
Website
justcall.io
Categories
Communication & Messaging, Automation & Workflows
Transport
HTTP, SSE
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1akougkas avatarZulipChat MCP Serverakougkas/zulipchat-mcpZulipChat MCP: Connect AI to Zulip with 60+ tools for messaging, streams, events, and analytics18stars
2mindstone avatarHubSpotmindstone/mcp-serversHubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads0stars
3selenium39 avatarMcp Server Tempmailselenium39/mcp-server-tempmailMCP server for temporary email management using ChatTempMail API9stars
4emailens avatarEmailens MCPemailens/mcpAnalyze, audit, fix and diff HTML, MJML, Maizzle and React Email across 21 email clients.0stars
5dappros avatarEthora Mcp Serverdappros/ethora-mcp-serverEthora chat platform MCP: apps, users, rooms, AI agents, chat widgets. Hosted or stdio.6stars
6nestr-dev avatarMcpnestr-dev/nestr-mcpConnect AI to Nestr for Holacracy, Sociocracy, and self-organizing teams.6stars