# MightyCall MCP

> MightyCall connects your virtual phone system to any AI client. It gives your agent tools for call routing, managing contacts, and handling voicemails. You can list all recent calls with metadata, initiate outgoing calls directly from code, or retrieve detailed customer profiles using the `create_contact` tool. Stop switching between CRM tabs; manage your entire communication workflow inside your chat environment.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** virtual-phone-system, call-routing, call-center-automation, voicemail-management, business-communications, inbound-calls

## Description

Listen up. MightyCall hooks your professional phone system right into any AI client you're running. You don't gotta switch between tabs or write a bunch of API code; your agent handles all the comms stuff—call routing, managing records, checking voicemails—all from within the chat window.

When you need to keep track of what’s going on with calls, you use `list_calls` to pull detailed activity history. You'll see a full record of your most recent inbound and outbound calls, getting metadata like the status code and who was involved in each interaction. If you just want to check out who exists without knowing their call history, run `list_contacts` to get the complete list of every existing client record.

For immediate follow-up, you use `make_call`. Your agent initiates a live outgoing phone call directly from one of your registered business numbers straight to the recipient. It's instant and requires zero manual setup. You can also check out what businesses are even connected by calling `list_business_numbers`, which pulls a complete rundown of every active number on your account.

Dealing with customer data is easy too. If you need to build a new client file, use the `create_contact` tool; it lets your agent add a brand-new contact record using just basic profile details. You'll keep everything organized right in your system.

Don't forget about messages left behind. Your team can track down specific customer inquiries by running `list_voicemails`. This pulls a summary and the full details of your most recent voicemails, making sure your agent knows exactly which message needs attention first—especially if some are marked as unread.

Basically, you've got the power to monitor all call activity history with `list_calls`, track every voicemail in the queue using `list_voicemails`, kick off outgoing calls instantly via `make_call`, manage your whole client database by creating new contacts with `create_contact` or pulling existing ones with `list_contacts`, and always know what numbers you're playing with by listing them all out with `list_business_numbers`.

## Tools

### create_contact
Adds a new contact record into your system using basic profile information.

### list_business_numbers
Retrieves a list of all active business phone numbers registered to the account.

### list_calls
Gets a detailed record of your most recent inbound and outbound call activities.

### list_contacts
Fetches a full list of all existing contacts in the system.

### list_voicemails
Pulls a summary and details of your most recent voicemails, marking which ones are unread.

### make_call
Initiates an outgoing phone call from one of your registered business numbers to a specified recipient.

## Prompt Examples

**Prompt:** 
```
List all recent calls in my MightyCall account.
```

**Response:** 
```
I've retrieved your recent calls. You have 5 activities today, including 3 inbound calls from 'Alice Brown' and 2 outbound follow-ups. Would you like to see the duration for any of them?
```

**Prompt:** 
```
Show me any unread voicemails.
```

**Response:** 
```
I've checked your voicemails. You have 2 unread messages from yesterday afternoon. One is from an unknown number (+123...) and another from 'Global Tech'.
```

**Prompt:** 
```
Make a call from my main number (+198765432) to +123456789.
```

**Response:** 
```
Call initiated successfully! I've triggered the outgoing call from your main number (+198765432) to +123456789. Your desk phone or app should ring shortly.
```

## Capabilities

### Track call activity history
The agent retrieves a list of recent calls, providing details like status and who called.

### Monitor voicemail messages
You access the queue and track specific voicemails so your team can address customer needs quickly.

### Start outgoing phone calls
The agent initiates a live call from one of your registered business numbers.

### Build or update contact records
You create new contacts using `create_contact` or retrieve detailed information about existing clients.

### Inventory phone numbers
The agent pulls a complete list of all active business phone numbers associated with your account.

## Use Cases

### Handling After-Hours Inquiries
A support rep receives a ticket about an issue. Instead of waiting for the customer's call back, they ask their agent to run `list_voicemails`. The agent pulls two unread messages—one from 'Global Tech' and one unknown number—allowing the rep to immediately triage which client needs attention first.

### Field Sales Follow-up
An SDR finishes a meeting. They ask their agent to run `create_contact` with the new attendee details, then use `make_call` right away to schedule the next step. The system handles both data entry and communication in one sequence.

### Daily Call Audit
A manager needs a report on last week’s calls. They ask their agent to run `list_calls`. The agent returns structured data listing the call status, total duration, and key participants for auditing purposes.

### Building Contact Lists
A developer needs to know which numbers are available for a new campaign. They ask their agent to run `list_business_numbers`, getting a clean list of all active lines before writing the deployment script.

## Benefits

- See every call's metadata instantly. Use `list_calls` to get status (missed/connected) and duration for every interaction, making reporting fast.
- Never miss a follow-up. The `list_voicemails` tool pulls your message queue so your agent knows exactly which customer needs an immediate response.
- Automate outreach without code. Running the `make_call` tool triggers an outgoing call directly from your client, letting you script complex workflows.
- Keep data clean and current. Use `create_contact` to build new records or update existing ones with accurate profile details immediately after a call.
- Know your comms infrastructure. The `list_business_numbers` tool shows every phone number available for use, so you always know where to dial from.

## How It Works

The bottom line is: Your AI client talks to MightyCall through this server; MightyCall does the heavy lifting with the phone system and gives you clean, usable data in return.

1. Subscribe to the MightyCall server and plug in your Client ID and Secret keys.
2. Your AI client calls out to the MCP, specifying which tool it needs (e.g., `list_calls`).
3. MightyCall runs the API request and sends back structured data—the call logs, contacts, or voicemail list—to your agent.

## Frequently Asked Questions

**How does the MightyCall MCP Server handle my phone numbers?**
It lets you manage them via `list_business_numbers`. This tool confirms every number available, so your agent knows exactly what line to use when running a `make_call`.

**Can I list all contacts with MightyCall MCP Server?**
Yes. Use the `list_contacts` tool to pull a full directory of your existing customer records, or run `create_contact` if you find new details during a call.

**Is list_calls reliable for detailed reporting?**
It is. The `list_calls` tool provides metadata like status and duration, which gives you the raw data needed to build reports or audit activity logs.

**What if I need to follow up with a customer? Do I use MightyCall MCP Server?**
Yes. You can run `make_call` directly through your agent after gathering the contact information, making immediate, automated outreach possible.

**What credentials do I need to use the `list_calls` tool?**
You must provide your MightyCall Client ID and Client Secret. These unique keys authenticate your connection to the API, ensuring that only authorized agents can access your call logs.

**Does `list_voicemails` give me the transcript content?**
The tool provides metadata about recent voicemails, including caller details and date. To get the actual audio or transcribed text, you must use MightyCall's dedicated transcription service via your API calls.

**What happens if I hit rate limits when using the MightyCall MCP Server?**
If your AI agent exceeds the allowed call volume, the server will return an explicit error code. Your workflow should implement a retry mechanism with exponential backoff to manage temporary throttling.

**After running `create_contact`, how do I verify the new record?**
You can immediately confirm the contact's existence and details by calling the `list_contacts` tool. This allows your agent to read back the full data structure, confirming successful write operations.

**How do I get my MightyCall API credentials?**
Log in to your MightyCall dashboard, navigate to the **API** or **Integrations** section, and generate your Client ID and Client Secret.

**Can I make outgoing calls?**
Yes, use the `make_call` tool and specify which of your business numbers to use as the source and the target destination number.

**Does it track voicemail status?**
Absolutely. The `list_voicemails` tool retrieves your recent messages along with their duration and current status (read/unread).