KagelDocsLog inGet started
Guide

Getting started with Kagel

Kagel connects your ad and analytics accounts to any MCP-capable AI client — Claude Desktop, Claude Code, Cursor and others. Five minutes from signup to your first campaign report in chat.

1 · Create your account

Sign up at kagel.cc/signup. Your account gets one Bearer key — it authenticates you on every Kagel MCP server. Find it on your dashboard (masked, with Show / Copy).

2 · Connect your platforms

On the dashboard, press Connect on a platform card and sign in through the platform's official OAuth. Kagel stores only the resulting access token — encrypted, isolated to your workspace, revocable with one click (Disconnect).

3 · Add Kagel to your AI client

The dashboard generates this config for you with your real key and only the servers you've connected. The shapes:

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude.

{
  "mcpServers": {
    "kagel-meta": {
      "url": "https://meta.kagel.cc/mcp",
      "headers": { "Authorization": "Bearer YOUR_KAGEL_KEY" }
    },
    "kagel-ga4": {
      "url": "https://ga4.kagel.cc/mcp",
      "headers": { "Authorization": "Bearer YOUR_KAGEL_KEY" }
    }
  }
}

Cursor

Same JSON in ~/.cursor/mcp.json (global) or .cursor/mcp.json in a project.

Claude Code

One command per server:

claude mcp add --transport http kagel-meta https://meta.kagel.cc/mcp --header "Authorization: Bearer YOUR_KAGEL_KEY"

All server URLs

Six servers, one Bearer key
Meta Adshttps://meta.kagel.cc/mcpLaunch and measure Facebook & Instagram campaigns
Google Adshttps://google-ads.kagel.cc/mcpCampaigns, ad groups, keywords, reports
GA4https://ga4.kagel.cc/mcpGoogle Analytics reports and realtime data
Search Consolehttps://gsc.kagel.cc/mcpSearch performance, sitemaps, URL inspection
BigQueryhttps://bigquery.kagel.cc/mcpRead-only SQL over your warehouse
TikTok Adshttps://tiktok.kagel.cc/mcpTikTok's full ads tool set, fronted by Kagel

4 · First prompts to try

Meta Ads

Google Ads

GA4 / Search Console / BigQuery

How approvals work

Reads run immediately. Anything that spends money or changes campaign state comes back as a preview — your assistant shows exactly what will be created (always paused) or changed, and nothing executes until you say approve. Pending actions expire after 15 minutes. You can also say reject or ask to list pending actions.

Troubleshooting

Get started