# JustCall MCP

> JustCall lets you manage all your business communications—calls, texts, and contacts—from any AI agent. It connects to a full cloud phone system that automatically logs every interaction into a searchable CRM structure. Your agent can make outbound calls, send follow-up SMS messages, look up contact history, and track which agents are performing best, all without you touching a dashboard.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** cloud-phone, sms-messaging, call-logging, contact-management, call-recording, agent-performance

## Description

This MCP lets your AI client manage your entire communication workflow through natural conversation. You're not limited to just logging data; you use the tools to act on it. Need to follow up with a lead? Your agent can look up the contact using its details, send an immediate text message, and then log that activity against their profile, all in one go. The system tracks everything, from call duration and status to who made the connection and when. Because Vinkius hosts this connector, you get full access to every toolset—from listing assigned phone numbers to pulling detailed records of historical calls and recordings. This means your agent doesn't just read data; it uses that data to complete complex tasks, like summarizing a call outcome and automatically updating the contact record.

## Tools

### create_contact
This tool adds a brand new person's entry to your system of records.

### get_account_profile
It pulls the core administrative details about the connected JustCall account itself.

### get_call_details
The MCP retrieves every specific piece of information related to a single phone call.

### get_contact
This tool fetches all the stored data for one specified contact.

### get_message_details
It pulls out the full content and metadata for a specific SMS or MMS message.

### list_calls
The MCP generates a comprehensive list of all phone calls logged in the account history.

### list_contacts
This tool returns an exhaustive list of every contact saved to your system.

### list_messages
It compiles a detailed report listing all sent and received text messages.

### list_account_numbers
You can get a full list of every assigned phone number available to your team.

### list_team_users
The MCP generates a roster listing all current users and team members in the account.

### list_webhooks
It fetches a list of active webhooks set up within the JustCall platform.

### send_message
This tool sends text messages or MMS to specified phone numbers.

## Prompt Examples

**Prompt:** 
```
Show today's call log and send a follow-up SMS to the last caller.
```

**Response:** 
```
Today's calls: 34 total. Inbound: 22 (avg 4.2 min). Outbound: 12 (avg 6.1 min). Missed: 3. Last caller: Ana Costa (+1-555-0123, 5 min call, 10:15 AM). SMS sent! ✅ To: +1-555-0123. Content: 'Hi Ana, thanks for calling! I wanted to follow up on our conversation about the Pro plan. Happy to schedule a demo at your convenience.' Delivery: confirmed.
```

**Prompt:** 
```
List all agents, their call volumes, and available phone numbers.
```

**Response:** 
```
Agents: 6. Sarah Chen — 145 calls this week (avg 5.2 min, available). Mike Torres — 128 calls (avg 4.8 min, on call). Lisa Park — 112 calls (avg 6.1 min, available). 3 others. Phone numbers: 8 assigned, 3 available. US: +1-555-0100 to 0107. UK: +44-20-7123-4567. Available: +1-555-0108, 0109, 0110.
```

**Prompt:** 
```
Show call recordings from this week and the contact database.
```

**Response:** 
```
Recordings: 28 this week. Longest: 'Enterprise Deal — Acme Corp' (22 min, Sarah Chen). Shortest: 'Quick Follow-up' (1 min). Total recording time: 4h 15m. Contacts: 456 total. New this week: 12. By tag: Leads (89), Customers (234), Partners (45), Prospects (88). Would you like to play a recording or create a contact?
```

## Capabilities

### Build new contacts
The MCP creates structured entries for people into your main contact database.

### Get account details
It retrieves core information about the connected JustCall account profile.

### Check call specifics
The MCP pulls detailed records for a single phone call event.

### Find contact profiles
You can look up and retrieve all stored details about any specific contact.

### Get message specifics
It provides the full content and metadata for a single text or MMS exchange.

### List historical calls
The system pulls a complete log of all phone calls made or received within your account.

### Find contact lists
It generates a list of every contact stored in the database.

## Use Cases

### Following up after a demo
A salesperson needs to send a follow-up text immediately after a discovery call. They ask their agent to check the `get_call_details` for the last conversation, and then use the `send_message` tool to write and deliver a personalized message recommending resources.

### Onboarding new team members
A support manager needs to verify that all agents have numbers available. They ask their agent to call `list_account_numbers`, confirming not only the assigned lines but also which ones are currently free for immediate use.

### Analyzing a competitor's lead
A sales director needs background on a prospect. The agent calls `get_contact` to pull all available history, reviews previous call details, and summarizes the last few interactions into a single brief for the team.

### Auditing communication records
An operations manager needs to see who talked to whom this month. They instruct their agent to use `list_calls` and then filter that massive dataset by date range, giving them a clear accountability report.

## Benefits

- Instantly follow up with clients. Instead of manually checking call logs, your agent can review the details for a specific call, then use the `send_message` tool to send a targeted text right away.
- Maintain clean records automatically. The MCP ensures that every interaction—whether it's a new contact entry via `create_contact` or a status update on a phone number via `list_account_numbers`—is logged instantly.
- Improve agent accountability. You can use the tools to list team users and access call recordings, giving you clear metrics on who is available and how often they are using the system.
- Streamline prospecting efforts. Your agent can generate a full contact roster by calling `list_contacts` and then bulk-send messages or schedule calls for follow-up campaigns.
- Reduce data silos. You don't have to jump between your phone system and your CRM. The MCP lets your AI client pull all the necessary call details and message specifics in one single prompt.

## How It Works

The bottom line is: you tell your AI client what communication task needs doing, and it handles all the complex API calls behind the scenes to get it done.

1. First, you subscribe to this MCP on Vinkius and provide your JustCall API Key and Secret.
2. Next, you instruct your AI client what task needs doing—for instance, 'Check the call log for yesterday's missed calls and send a follow-up message to the last number that called.'
3. Finally, the MCP executes the necessary tools, pulling the data and performing actions on behalf of your agent.

## Frequently Asked Questions

**How do I use JustCall MCP to check call logs?**
You ask your agent to list calls using `list_calls`. The agent pulls a comprehensive log of every inbound and outbound call, including duration and status.

**Can the JustCall MCP send messages automatically?**
Yes. Your agent can use the `send_message` tool to text any contact listed in your database, making follow-ups immediate and trackable.

**Does JustCall MCP help with team performance tracking?**
The system allows you to list team users and review call logs. This helps managers monitor agent availability and overall call volume metrics easily.

**How do I get a specific contact's full history using JustCall MCP?**
You use `get_contact` first to pull the profile, then you can ask your agent to combine that data with `list_calls` and `list_messages` for a complete view.

**Is JustCall MCP limited only to phone numbers?**
No. While it manages calling features, the MCP also handles SMS messaging through tools like `send_message` and processes contact data using `create_contact`.