# JustCall MCP

> JustCall MCP manages all your company's communication data—calls, texts, and recordings. This connector gives your agent instant access to comprehensive history, allowing you to audit interactions, vet contacts, or track campaign performance without ever leaving your workflow.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** cloud-phone, sms-marketing, call-recording, contact-management, sales-engagement, telephony

## Description

This MCP connects your AI client directly to JustCall’s cloud phone system records. Your agent can instantly pull complete communication histories, whether it's a full transcript of a call, the details of an SMS exchange, or a list of active contacts. It centralizes data that used to live across multiple dashboards and manual exports. Need to check on a client? You can retrieve detailed contact information right away. Tracking down every interaction for compliance is simple; your agent can pull lists of all completed calls or search through message logs. This gives you full visibility into sales cycles and support tickets, letting you automate complex communication workflows efficiently. By connecting this MCP via the Vinkius catalog, you give your AI client a complete 360-degree view of every customer touchpoint.

## Tools

### get_call
Retrieves comprehensive details for a specific phone call, including notes and participants.

### get_contact
Pulls all associated contact information, like phones and emails, for a single person or company.

### list_calls
Provides an overview of phone calls, listing the direction (inbound/outbound), duration, and status.

### list_campaigns
Lists all defined calling campaigns in your account for monitoring outreach efforts.

### list_contacts
Generates a list of all contacts available, including their names and IDs.

### list_messages
Lists every SMS/MMS message in your account, detailing the content and delivery status.

### list_numbers
Shows all phone numbers registered to your JustCall account for inventory checks.

### list_recordings
Provides an index of available call recordings, useful for quality assurance and review.

### list_users
Lists all user accounts within the organization to track who handled specific communications.

### list_webhooks
Shows a list of configured webhooks for 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

### Audit Call History
Retrieve detailed records for specific phone calls, including participants, timestamps, and notes.

### Manage Customer Profiles
Get full contact details—phones, emails, and metadata—for any individual customer or lead.

### Review Messaging Logs
List all SMS/MMS messages, showing content, who sent them, and if they were successfully delivered.

### Track Communication Volume
Pull lists of contacts, calls, recordings, or users to audit activity and measure performance metrics.

### Monitor Campaign Efforts
List details about active calling campaigns to monitor sales outreach and telemarketing activities.

## Use Cases

### Investigating a Failed Deal
A sales rep needs to know why a deal stalled. Instead of digging through multiple CRM tabs, they ask their agent to use `get_call` for the last interaction and then run `list_messages` to see if any follow-up texts were missed. They get all the context immediately.

### Compliance Audit
The compliance officer needs proof that every agent is following protocol. They ask their agent to use `list_users` and then cross-reference it with `list_calls` to ensure only authorized personnel handled sensitive calls.

### Customer Onboarding
A marketing team needs a list of leads for a new campaign. They ask the agent to use `list_contacts` first, then check `list_numbers` to confirm which numbers are available for dialing before running a large-scale outreach.

### Post-Incident Review
A support team is reviewing a major service outage. They use the agent to get all call data using `list_calls`, then run `get_call` on specific IDs, and check associated notes to determine if communications failed at a certain point.

## Benefits

- Get a full audit trail immediately. Instead of manually checking separate logs for every interaction, you can use the `list_calls` tool to pull all call metadata in one go.
- Never guess who you're talking to again. By using `get_contact`, your agent pulls verified names and multiple contact methods before a sale or support chat even starts.
- Track communications across channels. You don't just see calls; you can use `list_messages` to pull SMS/MMS logs right alongside call history, giving one complete view.
- Improve compliance reporting. Need proof of customer interaction? The MCP lets your agent quickly list all available recordings via the `list_recordings` tool for internal review.
- Automate data gathering. When onboarding a new client, you can run multiple tools—like listing contacts and checking campaign status—to build a comprehensive profile instantly.

## How It Works

The bottom line is you get immediate access to a unified log of all communication activity without having to manually navigate the JustCall portal.

1. Your AI client tells the MCP exactly what data it needs, like 'Find all calls associated with Jane Doe' or 'Show me last week's messages.'
2. The MCP translates that request into an API call and hits the JustCall system to pull raw records.
3. It returns structured data—call IDs, message content, contact details—ready for your agent to use in its response.

## Frequently Asked Questions

**How do I find out if an agent was authorized to make the call using JustCall MCP?**
You use `list_users` first to see who is set up in your organization, and then check `get_call` details to confirm which specific user ID handled that communication.

**Does JustCall MCP include old call recordings or just recent ones?**
The MCP uses the `list_recordings` tool to provide an index of available records. You should check your account settings within the API documentation to verify retention policies.

**Can I track a contact's phone number history with JustCall MCP?**
Yes, you use `get_contact` to pull associated numbers and metadata for that specific person. This is useful for vetting leads before outreach campaigns.

**What if I need to check both calls and texts from the same date? JustCall MCP?**
Run `list_calls` to get voice activity records, then immediately run `list_messages` to pull all SMS/MMS logs for that timeframe. Combining these two tools gives you a full picture.

**How do I audit which campaigns are running right now using JustCall MCP?**
Use the `list_campaigns` tool. This function provides an overview of all defined calling campaigns, helping you monitor sales outreach and telemarketing efforts.