1. Docs
2. /
3. Tool reference
4. /
5. Ads
6. /
7. readAdInsights

Ads

readAdInsights

Read Ad Insights

readAdInsights: read impressions, clicks, CTR, CPC, spend and conversions for a Meta ad, ad set or campaign over a date preset, marked sandbox when the account is a sandbox.

readexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "how are the Rocket ads doing", and it calls readAdInsights.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "clientRequestId": "<clientRequestId>",
    "dryRun": true,
    "datePreset": "<datePreset>",
    "objectId": "<objectId>"
  },
  "name": "readAdInsights"
}

Arguments

• clientRequestIdstringrequiredA stable id you mint for THIS request (e.g. a UUID) and reuse on a retry. A repeat of a succeeded id returns its receipt instead of calling Meta twice.
• dryRunbooleanrequiredtrue runs the account gate and writes a dry_run receipt without sending anything to Meta. Use it first to preview.
• datePresetstringrequiredThe reporting window.
• objectIdstringrequiredAn ad, ad set or campaign id.

Returns

The registry does not declare a return shape.

Declared limits

• clientRequestId: minimum length 8
• clientRequestId: maximum length 128

Ask for it

The Cloud routes these requests to this verb.

• how are the Rocket ads doing
• what did we spend on Meta this week

Pair it with

The verbs that finish the job.

• pauseAd
• setAdBudget

Questions

• What does readAdInsights do?

  readAdInsights: read impressions, clicks, CTR, CPC, spend and conversions for a Meta ad, ad set or campaign over a date preset, marked sandbox when the account is a sandbox. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use readAdInsights from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "how are the Rocket ads doing", and it calls readAdInsights.

• Is readAdInsights safe to let an AI call?

  readAdInsights is read-only: it changes nothing. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.