# Marchex MCP for AI Agents AI Agent Connect

> Marchex MCP gives your AI agent direct access to your conversation intelligence data. You can track calls, manage campaigns, and pull performance metrics without leaving your chat window. It connects your Marchex account to any MCP-compatible client so you can audit lead attribution and phone number performance in real-time.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_y885XTRpPQ9feNSuJ353LdqfvTmQsLw2Lb0yTr8V/ai-agent-connect
- **Tags:** call-tracking, conversation-intelligence, lead-attribution, telephony-analytics, campaign-performance

## Description

You spend half your day jumping between different tabs just to see if your latest campaign is actually reaching people. You have to log into the Marchex dashboard, filter through dozens of tracking numbers, and then manually export some analytics just to get a sense of how your lead attribution is holding up. It is a lot of clicking for information that should be readily available. This Connector changes that by letting your AI agent do the heavy lifting. Instead of hunting for data, you just ask your agent to summarize the performance of a specific campaign or find the details on a high-priority call. It pulls the numbers directly into your workflow, so you can spend your time making decisions rather than gathering data. Because Vinkius makes it so simple to connect these types of tools, you can get your Marchex data into Claude or Cursor in minutes. You get a clear view of your account structure, call metadata, and user lists without ever having to navigate the full dashboard again. It turns your conversation intelligence into a conversation with your agent.

## Tools

### get_call_details
Fetch the full metadata for a specific phone call. This is useful for deep-diving into a single customer interaction.

### get_campaign_details
See the specific configurations and settings for a campaign. Use it to verify that your tracking is set up correctly.

### list_campaigns
See all your active and past tracking campaigns at once. This is the quickest way to see what is currently running.

### get_number_details
Get the specific details for a single tracking phone number. This helps you verify which number is linked to which campaign.

### list_accounts
Get a full list of all accounts in your Marchex profile. Use this to get a bird's eye view of your entire setup.

### list_numbers
Get a complete list of all your tracking phone numbers. Use this to audit your inventory of available numbers.

### list_users
See a list of all users associated with your Marchex account. This helps with managing permissions and team access.

### search_calls
Find specific phone calls based on your search terms. Use this to quickly locate a call from a specific date or number.

### get_account_details
Get the high-level details for a specific Marchex account. This helps you quickly identify account types and statuses.

### get_call_analytics
Pull aggregated performance metrics for your calls. Use this to see trends over time rather than individual records.

## Prompt Examples

**Prompt:** 
```
Can you show me the analytics for our 'Fall Promo' campaign?
```

**Response:** 
```
I've pulled the analytics for 'Fall Promo'. Here is a summary of the performance:

| Metric | Value |
| :--- | :--- |
| Total Calls | 142 |
| Avg. Duration | 3m 45s |
| Conversion Rate | 12.5% |

**Key Insights:**
*   Calls peaked between 2 PM and 4 PM.
*   The duration is 15% higher than the previous campaign.
```

**Prompt:** 
```
Search for any calls from +15550123 today.
```

**Response:** 
```
I found 2 calls from that number today:

*   **Call ID: 98234**
    *   Status: Completed
    *   Duration: 00:02:15
*   **Call ID: 98245**
    *   Status: Completed
    *   Duration: 00:01:45
```

**Prompt:** 
```
List all my active tracking campaigns.
```

**Response:** 
```
You have 4 active campaigns currently running:

1.  **Spring Sale** (ID: 5501)
2.  **Google Ads_Test** (ID: 5502)
3.  **Facebook_Retargeting** (ID: 5503)
4.  **Fall Promo** (ID: 5504)
```

## Capabilities

### Fetch call metadata
Get specific details on phone calls like duration and status.

### Search call history
Find specific phone calls based on your search criteria.

### List tracking campaigns
See all your active and past campaigns in one list.

### Inspect campaign configs
View the specific settings for any given campaign.

### Manage phone numbers
View and manage your tracking numbers and account structure.

### Pull call analytics
Get aggregated data on your call performance and trends.

### Audit account details
Access the high-level details of your Marchex accounts.

## Use Cases

### The Campaign Audit
A marketing manager asks the agent to list all active campaigns and check the details of the Spring Sale to ensure the tracking numbers are correct.

### The Lead Deep-Dive
A sales lead asks the agent to search for calls from a specific number last week and get the full details for the longest one.

### The Performance Report
An analyst asks the agent to pull call analytics for today to see the average duration and total call volume for a weekly report.

### The Account Cleanup
An ops person asks the agent to list all accounts and users to see if there are any old profiles that need to be removed.

## Benefits

- Stop manual data exports by using get_call_analytics to pull performance metrics directly into your chat.
- Find specific interactions faster by using search_calls to filter through your history without clicking through pages.
- Verify campaign setup instantly with get_campaign_details to ensure your tracking is accurate.
- Audit your entire phone number inventory using list_numbers to keep your tracking organized.
- Manage team access easily by using list_users to see who has permissions in your Marchex account.
- Get a full overview of your account structure by using list_accounts and get_account_details in one go.

## How It Works

The bottom line is you get direct, natural language access to your Marchex conversation intelligence.

1. Subscribe to the Marchex MCP via the Vinkius marketplace.
2. Provide your Marchex Client ID and Secret in your AI client's configuration.
3. Ask your agent to list campaigns or search for calls to see the data appear.

## Frequently Asked Questions

**Can the Marchex MCP help me see my call performance?**
Yes, it lets your AI agent pull aggregated call analytics so you can see trends like average duration and total call volume without opening a dashboard.

**How does the Marchex MCP manage my tracking numbers?**
You can ask your agent to list all your tracking numbers or get specific details on any individual number to see how it's configured.

**Can I use the Marchex MCP to find specific calls?**
Yes, you can ask your agent to search for calls using specific criteria, and it will pull the metadata for the results it finds.

**Does the Marchex MCP work with Claude or Cursor?**
It works with any MCP-compatible client, including Claude, Cursor, and Windsurf, as long as you have your Marchex credentials set up.

**Can I use the Marchex MCP to audit my account users?**
Yes, the Connector allows your agent to list all users associated with your Marchex account, making it easy to check permissions.

**How do I get my Marchex data into my AI agent?**
You just need to subscribe to the Connector on Vinkius and enter your Marchex Client ID and Secret in your AI client's settings.

**How do I find my Marchex Client ID and Secret?**
Log in to the Marchex Developer Console and create an application to receive your credentials.

**What call data can I access?**
You can access call metadata, duration, caller info, status, and aggregated performance metrics.

**Is my integration secure?**
Absolutely. Your credentials are encrypted at rest and injected securely at runtime.