JustCall

You can empower your AI systems to make real-world voice calls and send SMS through JustCall by using the MCP Server. It provides a secure, standard interface that lets your LLMs initiate calls, manage conversations, and exchange messages with customers, turning chat into active, voice-enabled interactions.

How to use

Connect your MCP client to the JustCall MCP Server using the remote endpoint and your JustCall credentials. Once connected, you can initiate calls, fetch call details and journeys, send SMS messages, manage contacts, and receive real-time updates through SSE endpoints. Use the available tools to query call history, send messages, and track analytics. Ensure you always include a valid Bearer token for authentication when accessing protected endpoints, and respect the rate limits of your JustCall API key.

How to install

# Prerequisites
- Node.js 18+ or Python 3.11+ (depending on your runtime preference)
- Access to the internet
- A JustCall account with API credentials

# Install for HTTP-based MCP usage (example)
# No local server installation is required in this case since you connect to the remote MCP URL

Configuration and usage notes

Configure your MCP client to point to the remote MCP URL and provide your JustCall API credentials as a Bearer token. The primary remote endpoint is: https://mcp.justcall.host/mcp. Include the API credentials in the Authorization header as a Bearer token: Authorization: Bearer <JWT_TOKEN> or Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>.

Security considerations

Use OAuth2 with PKCE for secure access to endpoints. Protect tokens and API keys, rotate credentials regularly, and enforce least-privilege access for clients integrating with the MCP server. Ensure TLS is used for all communications with the MCP endpoint.

Troubleshooting

If you encounter authentication errors, verify that your API key and secret are correctly configured and that the Bearer token is valid. Check rate limits in your JustCall account and ensure your MCP client time is synchronized to avoid PKCE issues. For connection problems, confirm that the MCP URL is reachable and that network firewalls allow outbound requests to the JustCall API.

Notes

Public health checks are available at /health. OAuth metadata is exposed at /.well-known/oauth-authorization-server. Use the specified endpoints and headers to interact with MCP resources securely.

Available tools

list_calls

Lists all JustCall calls with various filtering options

get_call

Get a specific JustCall call by ID

update_call

Update a call's disposition, notes, or rating

get_call_journey

Fetch the event sequence for a specific call

get_voice_agent_data

Retrieve voice agent data for a specific call (deprecated)

get_voice_agent_call

Retrieve voice agent data related to a specific call

list_users

List all users or agents in the account

get_user

Get detailed information for a specific user/agent

update_user_availability

Update whether a user is available for calls

send_sms

Send an SMS to a contact

list_sms

Retrieve all SMS messages

get_sms

Get details for a specific SMS message

check_sms_reply

Check for the most recent inbound reply from a contact

list_sms_tags

Retrieve all SMS tags used for organizing conversations

get_sms_tag

Get details 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 for a JustCall number

get_sms_thread

Retrieve a specific SMS thread by ID

add_sms_thread_tag

Add a tag to an SMS thread

list_contacts

Retrieve all CRM contacts

get_contact

Get details for a specific contact by ID

create_contact

Create a new CRM contact

update_contact

Update details of an existing contact

update_contact_status

Update a contact's DND/Blacklist status

add_contacts_blacklist

Add contacts to the global blacklist in bulk

get_agent_analytics

Retrieve agent analytics data for a date range

get_account_analytics

Retrieve account analytics data for a date range

get_number_analytics

Retrieve number analytics data for a date range

get_sales_dialer_analytics

Retrieve sales dialer analytics data

list_webhooks

Retrieve all configured webhooks

create_webhook

Create a new webhook endpoint for real-time notifications

list_numbers

Retrieve all JustCall phone numbers

get_number

Retrieve details for a specific phone number

list_user_groups

Retrieve all user groups

get_user_group

Retrieve details for a specific user group by ID

list_appointment_slots

Retrieve available appointment slots for a calendar

create_appointment

Schedule a new appointment on a calendar

get_appointment

Retrieve details of a specific appointment by ID

list_whatsapp_messages

Retrieve all WhatsApp messages for the account

get_whatsapp_message

Retrieve details for a specific WhatsApp message

send_whatsapp_message

Send a WhatsApp message to a contact

list_whatsapp_templates

Retrieve all WhatsApp templates available in the account

check_whatsapp_message_reply

Check for the most recent inbound WhatsApp message from a contact

list_calls_ai_analysis

Retrieve AI-generated analysis for all calls (transcriptions, summaries, insights)

get_call_ai_analysis

Retrieve AI-generated analysis for a specific call

list_meetings_ai_analysis

Retrieve AI-generated analysis for recorded meetings

get_meeting_ai_analysis

Retrieve AI-generated analysis for a specific meeting

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

list_campaigns

Retrieve all sales dialer campaigns

get_campaign

Retrieve details for a specific campaign

create_campaign

Create a new campaign

update_campaign

Update campaign details

list_salesdialer_campaign_contacts

Retrieve all contacts in a campaign

add_salesdialer_campaign_contact

Add a contact to a campaign

list_salesdialer_contacts

Retrieve all sales dialer contacts

get_salesdialer_contact

Retrieve a specific sales dialer contact by ID

create_salesdialer_contact

Create a new sales dialer contact

update_salesdialer_contact

Update a sales dialer contact

import_salesdialer_contacts

Import multiple contacts into Sales Dialer or a campaign

import_salesdialer_contacts_status

Check bulk import status by batch ID

add_salesdialer_contacts_dnca

Add contacts to the Do Not Call Again list in bulk

list_salesdialer_custom_fields

Fetch all custom fields defined in Sales Dialer

list_salesdialer_calls

Retrieve all calls made via the Sales Dialer

get_salesdialer_call

Retrieve details for a specific Sales Dialer call

get_sales_dialer_analytics

Retrieve analytics for sales dialer campaigns

get_salesdialer_agent_analytics

Retrieve agent analytics for a campaign