AdButler MCP Server

Manage your entire AdButler account from any AI assistant — Claude, ChatGPT, Cursor, Windsurf, Cline, and any other Model Context Protocol client.

This MCP server exposes the full AdButler v2 API — 600+ tools covering advertisers, campaigns, zones, creatives, placements, VAST video ads, programmatic / RTB, reporting, targeting, drafts, contracts, product catalogs, and more — plus 9 pre-built workflow prompts that walk an AI through common tasks like launching a campaign or setting up retail media.

What you can ask

"Create a new campaign for Pepsi targeting users in Canada with a $5,000 lifetime budget, and assign it to my Homepage Banner zone."

"Show me the top 10 underperforming ad items in the last 7 days by CTR."

"Set up a VAST 4.2 pre-roll campaign with a 30-second skippable creative and three companion banners."

"Walk me through creating a new programmatic deal."

"Audit my ad units — which zones have no active placements?"

The AI translates these into the right sequence of AdButler API calls, runs them, and shows you the result.

Install

You have two options. Most users want the hosted version — zero setup, just paste a URL.

Option A — Hosted (recommended)

Use AdButler's hosted MCP server. No install, no Node, no npm.

The hosted server speaks both modern Streamable HTTP (/mcp) and legacy SSE (/sse) transports. New clients should prefer Streamable HTTP; SSE remains for backward compatibility.

Option B — Local stdio (npm)

Run the server locally as a Node process. Useful if you want to keep your API key out of any external service or run against a self-hosted AdButler.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "adbutler": {
      "command": "npx",
      "args": ["-y", "@adbutler/mcp-server"],
      "env": {
        "ADBUTLER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add adbutler --env ADBUTLER_API_KEY=your_api_key_here -- npx -y @adbutler/mcp-server

Cursor / Windsurf / Cline

Add to the client's MCP config:

{
  "mcpServers": {
    "adbutler": {
      "command": "npx",
      "args": ["-y", "@adbutler/mcp-server"],
      "env": { "ADBUTLER_API_KEY": "your_api_key_here" }
    }
  }
}

Get your AdButler API key

AdButler Dashboard → Settings → API Keys → create a new key. It's the same key the AdButler v2 REST API uses.

Authentication

The AdButler MCP works for both new and existing customers. What you see depends on whether you've already configured an API key.

Already an AdButler customer? (existing API key)

Use one of these:

Option 1 — set the API key in your client config (recommended for hosted)

Add an Authorization: Bearer YOUR_ADBUTLER_API_KEY header on the SSE connection. Examples:

• Claude Desktop — edit claude_desktop_config.json → add headers: { "Authorization": "Bearer YOUR_API_KEY" } next to the SSE URL
• Cursor — MCP server settings → Headers → add Authorization: Bearer YOUR_API_KEY
• Any client — pass the header on the SSE

... View full README on GitHub