cogny clipaid socialfirst 15 calls free

meta ads scriptable from Bash.

Pull Facebook & Instagram ad insights, walk the campaign → ad set → ad tree, update budgets and status, and manage audiences — all from the shell over the Meta Ads MCP. No Graph API tokens to juggle.

1. sign up, free for the first calls (uses your git email)npx @cogny/cli init --agent claude-code
2. see every Meta Ads toolcogny tools list
3. call any tool from bash, no MCP wiringcogny tools call mcp__Meta_Ads__tool_get_insights --input '{…}'

Start free @cogny/cli on npm

01two paths

you're a person

Ads Manager makes you click through campaign → ad set → ad and export each view. The CLI returns the whole tree as JSON in one call, ready to diff, sort, or feed to an agent. Connect Meta 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 Meta Ads tool over JSON-RPC. The first 15 calls are free.

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

02tools call

real Meta Ads tools.

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

mcp__Meta_Ads__tool_get_insights

Performance metrics for any account, campaign, ad set, or ad.

cogny tools call mcp__Meta_Ads__tool_get_insights \ --input '{"ad_account_id":"act_1234567890","level":"campaign","date_preset":"last_7d"}'

example response

{
  "data": [
    {
      "campaign_name": "Prospecting — Broad",
      "spend": "4120.55",
      "impressions": 812044,
      "clicks": 9123,
      "ctr": "1.12",
      "cpc": "0.45",
      "purchase_roas": "2.8"
    },
    {
      "campaign_name": "Retargeting — 30d",
      "spend": "1880.10",
      "impressions": 204113,
      "clicks": 6201,
      "ctr": "3.04",
      "cpc": "0.30",
      "purchase_roas": "5.1"
    }
  ]
}

mcp__Meta_Ads__tool_get_campaigns

List campaigns with objective, status, and budget.

cogny tools call mcp__Meta_Ads__tool_get_campaigns \ --input '{"ad_account_id":"act_1234567890","limit":2}'

example response

{
  "data": [
    {
      "id": "120200000000000001",
      "name": "Prospecting — Broad",
      "objective": "OUTCOME_SALES",
      "status": "ACTIVE",
      "daily_budget": "15000"
    },
    {
      "id": "120200000000000002",
      "name": "Retargeting — 30d",
      "objective": "OUTCOME_SALES",
      "status": "ACTIVE",
      "daily_budget": "5000"
    }
  ]
}

mcp__Meta_Ads__tool_update_ad_set_budget
Shift budget into a winning ad set.
- cogny tools call mcp__Meta_Ads__tool_update_ad_set_budget \ --input '{"ad_set_id":"120200000000000010","daily_budget":20000}'
example response
```
{
  "id": "120200000000000010",
  "daily_budget": "20000",
  "success": true
}
```

03tools list

the rest of the surface.

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

mcp__Meta_Ads__tool_list_ad_accounts
mcp__Meta_Ads__tool_get_ad_sets
mcp__Meta_Ads__tool_get_ads
mcp__Meta_Ads__tool_create_campaign
mcp__Meta_Ads__tool_create_ad_set
mcp__Meta_Ads__tool_update_campaign_status
mcp__Meta_Ads__tool_update_ad_set_targeting
mcp__Meta_Ads__tool_create_lookalike_audience
mcp__Meta_Ads__tool_get_pixels

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.

Does this replace Meta Ads Manager?: No — it adds a scriptable surface on top. You keep Ads Manager; the CLI lets you (or your agent) read insights and push approved budget/status changes without clicking through the UI.
How is auth handled?: You connect Meta once inside Cogny (OAuth). The proxy holds the token; the CLI calls tools with your Cogny key. No long-lived Graph API token in your shell history.
Can it create campaigns or just read?: Both. The Meta Ads MCP exposes read tools (insights, campaigns, ad sets) and write tools (create campaign/ad set/ad, update budget/status/targeting, build audiences).

06related

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

meta ads, then a verdict.

Start free All CLIs