# CallFire MCP

> CallFire manages your voice and SMS communications from a single place. You can send bulk texts, trigger real-time follow-up calls, list message history, and monitor campaign assets—all directly through natural conversation with any AI agent.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-marketing, voice-broadcast, bulk-messaging, telephony, customer-engagement, real-time-communication

## Description

This MCP lets you manage all outgoing communication, whether it's a quick alert text or a scheduled follow-up call. You can send single texts or bulk messages to specific customer lists without ever touching the CallFire dashboard. It also tracks every interaction; need to know if last week’s campaign sound was used? Or check the status of that outbound voice call? This MCP handles it. By connecting this service through Vinkius, your agent gets immediate access to all necessary communication tools, allowing you to orchestrate complex sequences—like checking webhook health before sending a notification—all via natural chat. You just tell your agent what needs doing, and the rest is handled.

## Tools

### get_account_info
Retrieves fundamental account details for context checking.

### get_call_details
Gets specific status and transcript data for one voice call.

### get_sms_details
Retrieves the full record, including body and timestamps, for a single SMS message.

### list_calls
Pulls a list of recent voice calls made through the platform.

### list_campaign_sounds
Lists all configured audio assets used for campaigns.

### list_keywords
Displays a list of rented keywords available for SMS interaction.

### list_sent_sms
Lists all messages that have been successfully sent via SMS.

### list_webhooks
Provides a list of currently active webhooks for integration monitoring.

### send_voice_call
Initiates an immediate voice call to a target phone number.

### send_sms
Sends a new, single-recipient SMS message to a specified number.

## Prompt Examples

**Prompt:** 
```
Send an SMS to +1234567890 saying 'Hi from Vinkius'.
```

**Response:** 
```
I've sent the SMS to +1234567890. The message ID is msg_123 and it's currently marked as 'READY'.
```

**Prompt:** 
```
List my last 5 voice calls in CallFire.
```

**Response:** 
```
I've retrieved your calls. You have 5 recent calls, including a finished call to +1987654321 and a failed attempt to +15550199.
```

**Prompt:** 
```
Show the details for SMS with ID 99283.
```

**Response:** 
```
SMS 99283 was sent to +1234567890 on March 20th. The status is 'FINISHED' and the message body was 'Your code is 1234'.
```

## Capabilities

### Sending Messages
Send individual or bulk SMS messages to specific customer numbers.

### Managing Voice Calls
Trigger single voice calls and retrieve the full status details for those outbound attempts.

### Retrieving Account Data
Fetch core profile information or get detailed records for specific SMS messages and call transcripts.

### Auditing Communications
List active webhooks, monitor rented keywords, and retrieve metadata about configured campaign sounds.

## Use Cases

### Client follow-up after support ticket closure
A support agent finishes a call and knows the client needs a reminder. Instead of writing an email, they ask their agent to `send_sms` with a link to documentation. The agent handles the delivery and logs it all for later review.

### Emergency system notification
An ops engineer's monitoring script fails. Instead of logging into multiple systems, they ask their agent to `send_sms` a critical alert text message immediately, ensuring rapid response time and clear delivery confirmation.

### Scheduled outbound check-ins
A sales lead needs a follow-up call. The sales rep asks the agent to `send_voice_call` with the client's number. The agent triggers the call and provides details via `get_call_details` once it finishes.

### Compliance audit of past communications
A compliance officer needs a record of all automated messages sent last week. They ask their agent to `list_sent_sms`, getting an instant list and the ability to pull detailed records using `get_sms_details`.

## Benefits

- You don't need to jump into the CallFire portal just to send an alert. You simply ask your agent to `send_sms`, and it gets done immediately.
- Instead of manually checking a dashboard for call failures, you can prompt your agent with `list_calls` to get real-time status updates on recent voice efforts.
- When troubleshooting integrations, listing active webhooks using the `list_webhooks` tool lets you confirm if your automation layer is firing correctly without deep API diving.
- Getting core profile data is simple. Use `get_account_info` to pull necessary account details when setting up a new workflow or checking permissions.
- You can audit campaign assets by running `list_campaign_sounds`, giving you instant visibility into what media is available for your outreach.

## How It Works

The bottom line is... it gives your agent direct operational access to CallFire's entire communication suite.

1. Subscribe to this MCP and provide your CallFire API Username and Password credentials.
2. Your AI client accesses the available tools, allowing you to request actions like sending a message or listing calls via natural language prompts.
3. The system executes the necessary API calls, returning structured data about account status, call logs, or confirmation of sent messages.

## Frequently Asked Questions

**Can I send an SMS using the agent?**
Yes! Use the `send_sms` tool with the recipient's phone number and your message content. Your agent will trigger the dispatch through CallFire instantly.

**How do I check the status of a specific call?**
Simply ask the agent to `get_call_details` and provide the Call ID. It will retrieve the latest status, such as 'finished' or 'failed', directly from CallFire.

**Does the integration allow creating a new voice broadcast?**
The current toolset is focused on individual actions and querying (Read-Only/Individual Dispatch) for operational control. Massive broadcasts should be configured via the CallFire web dashboard.

**Using `get_account_info`, what core business details can the agent retrieve about my CallFire account?**
It retrieves essential metadata like your primary profile ID, billing status, and general site information. This is useful for quick validation of your overall service setup without needing to check a separate admin portal.

**What does the agent show when I run `list_webhooks` regarding my external systems?**
The tool lists all active webhooks configured on your account and provides their current health status. This lets you quickly check if your integrations are firing data correctly or if any connection has stopped working.

**If I need to know which phone numbers are available for text campaigns, how does the agent handle `list_keywords`?**
The agent lists all your rented keywords and associated numbers. This view helps you manage capacity and ensures you don't accidentally try to send messages from a number that's inactive or nearing its limit.

**Does running `list_sent_sms` provide enough metadata to audit past message delivery attempts?**
Yes, it lists multiple sent SMS records, giving you key data points like the timestamp, recipient number, and final delivery status. This makes auditing your communication history straightforward.

**Beyond the status, what key performance indicators does `get_call_details` provide for a single voice call?**
It provides detailed metrics including the exact duration of the call and timestamps for when it connected or dropped. This depth helps you analyze specific call outcomes beyond just 'connected' or 'failed'.