agent1st-ads-mcp

Instructions

Implementation Reference

• src/index.ts:519-530 (handler)

  The implementation handler for the 'update_meta_campaign_budget' tool. It checks for a license, validates input, and makes a POST request to update the campaign budget.

  case 'update_meta_campaign_budget': {
      const denied = licenseCheck('meta');
      if (denied) return fail(denied);
      if (!args.campaign_id || !args.daily_budget_usd) return fail('campaign_id and daily_budget_usd required.');
  
      // Validate budget
      const budgetError = validateMetaBudget(args.daily_budget_usd);
      if (budgetError) return fail(budgetError);
  
      await metaPost(`/${args.campaign_id}`, { daily_budget: Math.round((args.daily_budget_usd as number) * 100) });
      return ok({ success: true, campaign_id: args.campaign_id, new_daily_budget_usd: args.daily_budget_usd });
  }

• src/index.ts:274-285 (schema)

  The registration and input schema definition for 'update_meta_campaign_budget'.

  {
      name: 'update_meta_campaign_budget',
      description: 'Change the daily budget of a Meta campaign. Takes effect immediately. Increase to scale a winning campaign, decrease to throttle spend. Minimum $1/day. Requires Starter plan or higher.',
      inputSchema: {
          type: 'object',
          properties: {
              campaign_id:      { type: 'string', description: 'Meta campaign ID.' },
              daily_budget_usd: { type: 'number', description: 'New daily budget in USD. Minimum: 1.' },
          },
          required: ['campaign_id', 'daily_budget_usd'],
      },
  },