AdButler

NPM · @ADBUTLER/MCP-SERVER · 3 COMPONENTS · SCANNED AUG 3

Manage AdButler campaigns, zones, ad items, VAST, and reports from Claude, ChatGPT, and Cursor.

Available components

remote · mcp.adbutler.com 67 remote · mcp.adbutler.com 36 npm · @adbutler/mcp-server 71

+18 this week 71 71 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 18 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability82

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 34549 tokens (~55/item across 619 items; 619 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @adbutler/mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add com-adbutler-mcp-server -- npx -y @adbutler/mcp-server

# add to Codex CLI

codex mcp add com-adbutler-mcp-server -- npx -y @adbutler/mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-adbutler-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@adbutler/mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add com-adbutler-mcp-server --command npx --arg -y --arg @adbutler/mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  com-adbutler-mcp-server:
    command: "npx"
    args: ["-y", "@adbutler/mcp-server"]

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +49
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Dependency health: partial → unverified ▼ functional
- Schema quality: unverified → good ▲ functional
- Stability: unverified → 0.23 ▲ functional
- License: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → 100 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: MIT functional
1 Aug 26 −14
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 53

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@adbutler/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 619 exposed · ~34,549 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

create_media_group ~25

Create a new media group

Input Output Examples

Name	Type	Req	Description
name	string	yes	Media group name

No output schema declared.

No examples provided.

create_native_ad_item ~142

Create a new native ad item using a native template

Input Output Examples

Name	Type	Req	Description
height	number	—	Ad height in pixels
location	string	—	Click-through URL
metadata	object	—	Custom metadata key-value pairs
name	string	yes	Ad item name
template	number	yes	Native template ID
tracking_pixel	string	—	Third-party tracking pixel URL
tracking_pixels	array	—	Array of tracking pixel URLs
trusted_redirect_domains	array	—	Trusted redirect domains
variables	object	yes	Template variables as key-value pairs (keys should be integer strings)
width	number	—	Ad width in pixels

No output schema declared.

No examples provided.

create_native_template ~63

Create a new native ad template with HTML and variable placeholders

Input Output Examples

Name	Type	Req	Description
name	string	yes	Template name
raw_html	string	yes	HTML template content with variable placeholders (e.g. "[%title%]")
variables	array	yes	Array of template variables

No output schema declared.

No examples provided.

create_ortb_native_data_asset ~57

Create a new data asset for an ORTB native template

Input Output Examples

Name	Type	Req	Description
len	number	—	Max length
template_id	number	yes	ORTB native template ID
type	number	—	Data asset type

No output schema declared.

No examples provided.

create_ortb_native_image_asset ~84

Create a new image asset for an ORTB native template

Input Output Examples

Name	Type	Req	Description
h	number	—	Height
hmin	number	—	Min height
template_id	number	yes	ORTB native template ID
type	number	—	Image asset type
w	number	—	Width
wmin	number	—	Min width

No output schema declared.

No examples provided.

create_ortb_native_template ~58

Create a new OpenRTB native template

Input Output Examples

Name	Type	Req	Description
html_template	string	—	HTML template for rendering the native ad (e.g. "<div>{{title}}</div>")
name	string	—	ORTB native template name

No output schema declared.

No examples provided.

create_ortb_native_title_asset ~49

Create a new title asset for an ORTB native template

Input Output Examples

Name	Type	Req	Description
len	number	—	Max length of title
template_id	number	yes	ORTB native template ID

No output schema declared.

No examples provided.

create_placement ~283

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

Input Output Examples

Name	Type	Req	Description
active	boolean	—	Whether placement is active (defaults to true)
advertisement	object	yes	Advertisement object with id and type
channel	number	—	Channel ID (required if zone not set; mutually exclusive with zone)
contextual_segments	array	—	Array of contextual segment IDs
cost	object	—	Pricing model: fixed_cost OR cpm/cpc/cpa
data_key_target_id	number	—	Data Key Target ID (Enterprise only)
geo_target	number	—	Geotarget ID
keywords	string	—	Comma-separated keywords for targeting
keywords_match_method	string	—	Keyword matching method
list_target	number	—	List Target ID
payout	object	—	Publisher payout configuration
platform_target	number	—	Platform target ID
priority	string	—	Serving priority level (defaults to "standard")
schedule	number	yes	Schedule ID
serve_method	string	—	Serving system: weight-based or auction-based
share_of_voice	number	—	Share of voice percentage (required when zone uses share_of_voice)
weight	number	—	Relative delivery weight
zone	object	—	Zone object (required if channel not set; mutually exclusive with channel)

No output schema declared.

No examples provided.

create_platform_target ~72

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

Input Output Examples

Name	Type	Req	Description
device_targets	array	—	List of device patterns to target (e.g. "Apple*", "Samsung Galaxy S5")
name	string	yes	Platform target name
platform	string	—	Preset platform target (default: any)

No output schema declared.

No examples provided.

create_pmp_deal ~88

Create a new PMP deal

Input Output Examples

Name	Type	Req	Description
audience_target	number	—	Audience target ID (null = no targeting)
bid_floor	number	—	Bid floor for this deal
geo_target	number	—	Geo target ID (0 = no targeting)
name	string	—	PMP deal name
whitelist_seats	array	—	Seat IDs with access to this deal

No output schema declared.

No examples provided.

create_postal_code_target ~60

Create a new postal code target

Input Output Examples

Name	Type	Req	Description
inclusive	boolean	—	If true, inclusion target; if false, exclusion target
label	string	yes	Postal code target name
locations	array	yes	Array of locations grouped by country

No output schema declared.

No examples provided.

create_product_catalog ~37

Create a new product catalog for a publisher

Input Output Examples

Name	Type	Req	Description
name	string	—	Catalog name
publisher_id	number	yes	Publisher ID

No output schema declared.

No examples provided.

create_product_catalog_item ~108

Create a new item in a product catalog

Input Output Examples

Name	Type	Req	Description
catalog_id	number	yes	Catalog ID
category	string	—	Item category
description	string	—	Item description
identifier	string	—	Unique identifier for the catalog item
image_url	string	—	Item image URL
name	string	—	Item name
price	string	—	Item price
publisher_id	number	yes	Publisher ID
url	string	—	Item URL

No output schema declared.

No examples provided.

create_product_source ~55

Create a new product source for a publisher

Input Output Examples

Name	Type	Req	Description
name	string	—	Source name
publisher_id	number	yes	Publisher ID
type	string	—	Source type
url	string	—	Source URL

No output schema declared.

No examples provided.

create_product_source_target ~52

Create a new product source target for a publisher

Input Output Examples

Name	Type	Req	Description
name	string	—	Source target name
publisher_id	number	yes	Publisher ID
source_id	number	—	Source ID to target

No output schema declared.

No examples provided.

create_publisher ~169

Create a new publisher

Input Output Examples

Name	Type	Req	Description
can_admin_account	boolean	—	Grant administrator privileges
can_approve_ads	boolean	—	Allow publisher to approve/deny ad items
can_change_password	boolean	—	Whether publisher can change password
can_view_wordpress_key	boolean	—	Allow publisher to view WordPress key
default_payout	object	—	Default payout configuration
domain	string	—	Publisher domain (top-level domains only)
email	string	—	Contact email (allows publisher to log in)
metadata	object	—	Custom metadata key-value pairs
name	string	yes	Publisher name
seller_type	string	—	Seller type for ads.txt
timezone	string	—	Timezone (e.g., "America/New_York")

No output schema declared.

No examples provided.

create_report_schedule ~47

Create a new report schedule

Input Output Examples

Name	Type	Req	Description
frequency	string	—	Schedule frequency
recipients	array	—	Array of recipient objects
report_config_id	number	yes	Report configuration ID

No output schema declared.

No examples provided.

create_rich_media_ad_item ~163

Create a new rich media ad item

Input Output Examples

Name	Type	Req	Description
creative	number	yes	Rich media creative ID
expand_horizontal_direction	string	—	Horizontal expand direction
expand_vertical_direction	string	—	Vertical expand direction
height	number	—	Ad height in pixels
html_content_below	string	—	HTML content below the ad item
location	string	—	Click-through URL
metadata	object	—	Custom metadata key-value pairs
name	string	yes	Ad item name
tracking_pixel	string	—	Third-party tracking pixel URL
tracking_pixels	array	—	Array of tracking pixel URLs
trusted_redirect_domains	array	—	Trusted redirect domains
width	number	—	Ad width in pixels

No output schema declared.

No examples provided.

create_rich_media_creative ~80

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

Input Output Examples

Name	Type	Req	Description
description	string	—	Creative description
group	number	yes	Media group ID
index_file_path	string	—	Path to index HTML file inside ZIP archive (for HTML5)
name	string	—	Creative name

No output schema declared.

No examples provided.

create_role ~286

Create a new role with permission settings

Input Output Examples

Name	Type	Req	Description
can_assign_campaigns_directly	boolean	—	Can assign campaigns directly
can_manage_admin_api_access	boolean	—	Can manage API keys
can_manage_bidders	boolean	—	Can manage bidders
can_manage_billing	boolean	—	Can manage billing
can_manage_contracts	boolean	—	Can manage contracts
can_manage_data_keys	boolean	—	Can manage data keys
can_manage_links	boolean	—	Can manage tracking links
can_manage_media	boolean	—	Can manage creatives and media groups
can_manage_native_ad_templates	boolean	—	Can manage native templates
can_manage_product_db	boolean	—	Can manage product catalogs
can_manage_programmatic	boolean	—	Can manage programmatic
can_manage_self_serve	boolean	—	Can manage Self-Serve
can_manage_targets	boolean	—	Can manage targets
can_manage_tickets	boolean	—	Can manage tickets
can_manage_users	boolean	—	Can manage users
is_default_role	boolean	—	Auto-assign this role to new users
name	string	yes	Role name
publisher_access	string	—	Publisher access level
publisher_access_list	array	—	Publisher IDs for specific access
statistics_access	string	—	Statistics access level

No output schema declared.

No examples provided.

create_schedule ~324

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

Input Output Examples

Name	Type	Req	Description
day_cap_limit	number	—	Daily cap limit (number of views or clicks per day)
day_cap_type	string	—	Daily cap type
day_parting_id	number	—	Day parting ID for time-of-day targeting
delivery_method	string	—	Delivery pacing: "default" (ASAP) or "smooth" (evenly distributed)
end_at	string	—	End date/time in ISO-8601 format, null for indefinite
end_at_timezone	string	—	IANA timezone for end_at
end_date	string	—	End date (YYYY-MM-DD HH:MM:SS), null for indefinite — deprecated, use end_at
per_user_view_limit	number	—	Per-user view frequency cap
per_user_view_period	number	—	Days before per-user view counter resets
quota_lifetime	number	—	Total quota amount (views or clicks, not per thousand)
quota_type	string	—	Quota measurement type
start_at	string	—	Start date/time in ISO-8601 format
start_at_timezone	string	—	IANA timezone for start_at (e.g. "America/New_York")
start_date	string	—	Start date (YYYY-MM-DD HH:MM:SS) — deprecated, use start_at
under_delivery_behaviour	string	—	Whether to keep serving until quota met or stop on end date

No output schema declared.

No examples provided.

create_sftp_connection ~75

Create a new SFTP connection

Input Output Examples

Name	Type	Req	Description
host	string	—	SFTP host
name	string	—	Connection name
password	string	—	SFTP password
path	string	—	Remote path
port	number	—	SFTP port
username	string	—	SFTP username

No output schema declared.

No examples provided.

create_signature_request ~28

Create a new signature request for a contract

Input Output Examples

Name	Type	Req	Description
contract_id	number	yes	Contract ID

No output schema declared.

No examples provided.

create_trial_account ~118

Create a free AdButler trial account. Use this when the user does NOT have an AdButler account yet. Collects their info and creates the account. After calling this, the user must check their email for a verification code, then call verify_trial_email to complete setup.

Input Output Examples

Name	Type	Req	Description
company	string	yes	Company or organization name
email	string	yes	User email address
name	string	yes	Full name
phone	string	—	Phone number (optional)
website	string	—	Website URL (optional)

No output schema declared.

No examples provided.

create_trusted_redirect_domain ~34

Create a new trusted redirect domain

Input Output Examples

Name	Type	Req	Description
domain	string	yes	Trusted redirect domain (e.g. example.com)

No output schema declared.

No examples provided.

create_user ~49

Create a new user in a user database

Input Output Examples

Name	Type	Req	Description
attributes	object	—	User attribute values
user_db_id	number	yes	User database ID
user_id	string	—	User ID

No output schema declared.

No examples provided.

create_user_attribute ~76

Create a new user attribute in a user database

Input Output Examples

Name	Type	Req	Description
id	string	—	Field name in the user data (e.g. "signup_datetime")
label	string	—	Descriptive label for the field
type	string	—	Data type of the field
user_db_id	number	yes	User database ID

No output schema declared.

No examples provided.

create_user_db ~44

Create a new user database

Input Output Examples

Name	Type	Req	Description
id_field_name	string	—	Name of the field to use as primary user identifier
name	string	—	User database name

No output schema declared.

No examples provided.

create_vast_custom_report ~28

Create a new VAST report configuration

Input Output Examples

Name	Type	Req	Description
name	string	yes	Report name

No output schema declared.

No examples provided.

create_video_creative ~51

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

Input Output Examples

Name	Type	Req	Description
description	string	—	Creative description
group	number	yes	Media group ID
name	string	—	Creative name

No output schema declared.

No examples provided.

create_zone ~455

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.

Input Output Examples

Name	Type	Req	Description
ad_size_filter	object	—	Ad size filter (dynamic zones only)
allow_demand_sources	boolean	—	Allow requests to demand endpoints
allowed_root_native_templates	array	—	Allowed root native template IDs
api_frameworks	array	—	Supported API frameworks for OpenRTB
auction_tie_break	string	—	Tie-breaking method for auctions
bid_floor	number	—	Default bid floor for programmatic
burn_in_hours	number	—	Hours before eCPM confidence
burn_in_impressions	number	—	Impressions before eCPM confidence
dimensions	string	—	Zone dimensions type: "fixed" (default) or "dynamic"
ecpm_testing_allowance	number	—	Percentage for eCPM recalculation testing
height	number	—	Zone height in pixels (must be 0 if dimensions is "dynamic")
iab_categories	array	—	IAB category descriptors
metadata	object	—	Custom metadata key-value pairs
min_payout	number	—	Minimum payout per impression (CPM)
name	string	yes	Zone name
optimization_strategy	string	—	Zone optimization strategy
pmp_deals	array	—	Allowed PMP Deal IDs
private_auction	boolean	—	Whether auction ignores non-deal bids
publisher	number	—	Publisher ID
refresh_frequency	number	—	Interval in seconds for serving new ads
refresh_limit	number	—	Total times zone will refresh
responsive	string	—	Size behavior
rtb_placement_id	string	—	OpenRTB tagid identifier
serve_priority_order	string	—	Priority order: "weight" or "auction"
unique_delivery	boolean	—	Serve unique ads on each zone
use_share_of_voice	boolean	—	Use "share of voice" as serving strategy
width	number	—	Zone width in pixels (must be 0 if dimensions is "dynamic")

No output schema declared.

No examples provided.

create_zone_ortb_native_ad ~61

Create a new ORTB native ad for a standard zone

Input Output Examples

Name	Type	Req	Description
name	string	—	ORTB native ad name
template_id	number	—	ORTB native template ID
zone_id	number	yes	Standard zone ID

No output schema declared.

No examples provided.

delete_advertiser ~24

Delete an advertiser

Input Output Examples

Name	Type	Req	Description
id	number	yes	Advertiser ID

No output schema declared.

No examples provided.

delete_archived_campaign ~28

Permanently delete an archived standard campaign

Input Output Examples

Name	Type	Req	Description
id	number	yes	Archived campaign ID

No output schema declared.

No examples provided.

delete_archived_channel ~27

Permanently delete an archived channel

Input Output Examples

Name	Type	Req	Description
id	number	yes	Archived channel ID

No output schema declared.

No examples provided.

delete_archived_contract ~27

Permanently delete an archived contract

Input Output Examples

Name	Type	Req	Description
id	number	yes	Archived contract ID

No output schema declared.

No examples provided.

delete_audience ~38

Delete an audience from a user database

Input Output Examples

Name	Type	Req	Description
id	number	yes	Audience ID
user_db_id	number	yes	User database ID

No output schema declared.

No examples provided.

delete_audio_creative ~24

Delete an audio creative

Input Output Examples

Name	Type	Req	Description
id	number	yes	Creative ID

No output schema declared.

No examples provided.

delete_beacon_signing_key ~29

Delete a beacon signing key

Input Output Examples

Name	Type	Req	Description
id	number	yes	Beacon signing key ID

No output schema declared.

No examples provided.

delete_bidder ~23

Delete a bidder

Input Output Examples

Name	Type	Req	Description
id	number	yes	Bidder ID

No output schema declared.

No examples provided.

delete_campaign ~22

Delete a standard campaign

Input Output Examples

Name	Type	Req	Description
id	number	yes	Campaign ID

No output schema declared.

No examples provided.

delete_campaign_assignment ~24

Delete a campaign assignment

Input Output Examples

Name	Type	Req	Description
id	number	yes	Campaign assignment ID

No output schema declared.

No examples provided.

delete_catalog_ad_item ~26

Delete a catalog ad item

Input Output Examples

Name	Type	Req	Description
id	number	yes	Ad item ID

No output schema declared.

No examples provided.

delete_catalog_zone ~24

Delete a catalog zone

Input Output Examples

Name	Type	Req	Description
id	number	yes	Catalog zone ID

No output schema declared.

No examples provided.

delete_channel ~21

Delete a channel

Input Output Examples

Name	Type	Req	Description
id	number	yes	Channel ID

No output schema declared.

No examples provided.

delete_channel_zone_assignment ~28

Remove a zone from a channel

Input Output Examples

Name	Type	Req	Description
id	number	yes	Channel zone assignment ID

No output schema declared.

No examples provided.

delete_contact ~21

Delete a contact

Input Output Examples

Name	Type	Req	Description
id	number	yes	Contact ID

No output schema declared.

No examples provided.

delete_contract ~21

Delete a contract

Input Output Examples

Name	Type	Req	Description
id	number	yes	Contract ID

No output schema declared.

No examples provided.

delete_contract_document ~33

Delete a contract document

Input Output Examples

Name	Type	Req	Description
contract_id	number	yes	Contract ID
id	number	yes	Document ID

No output schema declared.

No examples provided.

delete_contract_payment ~33

Delete a contract payment

Input Output Examples

Name	Type	Req	Description
contract_id	number	yes	Contract ID
id	number	yes	Payment ID

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug