{
  "markdown": "# JustCall MCP Server\n\nThe JustCall [Model Context Protocol (MCP)](https://modelcontextprotocol.com/) 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.\n\nIt provides a function-calling interface for conversational AI systems, enabling:\n\n- 📞 AI-powered calling: Let your LLM initiate, manage, or transcribe calls using JustCall.\n- 💬 Smart messaging: Allow your AI agent to send or respond to SMS within conversations.\n- ⚙️ Seamless integration: Use the MCP standard to connect JustCall’s telephony capabilities with any LLM runtime or orchestration framework.\n\nIn short: It gives your LLMs a voice and a phone number — turning chatbots into truly conversational agents.\n\n## Claude Desktop Setup\n\n1. Open `Claude Desktop` and press `CMD + ,` to go to `Settings`.\n2. Click on the `Connectors` tab.\n3. Click on the `Add Custom Connector` button.\n4. Add name as `JustCall` and Remote Server Url as `https://mcp.justcall.host/mcp`.\n5. Now on `JustCall` from the Connectors list click on `Connect` button for JustCall.\n6. It will open a JustCall page requesting API key and secret.\n7. Get your JustCall API Key & Secret from the JustCall dashboard (<https://app.justcall.io/app/developersApiCredentials>).\n8. Enter the API key and Secret and press Continue, it should redirect back you to Claude.\n\n## Claude Web - https://claude.ai\n\n1. Open connectors url in your Browser - <https://claude.ai/settings/connectors>.\n2. Click on the `Connectors` tab.\n3. Click on the `Add Custom Connector` button.\n4. Add name as `JustCall` and Remote Server Url as `https://mcp.justcall.host/mcp`.\n5. Now on `JustCall` from the Connectors list click on `Connect` button for JustCall.\n6. It will open a JustCall page requesting API key and secret.\n7. Get your JustCall API Key & Secret from the JustCall dashboard (<https://app.justcall.io/app/developersApiCredentials>).\n8. Enter the API key and Secret and press Continue, it should redirect back you to Claude.\n\n## Chat GPT (Only available on Plus, Pro, Business and Enterprise)\n\n1. Open connectors url in your Browser - <https://chatgpt.com/#settings/Connectors>.\n2. Click on the `Apps & Connectors` tab.\n3. Ensure developer mode is enabled in advanced settings\n3. Click on the `Create` button.\n4. Add name as `JustCall` and MCP Server Url as `https://mcp.justcall.host/mcp`. You can skip other fields.\n5. Now on `JustCall` from the Connectors list click on `Connect` button for JustCall.\n6. It will open a JustCall page requesting API key and secret.\n7. Get your JustCall API Key & Secret from the JustCall dashboard (<https://app.justcall.io/app/developersApiCredentials>).\n8. Enter the API key and Secret and press Continue, it should redirect back you to Chat GPT.\n\n## Remote MCP\n\nTo connect to JustCall's MCP server remotely:\n\n### Streamable HTTP (Recommended)\n\nThe default and recommended way to connect is via Streamable HTTP Transport:\n\n- Connect to `https://mcp.justcall.host/mcp` from any MCP client using Streamable HTTP Transport\n- Include your JustCall API key as a bearer token in the request headers\n- Example header: `Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>`\n\n## Authentication & Security\n\nThe JustCall MCP Server implements OAuth2 authentication for secure access to all endpoints.\n\n### OAuth2 Configuration\n\nThe server supports OAuth2 authorization with the following features:\n\n- **Authorization Endpoint**: OAuth2 authorization server metadata is available at `/.well-known/oauth-authorization-server`\n- **Grant Type**: Authorization code flow with PKCE (Proof Key for Code Exchange)\n- **Code Challenge Method**: S256 (SHA-256)\n- **Token Authentication**: All MCP and SSE endpoints require Bearer token authentication\n\n### Protected Endpoints\n\nThe following endpoints require valid Bearer token authentication:\n\n- `/mcp` - Main MCP endpoint\n- `/sse` - Server-Sent Events endpoint\n- `/sse/message` - SSE message endpoint\n\n### Authentication Header Format\n\nInclude your JustCall API credentials as a Bearer token:\n\n```\nAuthorization: Bearer <JWT_TOKEN_BY_OAUTH>\nAuthorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>\n```\n\n### Public Endpoints\n\nThe following endpoints are publicly accessible:\n\n- `/health` - Health check endpoint (returns 200 OK)\n- `/.well-known/oauth-authorization-server` - OAuth2 authorization server metadata\n\n### API Usage & Rate Limits\n\nThis 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](https://app.justcall.io/app/developersApiCredentials).\n\n## Available Tools\n\nThe JustCall MCP Server provides 66 tools organized into the following categories:\n\n### JustCall API Tools\n\n#### 📞 Calls (6 tools)\n\n- **list_calls** - Lists all JustCall calls with various filtering options\n- **get_call** - Get a specific JustCall call by ID\n- **update_call** - Update a JustCall call (disposition, notes, rating)\n- **get_call_journey** - Fetch the sequence of events for a specific call\n- **get_voice_agent_data** - Get voice agent data for a specific call (deprecated, use get_voice_agent_call)\n- **get_voice_agent_call** - Retrieve voice agent related data for a specific call\n\n#### 👥 Users & Agents (3 tools)\n\n- **list_users** - List all users/agents in the account\n- **get_user** - Get detailed information for a specific user/agent\n- **update_user_availability** - Update a user's availability status to available or unavailable for calls\n\n#### 💬 SMS & Messaging (11 tools)\n\n- **send_sms** - Send an SMS/text message to a contact\n- **list_sms** - Retrieve all SMS/text messages\n- **get_sms** - Get detailed information for a specific SMS/text message\n- **check_sms_reply** - Check for the most recent inbound SMS reply from a specific contact\n- **list_sms_tags** - Retrieve all SMS tags used for organizing text messages\n- **get_sms_tag** - Get detailed information for a specific SMS tag\n- **create_sms_tag** - Create a new tag for organizing SMS conversations\n- **delete_sms_tag** - Delete a specific SMS tag\n- **list_sms_threads** - Retrieve all SMS threads/conversations associated with a JustCall number\n- **get_sms_thread** - Retrieve a specific SMS thread/conversation by ID\n- **add_sms_thread_tag** - Add tag to an SMS thread/conversation\n\n#### 📇 Contacts (6 tools)\n\n- **list_contacts** - Retrieve all contacts from the CRM\n- **get_contact** - Retrieve detailed information for a specific contact by ID\n- **create_contact** - Create a new contact in the CRM\n- **update_contact** - Update/modify details of an existing contact\n- **update_contact_status** - Add or remove a contact from DND/DNM/Blacklist lists\n- **add_contacts_blacklist** - Add one or more contacts to the global blacklist in bulk\n\n#### 📊 Analytics (4 tools)\n\n- **get_agent_analytics** - Retrieve agent analytics data for specified date range\n- **get_account_analytics** - Retrieve account analytics data for specified date range\n- **get_number_analytics** - Retrieve number analytics data for specified date range\n- **get_sales_dialer_analytics** - Retrieve comprehensive analytics data for sales dialer campaigns\n\n#### 🔔 Webhooks (2 tools)\n\n- **list_webhooks** - Retrieve all configured webhooks\n- **create_webhook** - Create a new webhook endpoint to receive real-time notifications\n\n#### 📱 Phone Numbers (2 tools)\n\n- **list_numbers** - Retrieve all JustCall phone numbers\n- **get_number** - Retrieve detailed information for a specific JustCall phone number\n\n#### 👥 User Groups (2 tools)\n\n- **list_user_groups** - Retrieve all user groups defined in the account\n- **get_user_group** - Retrieve detailed information for a specific user group by ID\n\n#### 📅 Appointments (3 tools)\n\n- **list_appointment_slots** - Retrieve all available time slots for appointments on a specific calendar\n- **create_appointment** - Schedule a new appointment on a specific calendar\n- **get_appointment** - Retrieve details of a specific appointment by its ID\n\n#### 💚 WhatsApp (5 tools)\n\n- **list_whatsapp_messages** - Retrieve all WhatsApp messages associated with the account\n- **get_whatsapp_message** - Retrieve detailed information for a specific WhatsApp message by ID\n- **send_whatsapp_message** - Send a new WhatsApp message to a contact number\n- **list_whatsapp_templates** - Retrieve all WhatsApp message templates available in the account\n- **check_whatsapp_message_reply** - Check for the most recent inbound WhatsApp message from a contact\n\n#### 🤖 AI Analysis (4 tools)\n\n- **list_calls_ai_analysis** - Retrieve AI-generated analysis (transcription, summary, insights) for all calls\n- **get_call_ai_analysis** - Retrieve AI-generated analysis for a specific call by Call ID\n- **list_meetings_ai_analysis** - Retrieve AI-generated analysis for recorded meetings (Zoom, Google Meet)\n- **get_meeting_ai_analysis** - Retrieve AI-generated analysis for a specific meeting by Instance ID\n\n#### 🎙️ Voice Agents (2 tools)\n\n- **list_voice_agents** - Retrieve all AI voice agents associated with the account\n- **create_voice_agent_call** - Initiate an outbound call from a configured AI voice agent to a contact\n\n### Sales Dialer Tools\n\n#### 📢 Campaigns (6 tools)\n\n- **list_campaigns** - Retrieve all sales dialer campaigns\n- **get_campaign** - Retrieve detailed information for a specific sales dialer campaign\n- **create_campaign** - Create a new sales dialer campaign\n- **update_campaign** - Update campaign details including name, description, status, and assignments\n- **list_salesdialer_campaign_contacts** - Retrieve all contacts in a specific campaign\n- **add_salesdialer_campaign_contact** - Add contact to a specific campaign\n\n#### 👥 Contacts (8 tools)\n\n- **list_salesdialer_contacts** - Retrieve all contacts from Sales Dialer\n- **get_salesdialer_contact** - Retrieve detailed information for a specific contact by ID\n- **create_salesdialer_contact** - Create a new contact in Sales Dialer\n- **update_salesdialer_contact** - Update/modify details of an existing contact\n- **import_salesdialer_contacts** - Import multiple contacts into Sales Dialer or a campaign in bulk\n- **import_salesdialer_contacts_status** - Check the status of a bulk import job by batch ID\n- **add_salesdialer_contacts_dnca** - Add one or more contacts to the \"Do Not Call Again\" list in bulk\n- **list_salesdialer_custom_fields** - Fetch all custom contact fields defined in Sales Dialer\n\n#### 📞 Calls (2 tools)\n\n- **list_salesdialer_calls** - Retrieve all calls made via the Sales Dialer\n- **get_salesdialer_call** - Retrieve detailed information for a specific Sales Dialer call by ID\n\n#### 📊 Analytics (2 tools)\n\n- **get_sales_dialer_analytics** - Retrieve comprehensive analytics data for sales dialer campaigns\n- **get_salesdialer_agent_analytics** - Retrieve call performance analytics of a specific agent for a campaign.\n",
  "bytes": 10948,
  "sha": "02a86f52e20103ea786c7d4c926d1a0f829e28d6fd9a6c8a538c36579295bd97",
  "repo_slug": "saaslabsco/justcall-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_host_justcall_mcp_justcall_mcp_server_65a6dd67/readme"
}