cogny clipaid socialfirst 15 calls free

openai ads from your shell.

Pull OpenAI Ads insights — the ads inside ChatGPT — (impressions, clicks, spend, CTR, CPC, CPM) for campaigns, ad groups and chat-card ads, daily or by country and device, list conversion pixels and event settings, and push bid, budget or status changes — all from Bash over the OpenAI Ads MCP. No Advertiser API client to write.

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

Start free @cogny/cli on npm

01two paths

you're a person

Ads Manager at ads.openai.com shows one campaign at a time and no export of ad-level daily rows. The CLI returns any level of the hierarchy with a date range and optional country/device segments as JSON in one call — ready to pipe, diff or schedule. Connect OpenAI 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 OpenAI Ads tool over JSON-RPC. The first 15 calls are free.

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

02tools call

real OpenAI Ads tools.

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

mcp__OpenAI_Ads__tool_get_insights

Performance at account, campaign, ad group or ad level, optionally bucketed by day.

cogny tools call mcp__OpenAI_Ads__tool_get_insights \ --input '{"aggregation_level":"campaign","start_date":"2026-08-01","end_date":"2026-08-31","time_granularity":"none"}'

example response

{
  "data": [
    {
      "campaign_id": "cmpn_8939d568ea5081a0aaa34971bc1acdaa",
      "campaign_name": "GH-SE-Growth-2026",
      "impressions": 4116,
      "clicks": 96,
      "spend": 61.4,
      "ctr": 0.0233,
      "cpc": 0.64,
      "cpm": 14.92
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": null
}

mcp__OpenAI_Ads__tool_get_campaigns

List campaigns with status, bidding type, budget and geo targeting.

cogny tools call mcp__OpenAI_Ads__tool_get_campaigns \ --input '{"status_filter":["active"],"limit":2}'

example response

{
  "data": [
    {
      "id": "cmpn_8939d568ea5081a0aaa34971bc1acdaa",
      "name": "GH-SE-Growth-2026",
      "status": "active",
      "bidding_type": "clicks",
      "budget": {
        "daily_spend_limit_micros": 25000000
      },
      "targeting": {
        "locations": {
          "countries": [
            "SE"
          ]
        }
      }
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": null
}

mcp__OpenAI_Ads__tool_update_campaign_status
Activate, pause or archive a campaign.
- cogny tools call mcp__OpenAI_Ads__tool_update_campaign_status \ --input '{"campaign_id":"cmpn_8939d568ea5081a0aaa34971bc1acdaa","status":"paused"}'
example response
```
{
  "id": "cmpn_8939d568ea5081a0aaa34971bc1acdaa",
  "status": "paused",
  "updated_at": 1788267540
}
```

03tools list

the rest of the surface.

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

mcp__OpenAI_Ads__tool_get_ad_account
mcp__OpenAI_Ads__tool_get_ad_groups
mcp__OpenAI_Ads__tool_get_ads
mcp__OpenAI_Ads__tool_search_geo_locations
mcp__OpenAI_Ads__tool_create_campaign
mcp__OpenAI_Ads__tool_create_ad_group
mcp__OpenAI_Ads__tool_upload_image
mcp__OpenAI_Ads__tool_create_ad
mcp__OpenAI_Ads__tool_preview_ad
mcp__OpenAI_Ads__tool_list_pixels
mcp__OpenAI_Ads__tool_get_pixel_events
mcp__OpenAI_Ads__tool_list_conversion_event_settings

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 for ChatGPT ads?: Yes — ChatGPT ads are OpenAI Ads. OpenAI named the product OpenAI Ads (ads.openai.com) and the ads render as sponsored chat cards inside ChatGPT, so the tool prefix here is OpenAI_Ads and it drives the same ad account you manage in Ads Manager.
Is this an official OpenAI Ads CLI?: No — it is the Cogny CLI calling the OpenAI Ads MCP over the cogny-mcp-proxy. You paste an Ads API key from ads.openai.com → Settings → API keys once in Cogny and then call every tool from Bash. The key is scoped to one ad account, so there is no account picker.
What units do budgets and spend use?: Budgets and bids are micros of the account currency (25000000 = 25.00). Insight metrics — spend, cpc, cpm — come back in plain currency units and ctr is a fraction, matching what the Advertiser API returns.
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__OpenAI_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

openai ads, then a verdict.

Start free All CLIs