# CallGear MCP

> CallGear MCP pulls communication analytics directly into your agent. It lets you track call volume, analyze ad campaign performance, and retrieve reports covering calls, chats, and site traffic—all through natural conversation. Stop exporting CSVs; start asking questions.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** call-tracking, marketing-attribution, analytics, lead-tracking, roi-measurement, communication-analytics

## Description

Connect CallGear to your AI client and get a full view of how people interact with your business. This MCP lets you orchestrate communication analytics and marketing attribution without ever clicking on a dashboard again. You can pull detailed call reports, figure out which advertising sources drive the most traffic, or get daily stats for your entire website. It’s about asking your agent things like, “How did our Q2 ad spend affect chat volume in Texas?” and getting an immediate answer. Instead of juggling separate reports for calls, ads, and site metrics, you pull all that data into a single conversation thread. Accessing this kind of deep reporting is normally a headache, but by connecting through the Vinkius catalog, your agent handles it automatically. You just talk to it.

## Tools

### get_account_info
Retrieves core details about your CallGear account setup.

### get_ad_campaigns_report
Generates daily statistics specifically for tracking advertising campaigns.

### get_calls_report
Provides a detailed report on all calls that happened during a specific time period.

### get_communications_report
Generates a broad report covering various forms of communication, including chats and calls.

### get_site_daily_stats
Pulls daily performance statistics for your main website.

### list_ad_campaigns
Lists all the advertising campaigns currently set up in CallGear.

### list_call_scenarios
Outputs a list of all configured call scenarios for reference.

### list_traffic_sources
Lists every configured traffic source that sends users to your site.

### list_tags
Shows all available tags used to categorize calls and communications.

### list_users
Provides a complete list of all user accounts within the CallGear system.

## Prompt Examples

**Prompt:** 
```
Show the calls report from March 1st to March 7th.
```

**Response:** 
```
I've retrieved the calls report. You had 150 incoming calls in that period, with an average duration of 2m 30s. The most common source was 'Google Ads'.
```

**Prompt:** 
```
Which advertising campaigns are active right now?
```

**Response:** 
```
Retrieving active campaigns... You have 3 campaigns running: 'Spring Sale 2026', 'Search Network - Leads', and 'Retargeting Display'.
```

**Prompt:** 
```
Show daily stats for my website for the last 3 days.
```

**Response:** 
```
Retrieving site stats... In the last 3 days, you averaged 50 unique communications per day, with 85% being voice calls and 15% chats.
```

## Capabilities

### Report on call history
Retrieves detailed reports covering all incoming and outgoing calls for any specified date range.

### Assess ad campaign effectiveness
Gets daily aggregated statistics specifically for monitoring various advertising campaigns.

### Review general communications data
Compiles reports that cover multiple interaction types, like calls and chats, so you can check overall service quality.

### Check site traffic metrics
Pulls daily statistics for your website's performance based on time period.

### List team users
Provides a list of all active user accounts within your CallGear setup.

### Identify system tags and sources
Lists configured call scenarios, communication tags, or traffic sources for context.

## Use Cases

### Diagnosing poor campaign performance
The Marketing Analyst needs to know if the recent drop in calls is due to ad spending or site issues. They ask their agent, 'Compare `get_ad_campaigns_report` data against `get_site_daily_stats` for last week.' The agent identifies a dip in organic traffic before the ad spend change.

### Onboarding new team members
The Business Admin needs to know who has access. They prompt, 'List all users and show what tags we use for leads.' The agent runs `list_users` and provides the current tagging structure using `list_tags`, accelerating the setup process.

### Auditing communication channels
The Sales Manager needs a complete picture of customer contact. They ask, 'Give me all comms from the last month.' The agent runs `get_communications_report` and segments the results by source and type.

### Checking infrastructure readiness
The Ops team member wants to verify system setup. They ask, 'Show me all configured traffic sources and call scenarios.' The agent runs `list_traffic_sources` and `list_call_scenarios`, confirming the operational environment.

## Benefits

- Instead of manually exporting and merging reports, you can ask your agent to compare ad campaign performance (`get_ad_campaigns_report`) against call volume data in one query.
- Get a full picture of service quality by requesting the general communication report (`get_communications_report`), which combines calls, chats, and other interactions into one view.
- Track your team's activity immediately. Use `list_users` to maintain visibility or use `get_calls_report` to monitor agent call durations without opening a separate dashboard.
- Establish initial funnel health by checking site-wide daily stats (`get_site_daily_stats`) and cross-referencing the traffic sources responsible for that volume using `list_traffic_sources`.
- Minimize reporting friction. You can get high-level account info (`get_account_info`) or list all active campaigns (`list_ad_campaigns`) instantly to guide a deeper analysis.

## How It Works

The bottom line is that you feed it credentials once, and then you can analyze any communication data using only plain English prompts.

1. Subscribe to this MCP in your preferred client.
2. Input the CallGear Data API Access Token into the connection settings.
3. Ask your agent a question, like 'What were our average call durations last week?' and get an instant report.

## Frequently Asked Questions

**How do I use the get_calls_report tool?**
You ask your agent to retrieve the report and specify a date range. For example, 'Show me the calls report from March 1st to March 7th.' The agent handles calling `get_calls_report` for you.

**Can I see which ads are running right now with list_ad_campaigns?**
Yes. Ask your agent to run `list_ad_campaigns`. It will output all the current and past campaigns listed in your account, helping you verify active sources.

**How do I get my website traffic stats? Use get_site_daily_stats.**
Simply prompt for the daily stats. You can ask, 'Show me site metrics for the last three days.' The agent executes `get_site_daily_stats` and provides a summary of unique communications.

**What does list_users do in CallGear?**
It runs through your user roster. You can ask, 'List all users,' and the agent will provide a current directory of every account in your system using `list_users`.

**How do I verify my connection credentials or check basic account details using get_account_info?**
It returns core information about your CallGear subscription and setup. You can use this to validate that the API token is active and properly linked within your agent's environment.

**What’s the difference between running get_calls_report versus using get_communications_report?**
The communications report provides a broader view, pulling together calls, chats, and other interactions. It gives you overall service quality insight that goes beyond just voice call metrics.

**I need to check all the available calling structures; how do I use list_call_scenarios?**
This tool lists every configured call scenario in your account. It helps you confirm the available calling pathways and structures so your agent can reference them correctly during analysis.

**How can I see what types of tags are used in my communications using list_tags?**
This retrieves a comprehensive list of all call and communication tags you've set up. It’s useful for auditing metadata and ensuring consistent tracking across your entire team.

**Can I check the calls report for a specific week using the agent?**
Yes! Use the `get_calls_report` tool and provide the `date_from` and `date_to` parameters. Your agent will fetch the detailed breakdown of all communications for that period.

**How do I see which marketing source is generating the most calls?**
Simply ask the agent to `get_ad_campaigns_report` or `get_calls_report`. It will retrieve the statistics grouped by source or campaign, allowing you to analyze attribution instantly.

**Does the integration allow listening to call recordings?**
The current toolset focuses on data analytics and metadata retrieval. To listen to recordings, you should use the links provided in the CallGear dashboard or check the `link_to_record` field if available in the report results.