# LeadsRx MCP

> LeadsRx connects your marketing data to your AI agent so you can analyze attribution and track conversions conversationally. Get campaign ROI, list all touchpoints, understand which channels drive revenue, and even programmatically add new conversion events—all without logging into the LeadsRx dashboard.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** marketing-attribution, customer-journey, roi-tracking, conversion-analytics, multi-touch-attribution

## Description

Connect this MCP to your preferred AI client and get deep insights into how customers move through your sales funnel using plain language. You can ask your agent questions like, 'What was the total ROI for our Q3 social campaigns?' or 'Show me every conversion event from last week.' The tool lets you pull attribution results for specific marketing campaigns, track all defined conversions, and list out primary channels, such as Search or Email. It even gives you full visibility into your entire ecosystem by listing associated agencies and advertisers under your profile. If you're used to jumping between dashboards just to answer a few questions, this MCP changes that. Everything is accessible through natural conversation, managed right here on the Vinkius catalog.

## Tools

### add_conversion
Creates a new record representing a specific conversion event in your account.

### get_campaign_results
Pulls the full attribution results, showing which marketing efforts drove success for a campaign.

### get_conversion_details
Fetches detailed information about one specific conversion goal or event.

### get_touchpoint_details
Retrieves in-depth metadata and performance metrics for a single marketing touchpoint.

### list_advertisers
Returns a list of all connected advertisers managed under your profile.

### list_agencies
Provides a roster of associated marketing agencies linked to the account.

### list_campaigns
Generates a list of all active and past marketing campaigns defined in LeadsRx.

### list_channels
Lists the top-level channels used, such as Search, Social, or Email, across your account.

### list_conversions
Retrieves a comprehensive list of all conversion goals and tracking definitions.

### list_touchpoints
Generates a list of every unique marketing touchpoint that has recorded activity.

## Prompt Examples

**Prompt:** 
```
Get the attribution results for campaign 'Q1-SOCIAL-AD'.
```

**Response:** 
```
I've retrieved the results for 'Q1-SOCIAL-AD'. This campaign has generated 156 conversions with an attributed credit of $4,500.00. The primary touchpoint was 'Facebook Ads'. Would you like to see the full breakdown of touchpoints?
```

**Prompt:** 
```
List all our active marketing campaigns.
```

**Response:** 
```
I've fetched your active campaigns. You have 8 campaigns running, including 'Google Search - Brand', 'Retargeting Promo', and 'Influencer Outreach'. Shall I retrieve the conversion details for any of these?
```

**Prompt:** 
```
Show me our marketing channels and touchpoints.
```

**Response:** 
```
Retrieving your marketing ecosystem... I found 5 primary channels (Search, Social, Display, Email, Referral) and a total of 24 active touchpoints. Would you like to see the performance of the 'Search' channel specifically?
```

## Capabilities

### Analyze campaign performance
Retrieve the specific attribution results and ROI for any given marketing campaign.

### Map customer journeys
List all active marketing touchpoints and deep-dive into conversion details to see how customers arrive at a goal.

### Manage conversions and channels
View all defined conversion goals, list available top-level marketing channels (Search, Social, etc.), or programmatically add new conversion events.

### Audit connected accounts
List all associated marketing agencies and advertisers tied to your LeadsRx profile for a full ecosystem overview.

## Use Cases

### Determining Q2's most successful channel
A marketing manager needs to know if Search or Social drove more value. They tell their agent, 'Compare the performance of our campaigns across all channels.' The agent uses list_campaigns and then pulls granular data via get_campaign_results, giving a direct comparison report.

### Debugging a missed conversion event
A growth team member suspects a specific lead form didn't register. They ask their agent to list all conversions using list_conversions, then use get_conversion_details on the suspect event ID to verify if the tracking fired correctly.

### Preparing for an agency review
An analyst needs a quick overview of who is involved. They ask their agent to list associated marketing agencies using list_agencies, and then use list_advertisers to confirm all current partners are accounted for.

### Building an automated report on touchpoints
A data analyst needs a master list of every interaction point. They ask the agent to list marketing touchpoints using list_touchpoints, and then fetch specific performance metrics for any one item via get_touchpoint_details.

## Benefits

- Stop opening the LeadsRx dashboard just to check a number. You can ask your agent directly for attribution results using get_campaign_results, getting instant insights into ROI without clicking anything.
- Understand where customers come from by listing all primary channels with list_channels and mapping every step through the customer journey using list_touchpoints.
- Don't rely on manual data entry. If a new conversion happens, you can use add_conversion to record it instantly via your agent, ensuring real-time accuracy.
- Get a full picture of who manages your account by listing associated marketing agencies with list_agencies and reviewing all connected advertisers using list_advertisers.
- When you need proof of performance, calling get_conversion_details gives you the specific metrics needed to defend budget requests in meetings.

## How It Works

The bottom line is you get immediate answers about your marketing funnel without ever opening a web dashboard.

1. Subscribe to this MCP and provide your LeadsRx API key.
2. Ask your AI agent to run an analysis, such as 'Show me the attribution results for Campaign X.'
3. The agent pulls the required data—like conversion details or touchpoint metrics—and presents the full answer in natural language.

## Frequently Asked Questions

**How do I use the LeadsRx MCP to find campaign ROI?**
You use get_campaign_results and provide the name or ID for the marketing campaign. The agent returns a summary of conversions and attributed credit, letting you understand performance at a glance.

**Can I list all my active conversion goals with LeadsRx MCP?**
Yes, calling list_conversions gives you a roster of every defined goal. You can then use get_conversion_details to inspect the specific rules and metrics for any single one.

**What is the difference between list_touchpoints and list_channels in LeadsRx?**
list_channels provides the broad categories, like Search or Email. list_touchpoints gives you every actual interaction point—the specific ad creative or landing page view—that occurred within those broader channels.

**Does LeadsRx MCP let me manually add conversions?**
It does. You can use the add_conversion tool, which lets your agent programmatically log a new conversion event into your system if it wasn't automatically tracked.