cogny clipaid socialfirst 15 calls free

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 the first calls (uses your git email)npx @cogny/cli init --agent claude-code
2. see every TikTok Ads toolcogny tools list
3. call any tool from bash, no MCP wiringcogny tools call mcp__TikTok_Ads__tool_get_insights --input '{…}'

Start free @cogny/cli on npm

01two paths

you're a person

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 a scheduled loop, do the querying for you.

Start Solo

you're an agent

Sign yourself up with one command. The CLI issues a key, wires nothing, and exposes every TikTok Ads tool over JSON-RPC. The first 15 calls are free.

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

02tools call

real TikTok Ads tools.

Tool names as the TikTok Ads MCP serves them. Send --input JSON, get JSON back. The payloads are illustrative.

mcp__TikTok_Ads__tool_get_insights
Performance 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_campaigns

List 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_status
Enable, 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
}
```

03tools list

the rest of the surface.

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

mcp__TikTok_Ads__tool_list_advertisers
mcp__TikTok_Ads__tool_get_ad_groups
mcp__TikTok_Ads__tool_get_ads
mcp__TikTok_Ads__tool_get_audiences
mcp__TikTok_Ads__tool_get_pixels
mcp__TikTok_Ads__tool_update_campaign_budget
mcp__TikTok_Ads__tool_update_ad_group_budget
mcp__TikTok_Ads__tool_update_ad_group_status
mcp__TikTok_Ads__tool_create_campaign

04then a verdict

calls from a script. verdicts from cogny.

Every write is logged with who authorised it. Launches your agent makes (a new campaign, a new ad) become measured tickets automatically; for other changes, your agent offers to register them. Cogny measures each in your own data, three days later for ads and seven for content and SEO, and closes it as worked, partial, didn't work or inconclusive.

worked
Moved the number. Every measured win has a share card.
partial
Some of it did.
didn't work
On the record anyway, so it isn't proposed again.
inconclusive
Not enough data to call.

How the loop works

05questions

questions.

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.

06related

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

tiktok ads, then a verdict.

Start free All CLIs