Cogny CLI · Paid Social

Snapchat Ads scriptable from Bash.

Pull Snapchat stats for campaigns, ad squads, and ads with swipe/spend/video metrics, list segments and Snap Pixels, and push budget or status changes — all from the shell over the Snapchat Ads MCP. No Marketing API client to wire up.

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

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

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

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

❯

cogny --who

TWO PATHS

You're a human

Snapchat Ads Manager makes you click into each ad squad to read swipes, spend, and video metrics, and export per view. The CLI returns stats at any level — with optional country/placement breakdowns — as JSON in one call. Connect Snapchat 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 Snapchat 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 Snapchat Ads MCP. Send --input JSON, get JSON back.

mcp__Snapchat_Ads__tool_get_statsPerformance stats for a campaign, ad squad, ad, or account.

$ cogny tools call mcp__Snapchat_Ads__tool_get_stats \
  --input '{"entity_id":"a1b2c3d4-1111-2222-3333-444455556666","start_time":"2026-05-01T00:00:00.000Z","end_time":"2026-05-31T00:00:00.000Z","level":"campaign","granularity":"TOTAL"}'

example response

{
  "total_stats": [
    {
      "total_stat": {
        "stats": {
          "impressions": 612044,
          "swipes": 18230,
          "spend": 4120550000,
          "video_views": 240118
        }
      }
    }
  ]
}

mcp__Snapchat_Ads__tool_get_campaignsList campaigns with status, objective, and budget.

$ cogny tools call mcp__Snapchat_Ads__tool_get_campaigns \
  --input '{"ad_account_id":"7a8b9c0d-aaaa-bbbb-cccc-ddddeeeeffff","status_filter":["ACTIVE"],"limit":2}'

example response

[
  {
    "id": "a1b2c3d4-1111-2222-3333-444455556666",
    "name": "Prospecting — Snap Ads",
    "status": "ACTIVE",
    "objective": "WEB_CONVERSION"
  },
  {
    "id": "a1b2c3d4-7777-8888-9999-aaaabbbbcccc",
    "name": "Awareness — Story Ads",
    "status": "ACTIVE",
    "objective": "BRAND_AWARENESS"
  }
]

mcp__Snapchat_Ads__tool_update_campaign_statusActivate or pause a campaign.

$ cogny tools call mcp__Snapchat_Ads__tool_update_campaign_status \
  --input '{"ad_account_id":"7a8b9c0d-aaaa-bbbb-cccc-ddddeeeeffff","campaign_id":"a1b2c3d4-1111-2222-3333-444455556666","status":"PAUSED"}'

example response

{
  "id": "a1b2c3d4-1111-2222-3333-444455556666",
  "status": "PAUSED",
  "success": true
}

❯

cogny tools list

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

mcp__Snapchat_Ads__tool_list_organizationsmcp__Snapchat_Ads__tool_list_ad_accountsmcp__Snapchat_Ads__tool_get_ad_squadsmcp__Snapchat_Ads__tool_get_adsmcp__Snapchat_Ads__tool_list_segmentsmcp__Snapchat_Ads__tool_list_pixelsmcp__Snapchat_Ads__tool_update_campaign_budgetmcp__Snapchat_Ads__tool_update_ad_squad_budgetmcp__Snapchat_Ads__tool_update_ad_squad_targeting

❯

cogny --faq

Is this an official Snapchat Ads CLI?

No — it is the Cogny CLI calling the Snapchat 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.

Can I break stats down by country or placement?

Yes. tool_get_stats accepts a single breakdown per call — country, gender, placement, or platform — plus optional swipe-up and view attribution windows.

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__Snapchat_Ads__tool_get_stats --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

Snapchat Ads scriptable from Bash.

cogny --who

cogny tools call

cogny tools list

cogny --faq

related CLIs