Cogny CLI · Paid Social

OpenAI Ads from your shell.

Pull OpenAI Ads insights (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 15 calls) — uses your git email
$ npx @cogny/cli init --agent claude-code

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

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

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

❯

cogny --who

TWO PATHS

You're a human

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 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 OpenAI 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 OpenAI Ads MCP. Send --input JSON, get JSON back.

mcp__OpenAI_Ads__tool_get_insightsPerformance 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_campaignsList 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_statusActivate, 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
}

❯

cogny tools list

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

mcp__OpenAI_Ads__tool_get_ad_accountmcp__OpenAI_Ads__tool_get_ad_groupsmcp__OpenAI_Ads__tool_get_adsmcp__OpenAI_Ads__tool_search_geo_locationsmcp__OpenAI_Ads__tool_create_campaignmcp__OpenAI_Ads__tool_create_ad_groupmcp__OpenAI_Ads__tool_upload_imagemcp__OpenAI_Ads__tool_create_admcp__OpenAI_Ads__tool_preview_admcp__OpenAI_Ads__tool_list_pixelsmcp__OpenAI_Ads__tool_get_pixel_eventsmcp__OpenAI_Ads__tool_list_conversion_event_settings

❯

cogny --faq

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.

❯

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

OpenAI Ads from your shell.

cogny --who

cogny tools call

cogny tools list

cogny --faq

related CLIs