code Open source · Free

Build your own MCP for Paid Media. Claude answers with real data.

Paid Media MCP is an open-source server that connects Claude to your Google Ads, Meta Ads and TikTok Ads accounts with read-only access. Ask in plain language from Claude and get analysis on real data. No dashboards, no exporting CSVs, nothing sent outside your machine.

download View on GitHub Want me to set it up?
lock 100% local credentials visibility Read-only bolt Node ≥ 20 · stdio
How it works

An open protocol between your platforms and the AI

MCP (Model Context Protocol) is Anthropic's open standard for connecting AI assistants to external data. The server exposes your accounts as tools that Claude can query, all normalized into a single format.

Your platforms
Google Ads
Meta Ads
TikTok Ads
MCP server Paid Media MCP 16 tools · read-only
Your assistant
Claude

Claude Desktop · Claude Code · any MCP client

16 tools

Ask the way you'd talk to your analyst

Four tool areas, all read-only and normalized across Google, Meta and TikTok. Claude picks the right tool based on what you ask.

monitoring

Performance 6 tools

Spend, conversions, ROAS by campaign and by day. Normalized across all 3 platforms.

schedule

Temporal 2 tools

Hour of day × day of week. Find anomalies in the finest detail.

troubleshoot

Diagnostics 6 tools

Search terms, Quality Score, impression share, z-score anomalies, auction insights.

tune

Normalized 2 tools

CTR, CPC, CPM, CPA, conversion value and ROAS. Standardizes calculations and matches metric names across channels.

visibility Read-only: Claude reads, it never touches campaigns or bids.

Beyond paid media

And this is only the beginning

The free MCP covers paid media. But the same approach scales to your whole business: I connect Claude to your CRM, ERP and CMS too and build a custom dashboard where spend meets real pipeline, margins and content.

  • hub CRM → leads, SQLs and won deals next to spend
  • payments ERP → real margin, not just platform ROAS
  • article CMS → which content feeds which campaign
  • dashboard Ad-hoc dashboard, built for your operation
Let's talk about your case arrow_forward
Quickstart

Up and running in 4 steps

You need Node ≥ 20 and your platform tokens. Full documentation is in the repo.

terminal · paid-media-mcp

# 1 · Clone the repo

$ git clone https://github.com/Pauesome/Paid-Media-MCP

# 2 · Install and build

$ npm install && npm run build

# 3 · Add your credentials

$ cp .env.example .env

# 4 · Connect to Claude (stdio), done ✦

menu_book Read the documentation
Why it matters

From export-to-Excel to a dialogue with your data

Without MCP

What you did until now

  • closeOpen 3 platforms, export CSVs, paste them into a sheet
  • closeMetrics with different names in each tab
  • closeYou spend hours finding anomalies and producing analysis
  • closeYou use third-party tools to analyze the data accurately
With Paid Media MCP

Ask and analyze in minutes

  • check"Where do I put the spend?" in plain language
  • checkMetrics normalized across Google, Meta and TikTok
  • checkAnomaly detection by deviation, filtering out volatility
  • checkEverything done locally, zero data sent outside

Prefer I set it up for you?

The MCP is free and open source: install it yourself. But if you want it left connected to your stack, with custom skills and subagents (audits, budget strategy, a dashboard crossing paid with CRM and ERP), I'll build it. My own personal MCP currently blends data from ads platforms, CRM, ERP, creative tools and custom reports.

  • check_circle Full setup and connection to your accounts
  • check_circle Custom skills and subagents on top of the MCP
  • check_circle Ad-hoc dashboard with CRM · ERP · CMS