agent1st-ads-mcp

Instructions

Implementation Reference

• src/index.ts:627-641 (handler)

  Handler implementation for the "update_tiktok_campaign_budget" tool. It validates the budget using the helper, then calls the TikTok API to update the campaign budget.

  case 'update_tiktok_campaign_budget': {
      const denied = licenseCheck('tiktok');
      if (denied) return fail(denied);
      if (!args.campaign_id || !args.budget_usd) return fail('campaign_id and budget_usd required.');
  
      // Validate budget
      const budgetError = validateTikTokBudget(args.budget_usd);
      if (budgetError) return fail(budgetError);
  
      await tikTokPost('/campaign/update/', {
          advertiser_id: cfg.tikTokAdvId(), campaign_id: args.campaign_id,
          budget: args.budget_usd, budget_mode: 'BUDGET_MODE_DAY',
      });
      return ok({ success: true, campaign_id: args.campaign_id, new_budget_usd: args.budget_usd });
  }

• src/index.ts:353-363 (registration)

  Tool registration for "update_tiktok_campaign_budget" in the TOOLS array.

      name: 'update_tiktok_campaign_budget',
      description: 'Change the daily budget of a TikTok campaign. TikTok minimum is $20/day. Requires Pro plan or higher ($69/mo).',
      inputSchema: {
          type: 'object',
          properties: {
              campaign_id: { type: 'string', description: 'TikTok campaign ID.' },
              budget_usd:  { type: 'number', description: 'New daily budget in USD. Minimum: 20.' },
          },
          required: ['campaign_id', 'budget_usd'],
      },
  },