# JustCall MCP > JustCall MCP Server manages all your communication records. Your agent can list and retrieve phone calls, SMS messages, and full contact profiles using the JustCall API. It handles call recordings, tracks call volumes, and manages all contacts and campaigns. Use it to automate customer support, sales outreach, and communication auditing. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** cloud-phone, sms-marketing, call-recording, contact-management, sales-engagement, telephony ## Description This MCP Server gives your agent direct access to your whole JustCall communication history. Your agent can pull call recordings, audit message logs, and pull contact details—all without you leaving your workflow. **`get_call`** retrieves the full rundown for a specific call, giving you timestamps, participants, and any notes taken. **`list_calls`** gives you a list of all phone calls, showing if they were inbound or outbound, how long they lasted, and their status. **`get_contact`** pulls a contact's entire profile, giving you associated phone numbers, email addresses, and all the extra metadata. **`list_contacts`** lets you search and pull a list of all contacts stored in your JustCall account, including names, phone numbers, and IDs. **`list_messages`** gets a list of every SMS or MMS message, including the content, who sent it, and if it actually got delivered. **`list_recordings`** pulls a list of all recorded calls, so you can audit quality or review specific conversations. **`list_campaigns`** lets you see all the calling campaigns you've set up, which is useful for tracking sales or marketing outreach. **`list_numbers`** lists all the phone numbers in your JustCall account, helping you figure out which numbers you can use for campaigns. **`list_users`** lists every user in your organization, letting you know which agent handled a specific interaction. **`list_webhooks`** lists all the webhooks you've configured, which helps you audit your system integrations. ## Tools ### get_call Retrieves full details for a specific call, including timestamps, participants, and notes. ### get_contact Pulls a contact's full profile, returning associated phone numbers, email addresses, and metadata. ### list_calls Returns a list of all phone calls, showing the direction, duration, status, and IDs. ### list_campaigns Lists all configured calling campaigns, useful for monitoring sales outreach efforts. ### list_contacts Returns a list of all contacts, providing names, phone numbers, and IDs. ### list_messages Retrieves a list of all SMS/MMS messages, including content, sender/receiver, and delivery status. ### list_numbers Lists all phone numbers in your JustCall account, helping you identify available numbers for campaigns. ### list_recordings Gets a list of all call recordings, which you can use to audit call quality or retrieve specific conversations. ### list_users Lists all users in your organization, useful for identifying which agent handled a specific interaction. ### list_webhooks Lists all configured webhooks, which helps in auditing system integrations. ## Prompt Examples **Prompt:** ``` List all recent phone calls in JustCall. ``` **Response:** ``` I'll fetch the history of your recent phone calls from JustCall. ``` **Prompt:** ``` Show me the latest SMS messages. ``` **Response:** ``` I'll retrieve the list of recent text messages from your JustCall account. ``` **Prompt:** ``` Check the details for contact ID '123'. ``` **Response:** ``` I'll look up the full profile and history for that specific contact in JustCall. ``` ## Capabilities ### Get specific call details The agent fetches a call's full history, including participants, timestamps, and associated notes. ### Retrieve contact information The agent pulls a contact's profile, including phone numbers, email addresses, and metadata. ### List and track calls The agent pulls a list of all phone calls, detailing direction (inbound/outbound), duration, and status. ### List SMS/MMS messages The agent retrieves all text messages, including content, who sent it, and if it was delivered. ### List available contacts The agent searches and lists all contacts stored in your JustCall account. ### List call recordings The agent pulls a list of all recorded calls, allowing you to audit quality or review specific conversations. ### Monitor calling campaigns The agent lists all set-up calling campaigns, useful for tracking sales or marketing outreach. ## Use Cases ### Investigating a missed sales lead A sales rep needs to know why a lead didn't reply. They ask their agent to 'Check the history for John Doe.' The agent runs `get_contact` for John Doe, then uses `list_messages` to pull the last five texts, and finally runs `get_call` on the most recent call. The rep gets a full, contextual summary, solving the problem in seconds. ### Auditing team performance after a quarter The ops manager needs to verify total outbound call activity. They ask the agent to 'Generate a report of last month's calls.' The agent runs `list_calls` and `list_recordings`, compiling data on call volume, duration, and recording availability for the entire team. ### Pre-call preparation for an executive An executive is meeting a key client and needs all background info. They ask the agent to 'Pull the full profile for Acme Corp.' The agent runs `get_contact` to get the latest emails and phone numbers, and then uses `list_calls` to see the last 10 interactions, ensuring the executive is fully briefed. ### Debugging a failed marketing campaign The marketing team notices calls aren't going out. They ask the agent to 'Check the dialer status.' The agent uses `list_campaigns` to verify the campaign setup and then runs `list_numbers` to check if the correct calling numbers are assigned to the campaign. ## Benefits - **Audit full customer history:** Instead of opening a separate CRM tab and then logging into a call system, use `get_call` to pull comprehensive call details, including participants and notes, right alongside the contact info. You see the whole picture in one go. - **Track communication volume:** Need to know if the sales team hit their call quota? `list_calls` gives you a clean audit trail, showing call direction, duration, and status across the board. It’s immediate visibility into activity. - **Verify customer details instantly:** Before talking to a client, run `get_contact`. You get immediate access to associated phone numbers, emails, and metadata. This prevents using outdated contact info. - **Manage text and voice:** The server handles both ends of the conversation. Use `list_messages` for SMS/MMS logs and `list_recordings` to pull audio evidence. You never have to switch between text and voice logs. - **Monitor campaigns at scale:** For marketing or sales teams, `list_campaigns` lets you monitor dialer activity and outreach efforts. You can quickly see if the campaigns are running correctly and who they're targeting. - **Identify the agent:** If a customer asks, 'Who handled my ticket?', use `list_users` to pinpoint exactly which agent was involved in the call or message, streamlining internal accountability. ## How It Works The bottom line is, your agent uses specific tools to talk to your JustCall account and gets back structured data about your calls, contacts, and messages. 1. Your AI client determines it needs communication data (e.g., 'What was the outcome of the call with John Doe?'). 2. Your client invokes the appropriate JustCall tool (e.g., `get_call` or `get_contact`) and passes necessary identifiers (like a call ID or contact ID). 3. The JustCall MCP Server executes the API call and returns structured JSON data to your client, which then uses it to answer the query. ## Frequently Asked Questions **How do I use the JustCall MCP Server to check a specific call?** You use the `get_call` tool and pass the specific call ID. This tool returns the call's full history, including participants, timestamps, and any associated notes for deep investigation. **Can JustCall MCP Server help me track SMS messages?** Yes. Use `list_messages` to retrieve all SMS/MMS messages. This tool includes the message content, who sent it, and the delivery status, giving you a full view of text interactions. **What information does `get_contact` provide?** `get_contact` returns a comprehensive profile for a single contact. It includes associated phone numbers, email addresses, and other valuable metadata for detailed customer vetting. **Which tool should I use to see all my recent calls?** Use `list_calls`. This tool gives you a list of all phone calls, detailing the direction (inbound/outbound), the total duration, the status, and the call IDs for auditing. **Does JustCall MCP Server handle call recordings?** Yes, you use `list_recordings` to get a list of all recorded calls. This allows you to audit call quality or retrieve specific conversation records for review. **How do I use `list_recordings` to audit call quality?** The `list_recordings` tool provides a list of all call recordings. You can then use the recording IDs to review specific conversations, helping you audit quality and compliance. **What information does `list_messages` include about text interactions?** The `list_messages` tool provides the message content, sender, receiver, and delivery status for all SMS/MMS messages. This lets you monitor text-based customer interactions easily. **When should I use `list_users` to manage my team?** `list_users` returns a list of all users in your organization. This is useful for identifying which agent handled a specific call or message, allowing you to track individual performance. **How do I get JustCall API credentials?** Log in to your JustCall account, navigate to Settings > Developers > API, and copy your API Key and Secret. **Can I see call recordings?** Yes, the list_recordings tool allows you to retrieve a list of all call recordings in your account. **Does it support SMS messages?** Yes, you can list and track SMS and MMS messages using the list_messages tool.