Metrikia Plugin for Claude Code
AI-powered ad tracking and ROI analysis directly in Claude Code. Connect your AI assistant to Metrikia's MCP server and access campaigns, leads, attribution, and Diana AI insights.
What is Metrikia?
Metrikia is a SaaS platform that correlates ad investments (Meta, Google, TikTok) with CRM sales data to calculate real ROI. It provides multi-touch attribution (9 models including Shapley and Markov), lead pipeline tracking, creative performance analysis, and Diana AI for strategic recommendations. Built for Media Buyers, Creative Strategists, Performance Managers, and Ad Agencies.
Installation
From GitHub (recommended)
No API key to configure. The plugin signs in with OAuth: the first time you call a Metrikia tool, your browser opens to connect your account, and the session renews automatically.
In Claude Code:
# Step 1: Add the marketplace
/plugin marketplace add BULDEE/metrikia-claude-plugin
# Step 2: Install the plugin
/plugin install metrikia@BULDEE-metrikia-claude-plugin
# Step 3: Restart Claude Code
exit
claude
On the first Metrikia tool call, a browser window opens. Sign in to Metrikia (if needed) and click Authorize. That is all: no key to paste, and access can be revoked at any time from your Metrikia settings.
From Local Path
# If you cloned the repo locally
git clone https://github.com/BULDEE/metrikia-claude-plugin.git
/plugin marketplace add /path/to/metrikia-claude-plugin
/plugin install metrikia@metrikia-plugin
Verify Installation
# Open plugin manager
/plugin
# Go to "Installed" tab to see metrikia plugin
# Go to "Errors" tab if skills don't appear
The plugin runs an automatic health check at startup. If you see "Metrikia Plugin Active", everything is connected.
Official Marketplace (coming soon)
When published to the official Claude Code marketplace:
claude plugin install metrikia
Health Check
At every session start, the plugin automatically verifies that the MCP server at mcp.metrikia.io is reachable. Authentication itself is handled by OAuth on the first tool call (a one-time browser sign-in), so there is no key to check.
If the server is unreachable, you get a clear warning with instructions, no silent failures.
What's Inside
Skills (6)
| Skill | Description |
|---|
/metrikia:weekly-report | Generate a weekly ad performance report with MER, ROAS, anomalies, and Diana recommendations |
/metrikia:campaign-audit | Deep audit of a specific campaign with creative breakdown and attribution insights |
/metrikia:lead-pipeline | Analyze CRM pipeline health, conversion rates, and source attribution |
/metrikia:budget-optimizer | Optimize budget allocation using MTA attribution data |
/metrikia:creative-analysis | Identify winning/losing creatives, fatigue signals, and scaling opportunities |
/metrikia:attribution-deep-dive | Multi-touch attribution analysis with journey mapping and channel valuation |
Agents (2)
| Agent | Description |
|---|
media-buyer | Senior Media Buyer for campaign optimization, budget allocation, and scaling strategies |
growth-analyst | Growth Analyst for funnel analysis, attribution modeling, and revenue correlation |
MCP Tools (17)
Campaigns: list_campaigns, get_campaign_performance, get_creative_report, compare_performance
Leads/CRM: list_leads, get_lead, list_deals
Attribution: get_attribution_journey, get_budget_advice
Metrics: get_metrics, get_anomalies, get_sync_status
Diana AI: ask_diana
Write: create_lead, transition_lead, create_deal, trigger_sync
Examples
Simple - Quick Status Check
"How are my campaigns performing this week?"
Claude uses get_metrics and compare_performance to fetch your real data and returns a summary with week-over-week trends. No dashboard navigation needed.
Simple - Lead Quality by Source
"Which ad platforms bring leads that actually close as deals?"
Claude calls list_leads, list_deals, and get_attribution_journey to correlate CRM data with ad sources - something that normally requires exporting CSVs from multiple tools and joining them manually.
Intermediate - Weekly Report with Anomaly Detection
/metrikia:weekly-report
Generates a structured report in one shot:
- Aggregated metrics (MER, ROAS, CPA, CPL) with week-over-week trends
- Top/bottom campaigns ranked by ROAS
- Anomaly detection (spend spikes, CTR drops, conversion rate shifts)
- Diana AI strategic recommendations
- Concrete next actions with priority
What Claude Code alone can't do: Access your live campaign data, calculate real MER across platforms, or detect anomalies based on your historical performance.
Intermediate - Creative Fatigue Analysis
/metrikia:creative-analysis
