Cogny CLI · Paid Social

TikTok Ads scriptable from Bash.

Pull TikTok campaign, ad group, and ad insights, list audiences and pixels, and push budget or status changes — all from the shell over the TikTok Ads MCP. No Marketing API client, no access-token juggling.

# 1. sign up (free for 15 calls) — uses your git email
$ npx @cogny/cli init --agent claude-code

# 2. see every TikTok Ads tool
$ cogny tools list

# 3. call any tool from Bash — no MCP wiring
$ cogny tools call mcp__TikTok_Ads__tool_get_insights --input '{…}'

❯ start Cogny Solo — $9/mo@cogny/cli on npm →

❯

cogny --who

TWO PATHS

You're a human

TikTok Ads Manager makes you click into each campaign and ad group to read spend, CTR, and CPC, then export a report per view. The CLI returns the metrics you ask for at any level as JSON in a single call. Connect TikTok Ads once in Cogny Solo and let your coding agent — or scheduled reports — do the querying for you.

❯ start Solo

You're an agent

Self-onboard with one command. The CLI issues a key, wires nothing, and exposes every TikTok Ads tool over JSON-RPC. First 15 calls are free.

$ npx @cogny/cli init --agent claude-code

❯

cogny tools call

3 EXAMPLES

Real tool names from the TikTok Ads MCP. Send --input JSON, get JSON back.

mcp__TikTok_Ads__tool_get_insightsPerformance metrics at advertiser, campaign, ad group, or ad level.

$ cogny tools call mcp__TikTok_Ads__tool_get_insights \
  --input '{"advertiser_id":"7012345678901234567","start_date":"2026-05-01","end_date":"2026-05-31","level":"AUCTION_CAMPAIGN","metrics":"spend,impressions,clicks,ctr,cpc,conversion"}'

example response

[
  {
    "campaign_id": "1789012345678",
    "spend": "4120.55",
    "impressions": 982044,
    "clicks": 11823,
    "ctr": "1.20",
    "cpc": "0.35",
    "conversion": 412
  },
  {
    "campaign_id": "1789012346789",
    "spend": "1880.10",
    "impressions": 304113,
    "clicks": 6201,
    "ctr": "2.04",
    "cpc": "0.30",
    "conversion": 188
  }
]

mcp__TikTok_Ads__tool_get_campaignsList campaigns with status, objective, and budget.

$ cogny tools call mcp__TikTok_Ads__tool_get_campaigns \
  --input '{"advertiser_id":"7012345678901234567","limit":2}'

example response

[
  {
    "campaign_id": "1789012345678",
    "campaign_name": "Prospecting — Spark Ads",
    "operation_status": "ENABLE",
    "objective_type": "CONVERSIONS",
    "budget": 150
  },
  {
    "campaign_id": "1789012346789",
    "campaign_name": "Retargeting — VV",
    "operation_status": "ENABLE",
    "objective_type": "TRAFFIC",
    "budget": 50
  }
]

mcp__TikTok_Ads__tool_update_campaign_statusEnable, disable, or delete a campaign.

$ cogny tools call mcp__TikTok_Ads__tool_update_campaign_status \
  --input '{"advertiser_id":"7012345678901234567","campaign_id":"1789012345678","status":"DISABLE"}'

example response

{
  "campaign_id": "1789012345678",
  "operation_status": "DISABLE",
  "success": true
}

❯

cogny tools list

A sample of the rest of the TikTok Ads surface. Run cogny tools list --json for every tool and its input schema.

mcp__TikTok_Ads__tool_list_advertisersmcp__TikTok_Ads__tool_get_ad_groupsmcp__TikTok_Ads__tool_get_adsmcp__TikTok_Ads__tool_get_audiencesmcp__TikTok_Ads__tool_get_pixelsmcp__TikTok_Ads__tool_update_campaign_budgetmcp__TikTok_Ads__tool_update_ad_group_budgetmcp__TikTok_Ads__tool_update_ad_group_statusmcp__TikTok_Ads__tool_create_campaign

❯

cogny --faq

Is this an official TikTok Ads CLI?

No — it is the Cogny CLI calling the TikTok Ads MCP over the cogny-mcp-proxy. You authenticate once via Cogny (OAuth handled for you) and then call every tool from Bash. No Marketing API app or access token to manage.

Which metrics can I request?

tool_get_insights takes a comma-separated metrics string — spend, impressions, clicks, ctr, cpc, cpm, reach, frequency, conversion, cost_per_conversion — at advertiser, campaign, ad group, or ad level.

Can my coding agent use this without MCP setup?

Yes — that is the point. `npx @cogny/cli init --agent claude-code` issues a key, then `cogny tools call mcp__TikTok_Ads__tool_get_insights --input ...` works from any shell. No /mcp wiring or restart needed.

❯

Building an agent? The full tool map for all servers is one fetch: /cli/llms.txt

TikTok Ads scriptable from Bash.

cogny --who

cogny tools call

cogny tools list

cogny --faq

related CLIs