agent1st-ads-mcp

Instructions

Implementation Reference

• src/index.ts:610-625 (handler)

  Handler logic for the get_tiktok_campaign_stats tool in src/index.ts

  case 'get_tiktok_campaign_stats': {
      const denied = licenseCheck('tiktok');
      if (denied) return fail(denied);
      if (!args.campaign_id) return fail('campaign_id required.');
      const now = new Date(), weekAgo = new Date(now.getTime() - 7 * 86400000);
      const fmt = (d: Date) => d.toISOString().split('T')[0];
      return ok(await tikTokGet('/report/integrated/get/', {
          advertiser_id: cfg.tikTokAdvId(), report_type: 'BASIC',
          dimensions: '["campaign_id","stat_time_day"]',
          metrics: '["spend","impressions","clicks","ctr","cpc","conversion","cost_per_conversion"]',
          data_level: 'AUCTION_CAMPAIGN',
          start_date: (args.start_date as string) || fmt(weekAgo),
          end_date:   (args.end_date   as string) || fmt(now),
          filtering: JSON.stringify([{ field_name: 'campaign_ids', filter_type: 'IN', filter_value: `["${args.campaign_id}"]` }]),
      }));
  }

• src/index.ts:340-351 (schema)

  Registration and schema definition for the get_tiktok_campaign_stats tool in src/index.ts

      name: 'get_tiktok_campaign_stats',
      description: 'Get performance metrics for a TikTok campaign: impressions, clicks, spend, CTR, CPC, conversions. Requires Pro plan or higher ($69/mo).',
      inputSchema: {
          type: 'object',
          properties: {
              campaign_id: { type: 'string', description: 'TikTok campaign ID.' },
              start_date:  { type: 'string', description: 'Start date YYYY-MM-DD. Default: 7 days ago.' },
              end_date:    { type: 'string', description: 'End date YYYY-MM-DD. Default: today.' },
          },
          required: ['campaign_id'],
      },
  },