Kelpi
MCP server for Meta Ads

Meta Ads MCP: inspect your ad account from Claude

Connect Kelpi once, generate an MCP token, then ask your assistant to inspect campaigns, budgets, creative, tracking, and performance without pasting exports.

Create MCP token
What it does

A read layer for campaign, creative, tracking, and spend questions.

Meta Ads MCP lets your assistant ask the questions a paid media manager asks every week: what changed, what is spending, what is stale, and what needs a closer look.

The token requires a Kelpi account so you can connect Meta, rotate access, and keep assistants scoped to the ad accounts you choose.

Tools

account_summary

Read account currency, timezone, spend status, and connected assets.

campaigns_list

List campaigns with objective, status, spend, and delivery notes.

adsets_list

Inspect budgets, audiences, placements, optimization goals, and schedules.

ads_list

Review active ads, creative names, previews, links, and performance fields.

insights_query

Query spend, impressions, clicks, conversions, CPA, CPC, CTR, and frequency. CTR is a diagnostic, not the goal.

tracking_health

Check pixel, event, and conversion setup signals.

Setup

Add Kelpi to Claude Desktop, Claude Code, or Cursor.

Claude Desktop

{
  "mcpServers": {
    "kelpi-meta-ads": {
      "command": "npx",
      "args": ["-y", "@kelpi/meta-ads-mcp"],
      "env": {
        "KELPI_MCP_TOKEN": "kelpi_your_token_here"
      }
    }
  }
}

Claude Code

claude mcp add kelpi-meta-ads \
  --env KELPI_MCP_TOKEN=kelpi_your_token_here \
  -- npx -y @kelpi/meta-ads-mcp

Cursor

{
  "mcpServers": {
    "kelpi-meta-ads": {
      "command": "npx",
      "args": ["-y", "@kelpi/meta-ads-mcp"],
      "env": {
        "KELPI_MCP_TOKEN": "kelpi_your_token_here"
      }
    }
  }
}
FAQ
What is the Meta Ads MCP?
It is a Model Context Protocol server that lets AI assistants ask controlled questions about your Meta Ads account through Kelpi.
Is the Meta Ads MCP free?
There is a free tier for lightweight setup and account reads. Heavier usage may require a Kelpi plan.
Which AI assistants does it work with?
Any assistant that speaks MCP, including Claude Desktop, Claude Code, and Cursor. There are ready-made setup snippets for all three.
Is it safe to connect my ad account?
Kelpi gives your assistant a scoped token that can only read the ad accounts you choose. It never sees your Meta password, and you can revoke the token anytime.
Related