# Measured MCP

> Measured connects your AI agent directly to complex marketing performance data. It tracks ROAS, calculates true causal impact scores across channels, and provides deep cross-channel attribution insights—all through natural conversation with simple commands.

## Overview
- **Category:** business-intelligence
- **Price:** Free
- **Tags:** marketing-attribution, roas-tracking, performance-analytics, incrementality, reporting

## Description

Measured connects your AI agent directly to complex marketing performance data. You don't have to log into a dozen dashboards or wrestle with massive spreadsheets—you just talk to the server, and it does the heavy lifting.

**Getting Started: Knowing Your Data Sources**
You gotta know what you're working with first. Use `list_channels` when you need a rundown of every single marketing platform we're tracking data for—think Facebook, Google Ads, or whatever else you run ads on. If you wanna check the system guts out, `list_integrations` shows you a complete list of all the external systems and data sources Measured is currently pulling information from.

**Understanding Your Reports and Performance**
Before digging in, use `list_reports` to pull up a catalog of pre-built performance reports. These are ready for immediate querying by your agent. When you need a bird's-eye view of everything, run the `get_performance_summary`. This tool immediately provides one unified summary of all your marketing spend and revenue across every active channel.

**Drilling Down into Specific Areas**
Need to focus? You can use `get_performance_by_channel` when you want specific metrics for just one platform, like Amazon or LinkedIn. For a deeper dive on just one effort, the `get_campaign_performance` tool retrieves key performance data and metrics for one single marketing campaign you specify.

**Advanced Analytics: Why It Matters**
The real power comes from calculating impact. Use `get_incrementality_scores` when your agent needs to calculate the true causal impact score—this tells you exactly how much a channel contributes beyond what it would have done anyway, which is crucial for budget decisions. When you're not looking at raw numbers but need direction, run `get_insights`. This pulls high-level, narrative marketing advice based on current trends and data patterns, telling you where to move your money or what shifts to watch out for.

***

## Tools

### get_campaign_performance
Retrieves key metrics and performance data for one specific marketing campaign you name.

### get_incrementality_scores
Calculates the true causal impact score to show how much a channel contributes beyond baseline results.

### get_insights
Pulls high-level, narrative marketing advice based on current performance trends and data patterns.

### get_performance_by_channel
Gathers all available metrics for a single channel you specify (like Google Ads or Facebook).

### get_performance_summary
Provides an immediate, unified summary of your overall marketing performance across all channels.

### list_channels
Lists every single marketing channel (Facebook, Google Ads, etc.) that Measured is currently tracking data for you.

### list_integrations
Shows you a list of all the external systems and data sources connected to Measured right now.

### list_reports
Retrieves a catalog of pre-built performance reports available for immediate querying.

## Prompt Examples

**Prompt:** 
```
List all active marketing channels in Measured.
```

**Response:** 
```
Retrieving channels... You have several channels integrated including Facebook Ads, Google Search, and Amazon Advertising.
```

**Prompt:** 
```
Show performance for Facebook Ads last month.
```

**Response:** 
```
Fetching performance metrics... For Facebook Ads, spend was $10k with a ROAS of 4.2x and an incrementality score of 0.85.
```

**Prompt:** 
```
What are the latest marketing insights?
```

**Response:** 
```
Querying insights... Measured suggests shifting budget from Retargeting to Brand Search based on recent incrementality trends.
```

## Capabilities

### Get campaign performance details
You request data for a single, specific marketing campaign to see its metrics.

### Calculate channel impact scores
The agent computes true incrementality scores across all your advertising channels.

### Request strategic insights
You ask for narrative advice on where to move budget or what trends to watch out for.

### View performance by channel
The server gathers and displays metrics for a specific platform, like Amazon or LinkedIn.

### Get unified summary report
You ask for a single, high-level overview of all your marketing spend and revenue.

### List tracked channels and integrations
The agent tells you exactly what channels (like Google or Facebook) and data sources are connected to the system.

## Use Cases

### Comparing Paid Search vs. Social Media
A Growth Manager needs to know if their Google Ads spend is actually outperforming Facebook ads this month. They prompt the agent: "Compare Q3 ROAS for Google and Meta." The server calls both `get_performance_by_channel` tools, combines the data, and gives a direct comparison report.

### Determining Budget Shifts
A CMO wants to know if they should move budget. They ask for insights: "Based on recent performance, where should I shift funds?" The agent uses `get_incrementality_scores` and `get_insights`, recommending a strategic pivot based on calculated impact.

### Quick Quarterly Health Check
The analyst needs a fast overview for an executive meeting. They simply prompt: "Give me the overall performance summary." The agent runs `get_performance_summary` and hands over one digestible report, skipping all the platform-specific digging.

### Troubleshooting Missing Data
The team suspects a data feed is broken. They start by running `list_integrations`. If the tool flags an outdated connection or missing credentials for a specific ad account, they know where to start the fix before querying any performance metrics.

## Benefits

- Stop jumping between platforms. Use `get_performance_summary` to get a single, unified view of spend and revenue across all 300+ managed integrations. You don't need five dashboards; you need one answer.
- Understand true impact with `get_incrementality_scores`. Don’t guess which channel works best—run the tool that calculates causal attribution so you know exactly where your budget should go.
- Get actionable advice, not just numbers. Instead of raw data dumps, prompt for insights and let the agent run `get_insights` to suggest real changes, like shifting spend from Retargeting to Brand Search.
- Drill down fast. If Facebook is underperforming, don't scroll through months of data. Use `get_performance_by_channel` to isolate metrics just for that platform and pinpoint the weak spots instantly.
- See your whole setup at a glance. Call `list_channels` or `list_integrations` to confirm that all your ad accounts are connected before you start running big reports.

## How It Works

The bottom line is: You talk to your AI client, and the server does the complex data stitching for you.

1. Subscribe to the Measured server and enter your API key.
2. Your AI client sends a natural language request (e.g., "What was our ROAS for Q2?").
3. The agent identifies the right tool (`get_performance_summary`), calls it, receives structured data, and presents you with an interpreted answer.

## Frequently Asked Questions

**How does Measured calculate ROAS using get_performance_summary?**
The server pulls spend and revenue data from multiple integrations, calculates the ratio for you, and presents a unified figure. It doesn't just show raw numbers; it synthesizes them into one quick metric.

**Can Measured help me compare different marketing channels?**
Yes. Use `get_performance_by_channel` to isolate metrics for individual platforms, or ask the agent to use multiple tools in sequence to give you a direct side-by-side comparison.

**What is incrementality using get_incrementality_scores?**
Incrementality measures the true lift a channel provides above what it would have achieved anyway. The tool gives you that score, so you know which channels are truly driving growth versus just adding noise.

**How do I see all available data sources for Measured?**
You can run the `list_integrations` tool. This shows exactly which external systems (like Google Ads, Facebook, etc.) have been connected and are feeding data into the server.

**What credentials do I need to use the `get_performance_summary` tool?**
You must provide a valid Measured API Key when setting up the server. This key authorizes your AI client, allowing it to pull live performance data securely.

**Are there rate limits if I use `list_channels` repeatedly?**
Yes, running too many calls in quick succession can hit API rate limits. For large-scale channel analysis, you should process the required channels in structured batches.

**What does an error mean if `get_campaign_performance` fails?**
The tool returns specific error codes that pinpoint the failure reason—it could be an invalid campaign ID or API access issue. Your agent can read these codes to help you fix the input data.

**How do I check what reports are available before running `list_reports`?**
`list_reports` immediately gives a structured list of all performance report types accessible through Measured. This tells your agent exactly which datasets it can organize and analyze for you.

**How do I find my Measured API Key?**
You can find your API Key in the Measured platform settings or by contacting your Measured Customer Success Manager (CSM).

**What is an incrementality score?**
It measures the true causal impact of your ad spend on business outcomes, going beyond standard last-click attribution.

**Is my marketing data secure?**
Absolutely. Your token is encrypted at rest and injected securely at runtime.