Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

AdButler

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

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

+18 this week 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
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

# 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.

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
add_user_list_attribute_values ~65

Add values to a list attribute for a user

NameTypeReqDescription
list_attribute_namestringyesList attribute name
user_db_idnumberyesUser database ID
user_idstringyesUser ID
valuesarrayValues to add

No output schema declared.

No examples provided.

archive_advertiser ~32

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

NameTypeReqDescription
idnumberyesAdvertiser ID

No output schema declared.

No examples provided.

archive_campaign ~30

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

NameTypeReqDescription
idnumberyesCampaign ID

No output schema declared.

No examples provided.

archive_channel ~29

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

NameTypeReqDescription
idnumberyesChannel ID

No output schema declared.

No examples provided.

archive_contract ~29

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

NameTypeReqDescription
idnumberyesContract ID

No output schema declared.

No examples provided.

archive_email_zone ~24

Archive an email zone

NameTypeReqDescription
idnumberyesEmail zone ID

No output schema declared.

No examples provided.

archive_publisher ~30

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

NameTypeReqDescription
idnumberyesPublisher ID

No output schema declared.

No examples provided.

archive_zone ~30

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

NameTypeReqDescription
idnumberyesZone ID

No output schema declared.

No examples provided.

bulk_create_product_sources ~41

Bulk create product sources for a publisher

NameTypeReqDescription
publisher_idnumberyesPublisher ID
sourcesarrayArray of source objects to create

No output schema declared.

No examples provided.

bulk_upload_add_data_list ~40

Bulk add entries to a data list

NameTypeReqDescription
datastringCSV data to add
idnumberyesData list ID

No output schema declared.

No examples provided.

bulk_upload_product_catalog ~38

Bulk upload items to a product catalog

NameTypeReqDescription
catalog_idnumberyesCatalog ID
publisher_idnumberyesPublisher ID

No output schema declared.

No examples provided.

bulk_upload_remove_data_list ~40

Bulk remove entries from a data list

NameTypeReqDescription
datastringCSV data to remove
idnumberyesData list ID

No output schema declared.

No examples provided.

bulk_upload_replace_data_list ~43

Bulk replace all entries in a data list

NameTypeReqDescription
datastringCSV data to replace list with
idnumberyesData list ID

No output schema declared.

No examples provided.

bulk_upload_replace_user_db ~33

Bulk upload to replace all user data in a user database

NameTypeReqDescription
idnumberyesUser database ID

No output schema declared.

No examples provided.

campaign_bulk_create_catalog_ad_items ~46

Bulk create catalog ad items in a campaign

NameTypeReqDescription
campaign_idnumberyesCampaign ID
itemsarrayyesArray of catalog ad item objects to create

No output schema declared.

No examples provided.

campaign_bulk_delete_catalog_ad_items ~46

Bulk delete catalog ad items from a campaign

NameTypeReqDescription
campaign_idnumberyesCampaign ID
itemsarrayyesArray of catalog ad item IDs to delete

No output schema declared.

No examples provided.

cancel_signature_request ~35

Cancel a signature request

NameTypeReqDescription
contract_idnumberyesContract ID
request_idnumberyesSignature request ID

No output schema declared.

No examples provided.

convert_native_to_image ~32

Convert a native ad item to an image ad item

NameTypeReqDescription
idnumberyesNative ad item ID

No output schema declared.

No examples provided.

create_advertiser ~101

Create a new advertiser

NameTypeReqDescription
can_add_ad_itemsbooleanWhether advertiser can submit advertisements for scheduling
can_change_passwordbooleanWhether advertiser can change password
emailstringContact email
metadataobjectCustom metadata key-value pairs
namestringyesAdvertiser name
passwordstringPassword for advertiser portal (min 8 chars, must include upper, lower, number)

No output schema declared.

No examples provided.

create_audience ~72

Create a new audience in a user database

NameTypeReqDescription
attributesobjectAttribute targets defining the audience (e.g. { "gender": { "operator": "=", "operand": "male" } })
namestringAudience name
user_db_idnumberyesUser database ID

No output schema declared.

No examples provided.

create_audio_creative ~51

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

NameTypeReqDescription
descriptionstringCreative description
groupnumberyesMedia group ID
namestringCreative name

No output schema declared.

No examples provided.

create_beacon_signing_key ~31

Create a new beacon signing key

NameTypeReqDescription
key_namestringyesBeacon signing key name

No output schema declared.

No examples provided.

create_bidder ~45

Create a new bidder

NameTypeReqDescription
bid_urlstringBid endpoint URL
namestringyesBidder name
statusstringBidder status

No output schema declared.

No examples provided.

create_campaign ~144

Create a new standard campaign

NameTypeReqDescription
advertisernumberAdvertiser ID
budgetobjectBudget limits (daily/weekly/monthly/lifetime)
contractnumberContract ID (requires Contract Management add-on)
metadataobjectCustom metadata key-value pairs
namestringyesCampaign name
roadblock_tagsstringTag to link campaign to a roadblock
scheduling_sourcestringWhether scheduling is set at campaign or ad item level
targeting_sourcestringWhether targeting is set at campaign or ad item level
trusted_redirect_domainsarrayArray of trusted redirect domains

No output schema declared.

No examples provided.

create_campaign_assignment ~179

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

NameTypeReqDescription
activebooleanWhether assignment is active (defaults to true)
advertisementobjectyesAdvertisement object with id and type
campaignobjectyesCampaign object with id and type
data_key_targetnumberData Key Target ID
geo_targetnumberGeo Target ID (only if campaign targeting_source is "AD_ITEM")
keywordsstringComma-separated keywords for targeting
keywords_match_methodstringKeyword matching method
list_targetnumberList Target ID
platform_targetnumberPlatform Target ID
schedulenumberSchedule ID (only if campaign scheduling_source is "AD_ITEM")
weightnumberRelative delivery weight (defaults to 1)

No output schema declared.

No examples provided.

create_catalog_ad_item ~100

Create a new catalog ad item

NameTypeReqDescription
catalog_idnumberyesCatalog ID
catalog_item_identifierstringyesUnique identifier for the catalog item
locationstringClick-through URL
metadataobjectCustom metadata key-value pairs
namestringyesAd item name
tracking_pixelstringThird-party tracking pixel URL
tracking_pixelsarrayArray of tracking pixel URLs

No output schema declared.

No examples provided.

create_catalog_zone ~152

Create a new catalog zone for product/retail ad serving

NameTypeReqDescription
advertiser_cost_typestringBilling model
auction_typestringAuction type
bid_floornumberDefault bid floor
bid_floor_cpcnumberCPC bid floor
bid_floor_cpmnumberCPM bid floor
catalog_idnumberyesCatalog ID
click_cooldown_periodnumberClick cooldown period in seconds (1-86400)
conversion_lookback_periodnumberConversion lookback period in seconds (1-7776000)
namestringyesZone name
publishernumberPublisher ID

No output schema declared.

No examples provided.

create_channel ~59

Create a new channel

NameTypeReqDescription
namestringyesChannel name
prioritystringServing priority (default: standard)
use_share_of_voicebooleanWhether to use share of voice as serving strategy (false = use weight)

No output schema declared.

No examples provided.

create_channel_zone_assignment ~39

Assign a zone to a channel

NameTypeReqDescription
channelnumberyesChannel ID
zoneobjectyesZone object with id and type

No output schema declared.

No examples provided.

create_contact ~52

Create a new contact

NameTypeReqDescription
emailstringyesContact email address (must be unique)
namestringyesContact name (full name recommended)
notesstringAdditional notes about the contact

No output schema declared.

No examples provided.

create_contract ~109

Create a new contract

NameTypeReqDescription
advertisernumberyesAdvertiser ID
descriptionstringContract description
end_atstringContract end date (YYYY-MM-DD)
namestringyesContract name
payment_due_datestringPayment due date (YYYY-MM-DD)
ratenumberContract rate (in account currency)
start_atstringContract start date (YYYY-MM-DD)
statusstringContract status

No output schema declared.

No examples provided.

create_contract_document ~51

Create a new document for a contract

NameTypeReqDescription
attributesstringJSON-encoded object with name, admin_executed, vendor_executed fields
contract_idnumberyesContract ID

No output schema declared.

No examples provided.

create_contract_document_from_template ~39

Create a contract document from a template

NameTypeReqDescription
contract_idnumberyesContract ID
template_idnumberTemplate ID

No output schema declared.

No examples provided.

create_contract_payment ~53

Create a new payment for a contract

NameTypeReqDescription
amountnumberyesAmount paid (can be negative for refunds)
contract_idnumberyesContract ID
notestringPayment note or description

No output schema declared.

No examples provided.

create_contract_template ~120

Create a new contract template. Requires name, file, attributes (JSON string), email_subject, and email_body.

NameTypeReqDescription
attributesstringyesJSON-encoded object containing name, email_subject, email_body, and optionally signing_service, basic_inputs, contract_column_inputs, signers
email_bodystringyesEmail body text when sending for signature
email_subjectstringyesEmail subject line when sending for signature
filestringyesURL or path to the contract template file
namestringyesTemplate name

No output schema declared.

No examples provided.

create_creative ~59

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

NameTypeReqDescription
descriptionstringCreative description
groupnumberyesMedia group ID
namestringCreative name

No output schema declared.

No examples provided.

create_custom_html_ad_item ~174

Create a new custom HTML ad item

NameTypeReqDescription
custom_htmlstringyesThe HTML content of the ad item
expand_horizontal_directionstringHorizontal expand direction
expand_vertical_directionstringVertical expand direction
heightnumberAd height in pixels (0 for flexible)
html_content_belowstringHTML content below the ad item
locationstringClick-through URL
metadataobjectCustom metadata key-value pairs
namestringyesAd item name
tracking_pixelstringThird-party tracking pixel URL
tracking_pixelsarrayArray of tracking pixel URLs
trusted_redirect_domainsarrayTrusted redirect domains
widthnumberAd width in pixels (0 for flexible)

No output schema declared.

No examples provided.

create_custom_report ~207

Create a new report configuration

NameTypeReqDescription
columnsarrayColumns to include: impressions, eligible, viewable, clicks, conversions, ctr, cvr, e_cpm, e_cpc, e_cpa, cost, payout, revenue
dateobjectyesDate configuration (either preset or start+end required)
exclude_campaign_ad_itemsbooleanExclude ad items in campaigns
exclude_channel_statsbooleanExclude stats from channel-served ads
exclude_publisher_ad_itemsbooleanExclude ad items directly in zones
filtersobjectFilter criteria: { publishers: [...], advertisers: [...], zones: [...], campaigns: [...], ad_items: [...], channels: [...] }
namestringyesReport name
periodstringyesData grouping period
require_channel_statsbooleanOnly include stats from channel-served ads
typestringyesReport type

No output schema declared.

No examples provided.

create_data_key ~48

Create a new data key for custom targeting

NameTypeReqDescription
namestringyesData key name (max 32 chars, must be unique)
typestringyesData key value type

No output schema declared.

No examples provided.

create_data_key_target ~71

Create a new data key target (targeting rule)

NameTypeReqDescription
namestringyesData key target name
targetstringyesJSON formatted target logic, e.g. ["OR", {"my_number": {"=": "5"}}, {"my_string": {"=": "test"}}]

No output schema declared.

No examples provided.

create_data_list ~26

Create a new data list

NameTypeReqDescription
labelstringyesData list label/name

No output schema declared.

No examples provided.

create_day_parting ~146

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.

NameTypeReqDescription
is_templatebooleanIf true, shown in UI when creating/editing schedules
namestringDay parting name
rangesobjectObject mapping day names (monday-sunday) to arrays of time ranges like "09:00:00-17:00:00"
use_member_timezonebooleanIf true, use account timezone; if false, use viewer timezone

No output schema declared.

No examples provided.

create_demand_endpoint ~250

Create a new demand endpoint

NameTypeReqDescription
allowed_sizesarrayAllowed zone sizes (e.g. ["300x250", "728x90"])
bid_floornumberDefault CPM bid floor
default_parametersobjectyesDefault parameters for the endpoint (e.g. { url: "https://..." })
demand_sourcenumberyesDemand Source ID this endpoint belongs to
filter_typestringZone filtering type
filtered_vast_zonesarrayVAST zone IDs for the filter list
filtered_zonesarrayZone IDs for the filter list
geo_targetnumberGeo target ID for geographic targeting
markup_percentnumberMarkup percent applied to zone bid floor
namestringyesDemand endpoint name
native_json_encodedbooleanWhether native JSON should be encoded
prioritystringServing priority
revenue_sharenumberRevenue share percentage paid to publisher
statusstringWhether to send bid requests (default: active)
supported_formatsarrayyesSupported ad formats: "display", "native", "video"

No output schema declared.

No examples provided.

create_demand_source ~181

Create a new demand source

NameTypeReqDescription
namestringyesDemand source name
networkstringyesNetwork type: 'adview', 'aerserv', 'inmobi', 'inneractive', 'loopme', 'mobilefuse', 'onebyaol', 'pubmatic', 'pubnative', 'smaato', 'startapp', 'tappx', 'consumable', 'bidphysics', or 'openrtb'
spend_limitnumberSpend limit amount
spend_limit_endstringSpend limit end date (ISO-8601)
spend_limit_periodstringSpend limit reset interval
spend_limit_startstringSpend limit start date (ISO-8601)
statusstringWhether to send bid requests (default: active)

No output schema declared.

No examples provided.

create_email_zone ~117

Create a new email zone for serving ads in email newsletters

NameTypeReqDescription
auction_tie_breakstringTie-breaking method for auctions
heightnumberyesZone height in pixels
metadataobjectCustom metadata key-value pairs
namestringyesZone name
publishernumberPublisher ID
rotate_timerobjectPeriod after which user sees a new ad
uid_rotatebooleanServe different ads per user
widthnumberyesZone width in pixels

No output schema declared.

No examples provided.

create_event_log_upload_config ~86

Create a new event log upload configuration

NameTypeReqDescription
connection_idnumberSFTP connection ID to use for upload
enabledbooleanWhether the upload configuration is enabled
formatstringLog file format
frequencystringUpload frequency (e.g. "daily", "hourly")
namestringConfiguration name

No output schema declared.

No examples provided.

create_geo_target ~115

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

NameTypeReqDescription
areasarrayyesArray of geographic areas to target
inclusivebooleanIf true, target users IN these areas; if false, EXCLUDE these areas
namestringyesGeo target name
rangenumberRadius range for geo-fencing (only applies when targeting a city)
unitstringDistance unit for range

No output schema declared.

No examples provided.

create_image_ad_item ~212

Create a new image ad item (banner)

NameTypeReqDescription
creativenumberImage creative ID (mutually exclusive with creative_url)
creative_urlstringURL to image file — PNG, JPEG, or GIF (mutually exclusive with creative)
heightnumberAd height in pixels (defaults to 0)
html_alt_textstringAlt text for the image
html_content_belowstringHTML content below the ad item
html_targetstringWindow/frame for destination URL (e.g. "_blank")
locationstringClick-through URL
metadataobjectCustom metadata key-value pairs
namestringyesAd item name
tracking_pixelstringThird-party tracking pixel URL
tracking_pixelsarrayArray of tracking pixel URLs
trusted_redirect_domainsarrayTrusted redirect domains
widthnumberAd width in pixels (defaults to 0)

No output schema declared.

No examples provided.

create_list_target ~68

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

NameTypeReqDescription
data_listnumberData list ID containing the values to target
inclusivebooleanIf true, inclusion target; if false, exclusion target
labelstringyesList target name

No output schema declared.

No examples provided.

create_manager ~361

Create a new manager

NameTypeReqDescription
can_assign_campaigns_directlybooleanCan assign campaigns directly to zones
can_manage_admin_api_accessbooleanCan manage API keys
can_manage_biddersbooleanCan manage bidders
can_manage_billingbooleanCan view invoices and billing
can_manage_contractsbooleanCan manage contracts and templates
can_manage_data_keysbooleanCan manage data keys
can_manage_linksbooleanCan create/edit/delete active tracking links
can_manage_mediabooleanCan manage creatives and media groups
can_manage_native_ad_templatesbooleanCan manage native templates
can_manage_product_dbbooleanCan manage product catalogs
can_manage_programmaticbooleanCan manage demand sources and PMP deals
can_manage_self_servebooleanCan manage Self-Serve portals
can_manage_targetsbooleanCan assign/remove targets from placements
can_manage_ticketsbooleanCan create/view support tickets
can_manage_usersbooleanCan manage user accounts and permissions
emailstringyesManager email address
is_enabledbooleanWhether the manager account is enabled
namestringyesManager name
notesstringNotes about the manager
passwordstringLogin password (min 8 chars with upper, lower, number). Random if blank.
positionstringManager position in organization
publisher_accessstringPublisher access level
publisher_access_listarrayPublisher IDs accessible when publisher_access is "specific"
statistics_accessstringStatistics access level

No output schema declared.

No examples provided.