list_tiktok_campaigns
Retrieve TikTok ad campaigns with details like ID, name, status, objective, and budget for account management and analysis.
Instructions
List all campaigns in the TikTok ad account with campaign ID, name, status, objective, and budget. Requires Pro plan or higher ($69/mo).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max campaigns to return. Default: 20. |
Implementation Reference
- src/index.ts:532-541 (handler)The handler logic that executes the list_tiktok_campaigns tool, performing license and credential checks before querying the TikTok API.
case 'list_tiktok_campaigns': { const denied = licenseCheck('tiktok'); if (denied) return fail(denied); if (!cfg.hasTikTok()) return fail('TikTok credentials not set. Add TIKTOK_ADS_ACCESS_TOKEN and TIKTOK_ADVERTISER_ID.'); return ok(await tikTokGet('/campaign/get/', { advertiser_id: cfg.tikTokAdvId(), page_size: String(args.limit ?? 20), fields: '["campaign_id","campaign_name","status","objective_type","budget","create_time"]', })); } - src/index.ts:295-303 (registration)The MCP tool registration for list_tiktok_campaigns, defining its name, description, and input schema.
{ name: 'list_tiktok_campaigns', description: 'List all campaigns in the TikTok ad account with campaign ID, name, status, objective, and budget. Requires Pro plan or higher ($69/mo).', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Max campaigns to return. Default: 20.' } }, required: [], }, },