# CallFire MCP for AI Agents AI Agent Connect

> CallFire MCP lets you manage high-volume voice broadcasts and bulk SMS campaigns through your AI client. It handles contact management, call tracking, and campaign monitoring so you don't have to jump between tabs to see if your outreach is actually landing.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ul4KmZpRS4q3Oe1PlADXaUpy8IAwbwaBtDKkUCLG/ai-agent-connect
- **Tags:** sms-marketing, voice-broadcast, call-tracking, bulk-messaging, contact-management, outreach

## Description

CallFire MCP connects your CallFire account to your AI agent so you can manage your voice and SMS communication workflows through natural conversation. Instead of jumping between tabs to check if your outreach is actually landing, you can just ask your agent to pull the latest delivery stats or find a specific customer's history. This connector makes your AI workspace a command center for high-volume communications. You can check if a text message landed, see the duration of a recorded call, or look up a customer's metadata without ever leaving your chat window. It's a big part of why Vinkius is so useful for teams that need to move fast; it keeps your tools connected so you can focus on the actual conversation. You can troubleshoot a failed webhook or review a broadcast campaign's performance whenever you need it. You get a clear view of your reach and engagement metrics without the manual clicking usually required by the dashboard.

## Tools

### get_call
Get a specific call's details. This is useful for checking the duration and status of a single interaction.

### get_campaign
Get a specific broadcast campaign. Use this to see the configuration and performance data for a specific outreach.

### get_contact
Get a specific contact. This helps you quickly retrieve a phone number or metadata for a single user.

### get_text
Get a specific text message. Use this to check the delivery status and timestamp of a single SMS.

### get_webhook
Get a specific webhook. This is useful for inspecting delivery settings and event triggers for your automations.

### list_calls
List all calls. Use this to view the full history of inbound and outbound calls in your account.

### list_campaigns
List all broadcast campaigns. This lets you see every voice and text campaign you have scheduled or active.

### list_contacts
List all contacts. Use this to pull your entire database of contact profiles and phone numbers.

### list_texts
List all texts. Use this to review the history of every sent and received text message.

### list_webhooks
List all webhooks. This helps you see all configured webhooks and their current trigger settings.

## Prompt Examples

**Prompt:** 
```
Show me the delivery status for the last 10 texts.
```

**Response:** 
```
I've pulled the last 10 text messages for you. Here is the delivery breakdown:

| Message ID | Timestamp | Status |
| :--- | :--- | :--- |
| text_90112 | 10:05 AM | **Delivered** |
| text_90178 | 10:07 AM | **Failed** (Invalid Number) |
| text_90301 | 10:12 AM | **Carrier Blocked** |
| text_90445 | 10:15 AM | **Delivered** |

Would you like me to look into any of the failed messages?
```

**Prompt:** 
```
Who are the top 3 contacts with the most calls?
```

**Response:** 
```
Based on your call history, here are the top 3 contacts by interaction volume:

* **Apex Industries** (contact_8901) - 47 calls
* **Green Valley Corp** (contact_8234) - 38 calls
* **Metro Health** (contact_7912) - 31 calls

I can pull the full contact details for any of these if you need them.
```

**Prompt:** 
```
Are my webhooks working for the Spring campaign?
```

**Response:** 
```
I checked your active webhooks for the Spring campaign. You have 2 webhooks configured:

* **Lead_Capture_Webhook**: Active (Trigger: New Contact)
* **SMS_Delivery_Webhook**: Active (Trigger: Message Delivered)

Both are currently set to deliver events to your endpoint. Do you want me to check the delivery settings for a specific one?
```

## Capabilities

### Pull contact profiles
The CallFire MCP fetches phone numbers and customer metadata instantly.

### View call logs
The CallFire MCP lists all inbound and outbound call records in one view.

### Check SMS delivery
The CallFire MCP shows the real-time status of your sent text messages.

### Monitor broadcast performance
The CallFire MCP displays the reach and engagement of your active campaigns.

### Manage webhook settings
The CallFire MCP lets you inspect and verify your automation triggers.

## Use Cases

### Failed SMS troubleshooting
A marketing lead notices a drop in engagement and asks the agent to list texts from the last hour to find carrier blocks.

### Sales follow-up
An SDR wants to know who answered the last 10 calls and asks the agent to list calls and get the contact info for each.

### Campaign audit
An ops manager needs a summary of the Spring Sale campaign and asks the agent to get the campaign details and list the webhooks.

### Contact lookup
A support agent needs to find a specific customer's phone number and asks the agent to get the contact for a specific ID.

## Benefits

- See real-time SMS delivery rates using list_texts to spot carrier blocks instantly.
- Find customer call recordings faster with get_call to prep for follow-up meetings.
- Monitor campaign reach across multiple regions using list_campaigns without switching tabs.
- Manage your entire outreach database by pulling contact profiles with list_contacts.
- Debug your automation faster by inspecting webhook triggers with list_webhooks.
- Audit your communication history by reviewing every sent message with get_text.

## How It Works

The bottom line is you get a direct line to your CallFire data without the manual clicking.

1. Subscribe to the CallFire MCP on the Vinkius Marketplace.
2. Enter your CallFire API Login and API Password from your account settings.
3. Start managing your communications from Claude, Cursor, or any MCP-compatible client.

## Frequently Asked Questions

**Can the CallFire MCP help me see if my texts were delivered?**
Yes, it can. The Connector pulls your full text history, allowing your agent to show you the exact delivery status for every message sent.

**How do I use CallFire MCP to find a specific customer's phone number?**
You just ask your agent to find the contact. The Connector will search your database and return the phone number and other metadata instantly.

**Can CallFire MCP show me my call history?**
Yes, it lists all your inbound and outbound calls. You can ask for a full list or have the agent find specific calls based on duration or status.

**Does CallFire MCP work with Claude or Cursor?**
It works with any MCP-compatible client, including Claude, Cursor, and Windsurf. You just connect it via Vinkius and start chatting.

**Can I use CallFire MCP to check my broadcast campaign performance?**
Yes, it allows you to view all your voice and text campaigns. Your agent can then summarize the reach and performance metrics for you.

**What happens if a text message fails in CallFire MCP?**
The Connector retrieves the delivery status, so your agent can tell you exactly why it failed, such as a carrier block or an invalid number.

**Can I review the full history of calls and text messages for a specific contact?**
Yes. Use `list_calls` to browse all call records and `get_call` with a specific Call ID for full details including duration, recording URL, and disposition. For SMS, use `list_texts` to browse messages and `get_text` for individual message content and delivery status.

**Does CallFire require two separate credentials?**
Yes. CallFire uses HTTP Basic Authentication with an **API Login** (username) and an **API Password**. Both are generated in your CallFire account under Settings > API Access. They are separate from your dashboard login credentials.

**Can I monitor my active broadcast campaigns and their delivery status?**
Yes. The `list_campaigns` tool retrieves all voice and text broadcast campaigns with their status (active, paused, finished). Use `get_campaign` with a Campaign ID to inspect configuration details, delivery rates, and audience targeting. Combine with `list_webhooks` to verify event-driven notifications are configured correctly.