Skip to main content
Glama
kadam-official

@kadam-net/mcp-server

Official

kadam_adv_update_campaign

Update an existing Kadam campaign by passing only the fields to change, covering targeting, budget, bid, schedule, and conversion edits. Status changes use set_campaign_status.

Instructions

Update a campaign (read-modify-write): pass only the fields to change, same names as create. Handles all targeting/budget/bid/schedule/conversion edits. For status changes use set_campaign_status.

Input Schema

NameRequiredDescriptionDefault
idYesCampaign ID to update
osNoComma-separated OS names or IDs (e.g. 'Android,iOS' or '10,20')
bidNoBid amount in USD. For cpa_target this is the target CPA cost
urlNoLanding page URL
nameNoCampaign name shown in dashboard
sspIdsNoComma-separated SSP IDs for the whitelist/blacklist
devicesNoComma-separated device names or IDs (e.g. 'Desktop,Smartphone' or '1,4')
endDateNoEnd date (YYYY-MM-DD)
sspModeNoSSP list mode: whitelist (allow listed) or blacklist (block listed)
browsersNoComma-separated browser names or IDs (e.g. 'Chrome,Firefox' or '8,16')
folderIdNoCampaign group ID (API field: folderId)
scheduleNoComma-separated hours (0-23) to show ads, applied to all days (e.g. '9,10,11,17')
timezoneNoTimezone offset in hours (e.g. 3 for UTC+3)
countriesNoComma-separated ISO country codes (e.g. 'US,DE,BR')
languagesNoComma-separated language names or IDs
startDateNoStart date (YYYY-MM-DD)
categoriesNoComma-separated targeting from kadam://reference/categories: 'mainstream', 'adult' (parent 1001), and/or adult subcategory IDs. Do not pass other numeric category IDs on create.
impTrackerNoThird-party impression tracking pixel URL
secondPushNoEnable second push notification (push/inpage_push only)
dailyBudgetNoDaily spending limit in USD
totalBudgetNoTotal campaign budget in USD
disableProxyNoBlock proxy/VPN traffic
siteBlacklistNoComma-separated site IDs for blacklist
siteWhitelistNoComma-separated site IDs for whitelist
connectionTypeNoNetwork connection type filter (all = no filter)
conversionHoldNoCustom postback status name for Hold (e.g. 'reg'). Sent only for a custom mapping, without a template id.
postViewWindowNoPost-view attribution window in hours (1-168)
trafficSourcesNoTraffic source pool: 'proven' = EasyStart pool of proven sources, 'all' = full pool filtered by Audience Engagement levels. Supported formats are configured server-side (popunder at release); for unsupported formats the API rejects the field with 422. Under 'proven' the API ignores audienceEngagementLevels.
campaignCapDaysNoWindow in days for campaignCapViews
postClickWindowNoPost-click attribution window in hours (1-168)
campaignCapViewsNoCampaign-level cap: max views of ANY creative from this campaign per user within campaignCapDays
conversionRejectNoCustom postback status name for Rejected. Sent only for a custom mapping, without a template id.
evenDistributionNoSpread budget evenly across the day
frequencyCapDaysNoWindow in days for frequencyCapViews
subscriptionAgesNoComma-separated subscription-age IDs (push / in-page push only; see campaign options 'subAges'). Replaces the current set. Example: '1' = newest only.
frequencyCapViewsNoCreative-level cap: max views of ONE creative per user within frequencyCapDays
audienceExcludeIdsNoComma-separated audience IDs to exclude
audienceIncludeIdsNoComma-separated audience IDs to include
conversionApprovedNoCustom postback status name for Approved (e.g. 'dep'). Sent only for a custom mapping, without a template id.
conversionTemplateIdNoConversion template id from conversion-templates. Omit or pass 0 for a custom mapping: approved/hold/reject are sent and id is not. A positive id selects that template; the status names are then taken from the template and are not sent.
pauseAfterModerationNoPause campaign after creatives pass moderation
countLastCampaignOnlyNoAttribute conversion only to the last campaign impression (default: true)
postClickAttrPriorityNoPost-click attribution takes priority over post-view (default: true)
audienceEngagementLevelsNoComma-separated Audience Engagement level slugs, e.g. 'very_high,high,medium'. Allowed slugs: very_high, high, medium, low, not_rated. Only meaningful with trafficSources=all; at least one level is required.
countFirstConversionOnlyNoCount only the first conversion per user (default: true)
postConversionAudienceIdsNoComma-separated audience IDs for post-conversion retargeting

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changedv0.7.1
    • addedInput schema / properties / audienceEngagementLevels
      Added value: +{
      +  "description": "Comma-separated Audience Engagement level slugs, e.g. 'very_high,high,medium'. Allowed slugs: very_high, high, medium, low, not_rated. Only meaningful with trafficSources=all; at least one level is required.",
      +  "type": "string"
      +}
    • changedInput schema / properties / categories / description
      Previous value: -"Comma-separated category IDs from kadam://reference/categories (or the 'mainstream'/'adult' keyword)"New value: +"Comma-separated targeting from kadam://reference/categories: 'mainstream', 'adult' (parent 1001), and/or adult subcategory IDs. Do not pass other numeric category IDs on create."
    • changedInput schema / properties / conversionApproved / description
      Previous value: -"Postback status name for 'Approved' conversions (e.g. 'dep'); used with conversionTemplateId=0"New value: +"Custom postback status name for Approved (e.g. 'dep'). Sent only for a custom mapping, without a template id."
    • changedInput schema / properties / conversionHold / description
      Previous value: -"Postback status name for 'Hold' conversions (e.g. 'reg')"New value: +"Custom postback status name for Hold (e.g. 'reg'). Sent only for a custom mapping, without a template id."
    • changedInput schema / properties / conversionReject / description
      Previous value: -"Postback status name for 'Rejected' conversions"New value: +"Custom postback status name for Rejected. Sent only for a custom mapping, without a template id."
    • changedInput schema / properties / conversionTemplateId / description
      Previous value: -"Conversion template ID (from campaign options). Use 0 for custom mapping via conversionApproved/Hold/Reject"New value: +"Conversion template id from conversion-templates. Omit or pass 0 for a custom mapping: approved/hold/reject are sent and id is not. A positive id selects that template; the status names are then taken from the template and are not sent."
    • addedInput schema / properties / trafficSources
      Added value: +{
      +  "description": "Traffic source pool: 'proven' = EasyStart pool of proven sources, 'all' = full pool filtered by Audience Engagement levels. Supported formats are configured server-side (popunder at release); for unsupported formats the API rejects the field with 422. Under 'proven' the API ignores audienceEngagementLevels.",
      +  "enum": [
      +    "all",
      +    "proven"
      +  ],
      +  "type": "string"
      +}
  2. Changed16 schema fields changedv0.5.2
    • changedInput schema / properties / campaignCapDays / description
      Previous value: -"Campaign-level: time window in days (e.g. 1 = per day). Used with campaignCapViews. Example: campaignCapViews=1, campaignCapDays=1 means 'show campaign to each user max once per day'"New value: +"Window in days for campaignCapViews"
    • changedInput schema / properties / campaignCapViews / description
      Previous value: -"Campaign-level: max times ANY creative from this campaign is shown to a user within campaignCapDays (e.g. 1 = one pop per user)"New value: +"Campaign-level cap: max views of ANY creative from this campaign per user within campaignCapDays"
    • changedInput schema / properties / categories / description
      Previous value: -"Comma-separated category IDs for content classification (e.g. '1,2,3' or 'mainstream,adult'). Multiple values allowed. Use campaign options to see available IDs."New value: +"Comma-separated category IDs from kadam://reference/categories (or the 'mainstream'/'adult' keyword)"
    • changedInput schema / properties / conversionApproved / description
      Previous value: -"Postback status name for 'Approved' conversions (e.g. 'dep', 'sale'). Used with conversionTemplateId=0 for custom mapping."New value: +"Postback status name for 'Approved' conversions (e.g. 'dep'); used with conversionTemplateId=0"
    • changedInput schema / properties / conversionHold / description
      Previous value: -"Postback status name for 'Hold' conversions (e.g. 'reg', 'lead'). Used with conversionTemplateId=0 for custom mapping."New value: +"Postback status name for 'Hold' conversions (e.g. 'reg')"
    • changedInput schema / properties / conversionReject / description
      Previous value: -"Postback status name for 'Rejected' conversions. Used with conversionTemplateId=0 for custom mapping."New value: +"Postback status name for 'Rejected' conversions"
    • changedInput schema / properties / conversionTemplateId / description
      Previous value: -"Conversion acceptance template ID from campaign options (conversionTemplates list). Use 0 for custom mapping with conversionApproved/Hold/Reject."New value: +"Conversion template ID (from campaign options). Use 0 for custom mapping via conversionApproved/Hold/Reject"
    • changedInput schema / properties / countFirstConversionOnly / description
      Previous value: -"Only count the first conversion per user (default: true). Set false to allow multiple conversions per view/click"New value: +"Count only the first conversion per user (default: true)"
    • changedInput schema / properties / folderId / description
      Previous value: -"Campaign group ID (the Kadam UI calls this a 'campaign group' / 'Группа кампаний'; the API field name is folderId)"New value: +"Campaign group ID (API field: folderId)"
    • changedInput schema / properties / frequencyCapDays / description
      Previous value: -"Creative-level: time window in days for the cap (e.g. 1 = per day, 7 = per week). Used with frequencyCapViews"New value: +"Window in days for frequencyCapViews"
    • changedInput schema / properties / frequencyCapViews / description
      Previous value: -"Creative-level: max times ONE creative is shown to a user within frequencyCapDays (e.g. 3 = user sees this creative at most 3 times)"New value: +"Creative-level cap: max views of ONE creative per user within frequencyCapDays"
    • changedInput schema / properties / postClickWindow / description
      Previous value: -"Post-click attribution window in hours (1-168). Time after ad click to count a conversion"New value: +"Post-click attribution window in hours (1-168)"
    • changedInput schema / properties / postViewWindow / description
      Previous value: -"Post-view attribution window in hours (1-168). Time after ad impression to count a conversion"New value: +"Post-view attribution window in hours (1-168)"
    • changedInput schema / properties / schedule / description
      Previous value: -"Comma-separated hours (0-23) to show ads, applied to all days (e.g. '9,10,11,12,13,14,15,16,17' for 9am-5pm)"New value: +"Comma-separated hours (0-23) to show ads, applied to all days (e.g. '9,10,11,17')"
    • changedInput schema / properties / sspIds / description
      Previous value: -"Comma-separated SSP IDs for the source whitelist/blacklist (see ssps in campaign options)"New value: +"Comma-separated SSP IDs for the whitelist/blacklist"
    • changedInput schema / properties / sspMode / description
      Previous value: -"SSP source list mode: 'whitelist' = only allow listed SSPs, 'blacklist' = block listed SSPs"New value: +"SSP list mode: whitelist (allow listed) or blacklist (block listed)"
  3. Changed2 schema fields changedv0.5.1
    • changedInput schema / properties / folderId / description
      Previous value: -"Campaign folder ID"New value: +"Campaign group ID (the Kadam UI calls this a 'campaign group' / 'Группа кампаний'; the API field name is folderId)"
    • addedInput schema / properties / subscriptionAges
      Added value: +{
      +  "description": "Comma-separated subscription-age IDs (push / in-page push only; see campaign options 'subAges'). Replaces the current set. Example: '1' = newest only.",
      +  "type": "string"
      +}
  4. First observedv0.3.9

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnlyHint=false; the description usefully adds that this is a read-modify-write partial update and that field names mirror create_campaign, which prevents overwrite-by-omission mistakes. It does not cover permissions, validation failures beyond schema notes, or response behavior, but adds real context beyond the annotation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three compact sentences: the operation and its partial-update semantics come first, the scope second, the routing hint last. No filler, nothing redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 46-parameter mutation tool with no output schema, the description covers the essential semantics (partial update, create-name parity) and the status alternative. What is missing is minor: any note on error/validation behavior or bid-related sibling routing, which the schema only partially compensates for.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with detailed per-parameter docs, so the schema carries the burden. The description only adds that parameters match create_campaign names and that only changed fields need passing, which is useful but limited. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (update), resource (campaign), and even the interaction pattern (read-modify-write, partial fields). It names set_campaign_status as the alternative for status. It does not address the overlap with the sibling kadam_adv_update_campaign_bid despite claiming to handle 'budget/bid' edits, so sibling differentiation is imperfect.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear usage contract (pass only the fields to change) and routes status changes to set_campaign_status explicitly. It stops short of saying when to prefer kadam_adv_update_campaign_bid or kadam_adv_bulk_update_bids for bid work, leaving one overlap unresolved.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools