MCP.so
Sign In

Adbutler

@adbutler

Repository

About Adbutler

MCP server for the AdButler ad management API — 36 tools for AI assistants

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

200

List all advertisers in your AdButler account

Get details of a specific advertiser by ID

Create a new advertiser

Update an existing advertiser

Delete an advertiser

Archive an advertiser (soft-delete, can be restored later)

List all archived advertisers

Get details of a specific archived advertiser

Restore an archived advertiser back to active status

List all campaigns across all types

List all standard campaigns

Get details of a specific standard campaign

Create a new standard campaign

Update an existing standard campaign

Delete a standard campaign

Archive a standard campaign (soft-delete, can be restored later)

List all archived standard campaigns

Get details of a specific archived standard campaign

Permanently delete an archived standard campaign

Restore an archived standard campaign back to active status

Get conversion tag for a campaign

Get eligible zones for a campaign

Bulk create catalog ad items in a campaign

Bulk delete catalog ad items from a campaign

List all campaign assignments (ad items assigned to campaigns)

Get details of a specific campaign assignment

Create a new campaign assignment (assign an ad item to a campaign)

Update an existing campaign assignment

Delete a campaign assignment

List all channels

Get details of a specific channel

Create a new channel

Update an existing channel

Delete a channel

Archive a channel (soft-delete, can be restored later)

List all archived channels

Get details of a specific archived channel

Permanently delete an archived channel

Restore an archived channel back to active status

List all channel zone assignments

Get details of a specific channel zone assignment

Assign a zone to a channel

Remove a zone from a channel

List all zones across all types (standard, email, catalog)

List all standard zones

Get details of a specific standard zone

Create a new standard zone. Set dimensions to "dynamic" for a dynamic zone (width/height must be 0), or "fixed" (default) for a fixed-size zone.

Update an existing standard zone

Delete a standard zone

Get the ad serving tag (embed code) for a zone

Get the conversion tracking tag for a standard zone

Generate ad serving tags for multiple zones at once

Archive a standard zone (soft-delete, can be restored later)

List all archived standard zones

Get details of a specific archived standard zone

Restore an archived standard zone back to active status

List all email zones

Get details of a specific email zone

Create a new email zone for serving ads in email newsletters

Update an existing email zone

Delete an email zone

Get the ad serving tag for an email zone

Get the conversion tracking tag for an email zone

Archive an email zone

List all archived email zones

Get details of a specific archived email zone

Restore an archived email zone back to active status

List all catalog zones (for product/retail ad serving)

Get details of a specific catalog zone

Create a new catalog zone for product/retail ad serving

Update an existing catalog zone

Delete a catalog zone

Get the ad serving tag for a catalog zone

List all publishers in your AdButler account

Get details of a specific publisher

Create a new publisher

Update an existing publisher

Delete a publisher

Archive a publisher (soft-delete, can be restored later)

List all archived publishers

Get details of a specific archived publisher

Restore an archived publisher back to active status

List all ad items (banners) across all types (image, custom HTML, rich media, native, catalog)

List all image ad items

Get details of a specific image ad item

Create a new image ad item (banner)

Update an existing image ad item

Delete an image ad item

Get conversion tracking tag for an image ad item

List all custom HTML ad items

Get details of a specific custom HTML ad item

Create a new custom HTML ad item

Update an existing custom HTML ad item

Delete a custom HTML ad item

Get conversion tracking tag for a custom HTML ad item

List all rich media ad items

Get details of a specific rich media ad item

Create a new rich media ad item

Update an existing rich media ad item

Delete a rich media ad item

Get conversion tracking tag for a rich media ad item

List all native ad items

Get details of a specific native ad item

Create a new native ad item using a native template

Update an existing native ad item

Delete a native ad item

Get conversion tracking tag for a native ad item

List all catalog ad items

Get details of a specific catalog ad item

Create a new catalog ad item

Update an existing catalog ad item

Delete a catalog ad item

Convert a native ad item to an image ad item

List all creatives across all types (image, rich media, video, audio)

List all image creatives

Get details of a specific image creative

Create a new image creative. The API uses multipart file upload — pass the media group ID and file attributes.

Update an existing image creative

Delete an image creative

List all rich media creatives

Get details of a specific rich media creative

Create a new rich media creative. The API uses multipart file upload (ZIP for HTML5).

Update an existing rich media creative

Delete a rich media creative

List all video creatives

Get details of a specific video creative

Create a new video creative. The API uses multipart file upload.

Update an existing video creative

Delete a video creative

List all audio creatives

Get details of a specific audio creative

Create a new audio creative. The API uses multipart file upload.

Update an existing audio creative

Delete an audio creative

Replace the file on an image creative

Replace the file on a rich media creative

Replace the file on a video creative

Replace the file on an audio creative

List all placements (assignments of ad items to zones)

Get details of a specific placement

Create a new placement (assign an ad item or campaign to a zone or channel)

Update an existing placement

Delete a placement (remove an ad item from a zone)

Get conversion tracking tag for a placement

List all native ad templates

Get details of a specific native template

Create a new native ad template with HTML and variable placeholders

Update an existing native template. Variables uses add/remove format for updates.

Delete a native template

List all schedules (time-based delivery rules for ad items)

Get details of a specific schedule

Create a new schedule for time-based ad delivery. Schedules are automatically linked to ad items via placements.

Update an existing schedule

Delete a schedule

List all media groups (collections of creatives)

Get details of a specific media group

Create a new media group

Update an existing media group

Delete a media group

List all data keys (custom key-value targeting variables)

Get details of a specific data key

Create a new data key for custom targeting

Update an existing data key

Delete a data key

List all data key targets (targeting rules using data key values)

Get details of a specific data key target

Create a new data key target (targeting rule)

Update an existing data key target

Delete a data key target

List all day parting rules (time-of-day targeting)

Get details of a specific day parting rule

Create a new day parting rule for time-of-day targeting. Ranges is an object with day names as keys and arrays of time range strings (e.g. "09:00:00-17:00:00") as values.

Update an existing day parting rule

Delete a day parting rule

List all geo targets (geographic targeting rules)

Get details of a specific geo target

Create a new geo target for geographic targeting. Areas is an array of objects with continent, country (2-letter code), region, city fields.

Update an existing geo target

Delete a geo target

List all postal code targets

Get details of a specific postal code target

Create a new postal code target

Update an existing postal code target

Delete a postal code target

List all list targets (allowlist/blocklist targeting)

Get details of a specific list target

Create a new list target (inclusion/exclusion using a data list)

Update an existing list target

Delete a list target

List all platform targets (device/OS/browser targeting)

Get details of a specific platform target

Create a new platform target for device/OS/browser targeting

Update an existing platform target

Delete a platform target

List all data targets

Remove all usages of a list target

Get display advertising report with impressions, clicks, and CTR

Get VAST video advertising report

Get event logs for account activity (changes, logins, etc.)

Get click details report

Overview

length.## What is Adbutler?

Adbutler is an MCP server that lets you manage your entire AdButler account from any AI assistant (Claude, ChatGPT, Cursor, etc.). It exposes the full AdButler v2 API — 600+ tools covering advertisers, campaigns, zones, creatives, placements, VAST video, programmatic/RTB, reporting, targeting, drafts, contracts, and product catalogs — plus 9 pre-built workflow prompts for common tasks.

How to use Adbutler?

Two options: hosted (recommended) – configure your MCP client with the URL https://mcp.adbutler.com/mcp (or /sse for legacy) and pass your AdButler API key via an Authorization: Bearer header. Local stdio – run npx -y @adbutler/mcp-server with the environment variable ADBUTLER_API_KEY set in your client‘s MCP config. No API key? The hosted server guides you through a free trial signup.

Key features of Adbutler

  • 600+ tools covering 100% of the AdButler v2 API (604 endpoints)
  • 9 workflow prompts for end-to-end tasks (campaign launch, reporting, VAST video, etc.)
  • 3 fallback meta-tools: search, describe, and call any API endpoint
  • Supports both hosted (Streamable HTTP/SSE) and local stdio deployment
  • Works with any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline)
  • Hosted version collects only anonymous usage analytics; self-installed copies collect nothing

Use cases of Adbutler

  • Launch and manage display advertising campaigns with targeting and budgets
  • Set up VAST 4.2 video ads with linear creatives and companion banners
  • Generate custom reports with specific dimensions, filters, and scheduling
  • Configure programmatic deals, bidders, and PMP deals for RTB
  • Stage complex campaigns as drafts before publishing atomically

FAQ from Adbutler

What authentication is needed?

You need an AdButler API key from the dashboard (Settings → API Keys). For hosted use, pass it via an Authorization: Bearer header or configure it inside the chat using the setup_api_key tool. For local installs, set the ADBUTLER_API_KEY environment variable.

Can I try Adbutler without an existing account?

Yes. Connect to the hosted MCP without authentication and the AI will guide you through a free trial signup, using create_trial_account and verify_trial_email tools.

Does the hosted server collect my data?

Only anonymous usage analytics: tool name, account ID, key fingerprint, transport type, call duration, and error details. Tool arguments, response bodies, and raw API keys are never collected. The npm/self-hosted version collects nothing.

Which transports does the hosted server support?

It supports both Streamable HTTP at /mcp and legacy SSE at /sse. New clients should prefer Streamable HTTP.

What MCP clients are compatible

Frequently asked questions

What authentication is needed?

You need an AdButler API key from the dashboard (Settings → API Keys). For hosted use, pass it via an `Authorization: Bearer` header or configure it inside the chat using the `setup_api_key` tool. For local installs, set the `ADBUTLER_API_KEY` environment variable.

Can I try Adbutler without an existing account?

Yes. Connect to the hosted MCP without authentication and the AI will guide you through a free trial signup, using `create_trial_account` and `verify_trial_email` tools.

Does the hosted server collect my data?

Only anonymous usage analytics: tool name, account ID, key fingerprint, transport type, call duration, and error details. Tool arguments, response bodies, and raw API keys are never collected. The npm/self-hosted version collects nothing.

Which transports does the hosted server support?

It supports both Streamable HTTP at `/mcp` and legacy SSE at `/sse`. New clients should prefer Streamable HTTP.

Comments

Basic information

Category

Other

Transports

stdio

Author

adbutler

Submitted by

Rob@AdButler

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K