# CallFire MCP MCP > CallFire MCP manages high-volume voice and SMS campaigns directly through your AI agent. Use this connector to run broadcast messages, track call metrics, list contacts, and review complete message history at scale. It lets you manage all outreach workflows without switching between separate platforms. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** sms-marketing, voice-broadcast, call-tracking, bulk-messaging, contact-management, outreach ## Description Managing large-scale outreach usually means jumping between a CRM, a messaging dashboard, and a reporting tool just to get a full picture. This MCP changes that by connecting your voice and SMS communications directly into your natural chat flow. You can ask your agent things like, 'Show me all texts sent last week that failed delivery' or 'How many calls did we make to contacts missing phone numbers?' It aggregates data from call logs, message histories, contact records, and campaign performance—all in one conversation thread. Because this MCP is managed by Vinkius, you just connect your credentials once, and your AI agent gets access to the entire communication catalog, letting you focus on outcomes instead of dashboards. ## Tools ### get_call Retrieves the full details for one specified phone call. ### get_campaign Gets all configuration and results for a single broadcast campaign. ### get_contact Fetches the complete profile details for an individual contact. ### get_text Retrieves the content and status of a specific text message exchange. ### get_webhook Shows the configuration details for one defined webhook endpoint. ### list_calls Lists every call record based on specified date ranges or filters. ### list_campaigns Provides an overview and status of all active broadcast campaigns. ### list_contacts Lists every contact record in the system for auditing or segmentation purposes. ### list_texts Provides a list of text messages, showing delivery status and timestamps for review. ### list_webhooks Shows all webhooks set up in the system and their current delivery settings. ## Prompt Examples **Prompt:** ``` Show me all active broadcast campaigns and their delivery rates. ``` **Response:** ``` You have 3 active campaigns. 1) 'Spring Promo SMS' (campaign_4201) — 12,400 messages sent, 98.2% delivery rate, 340 replies received. 2) 'Appointment Reminders' (campaign_4189) — 3,200 calls completed, 67% answered. 3) 'Survey Follow-up' (campaign_4195) — 1,800 texts sent, 94% delivered. Would you like to inspect a specific campaign or check the associated webhooks? ``` **Prompt:** ``` List all text messages sent in the last 24 hours and highlight any that failed delivery. ``` **Response:** ``` Retrieved 847 text messages in the last 24 hours. Delivery breakdown: 812 delivered (95.8%), 28 pending (3.3%), 7 failed (0.8%). Failed messages: 3 to invalid numbers (text_90112, text_90178, text_90234), 2 carrier-blocked (text_90301, text_90445), 2 opt-out recipients (text_90389, text_90501). Would you like to inspect the full content of any failed message? ``` **Prompt:** ``` How many contacts do I have and are there any with missing phone numbers? ``` **Response:** ``` You have 4,231 contacts total. 4,189 have valid phone numbers (99.0%). 42 contacts are missing phone numbers — these were imported from a CSV on March 15. The top 5 contacts by interaction volume: 'Apex Industries' (contact_8901, 47 calls), 'Green Valley Corp' (contact_8234, 38 calls), and 'Metro Health' (contact_7912, 31 calls). Would you like to view details for any contact? ``` ## Capabilities ### Check Contact Records List all contacts in your system or retrieve specific profiles, including phone numbers and associated metadata. ### Review Call Activity Browse detailed records of every call, whether inbound or outbound, noting duration, status, and recording availability. ### Monitor Messaging History View a full archive of sent and received text messages, including delivery statuses and timestamps for each one. ### Track Campaigns List all broadcast campaigns (both voice and text) and inspect their specific configurations and performance metrics. ### Manage Webhooks View configured webhooks, checking delivery settings and the event triggers associated with them. ## Use Cases ### Auditing poor outreach data A marketing manager needs to know which contacts haven't received a message in 60 days. They prompt their agent: 'Show me all inactive contacts.' The agent uses `list_contacts` and filters the results, providing an immediate list of leads ready for re-engagement. ### Building a support case file A customer service analyst gets a complaint. They ask their agent to 'Gather all communications for Contact ID 456.' The agent uses `get_call` and `list_texts`, compiling the call transcript, message history, and campaign details into one response. ### Checking broadcast health A marketing team needs to verify if a recent SMS promotion went out correctly. They ask the agent to 'List all campaigns for the Spring Sale.' The agent uses `list_campaigns` and confirms delivery rates across multiple segments. ### Debugging integrations An integration engineer suspects a webhook isn't firing when calls are made. They prompt the agent to 'List all webhooks related to call events.' The agent uses `list_webhooks` and shows the exact triggers, allowing for rapid debugging. ## Benefits - Audit your entire contact list using `list_contacts` to quickly identify records that are missing phone numbers or haven't been touched in months. This saves time spent manually cross-referencing spreadsheets. - Track campaign performance by listing all campaigns (`list_campaigns`), giving you an instant view of broadcast reach and delivery rates without leaving your AI workspace. - Investigate past client interactions using `get_call` or `get_text`. You can pull up specific call recordings or message threads instantly, which is critical for support case reviews. - Monitor system connections by running `list_webhooks`. This ensures that any external tools relying on your communication data are still properly configured and functioning. - Get immediate reporting. Instead of building a custom query to find all calls from last week, you simply ask the agent using `list_calls` and get actionable metrics back. ## How It Works The bottom line is you manage complex, high-volume communications from a single conversational interface, making reporting immediate. 1. Subscribe to this MCP in Vinkius and enter your CallFire API Login (username) and API Password from your account settings. 2. Authorize your AI client, like Cursor or Claude, to access the connected communication data. 3. Ask your agent a question—for example, 'List all contacts that haven't been called this month.' The MCP executes the call and returns the structured data directly. ## Frequently Asked Questions **How do I check which contacts are missing phone numbers using the list_contacts tool?** The agent uses `list_contacts` and applies filters for incomplete records. It reports back a count of how many contacts lack necessary data, letting you know exactly where your clean-up needs to happen. **Can I check the performance of multiple campaigns at once with list_campaigns?** Yes. You ask the agent to 'List all campaigns for Q2.' The tool uses `list_campaigns` and consolidates the results, giving you a side-by-side view of metrics like messages sent and delivery rates. **What is the difference between get_call and list_calls?** The key difference is scope. Use `list_calls` when you want an overview, filterable by date or status. Use `get_call` only when you have a specific call ID and need all its details. **Does the MCP help me debug webhook issues?** Yes. You can use `list_webhooks` to see what webhooks are configured, and then use `get_webhook` if you suspect a specific endpoint is failing its event triggers. **When I use get_text, what information do I get about a failed message?** The response includes the exact delivery status and the reason for failure. You'll see specific error codes—like 'invalid number' or 'carrier blocked'—which lets you clean up your contact list accurately. **What credentials do I need to connect the MCP and start using list_contacts?** You must provide your CallFire API Login (username) and API Password, which are found in your account settings. Once connected, your agent can immediately access and manage all stored contact data. **When listing webhooks using list_webhooks, how do I check their triggering events?** The tool displays the full configuration details for each webhook. You'll see exactly what event or action is set to trigger it, allowing you to verify if the setup matches your workflow needs. **What specific performance metrics does get_campaign provide?** It gives a deep dive into one broadcast campaign. You retrieve key data points like total messages sent, the overall delivery rate, and counts of replies received for detailed analysis. **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.