Read-only · Meta Ads · Google Ads · TikTok Ads
Ask Claude or any MCP assistant about Meta Ads, Google Ads and TikTok Ads: spend, conversion value and ROAS, bidding targets, locations and audiences, ad copy, and why delivery stopped. Real numbers from the platforms, without opening three dashboards.
Paste into your assistant's connector settings
https://ads.hecigo.com/mcpEach one copies the address first. Cursor and VS Code fill it in; Claude and ChatGPT open their connector page for you to paste it. ChatGPT needs Developer mode on.
No key goes into the assistant. It opens hecigo's sign-in page for you.
Where you connect ad accounts and manage your key.
No new password. Google shares only your name, email address and profile picture with hecigo.
Message hecigo on Zalo or write to hi@hecigo.com. Zalo is usually faster.
Why read straight from the API
Meta's Clicks column also counts image taps and taps on see more. On a real account, dividing spend by that number understates the cost of a site visit nearly sevenfold. Ads Insights keeps the two apart.
How it works
Add a connector in your assistant and paste https://ads.hecigo.com/mcp. No key needed.
The assistant opens hecigo's sign-in page. You grant access to your ad account on Meta's or Google's own screen, and never hand anyone a password.
Ask in plain language, the way you would ask a colleague. The assistant picks the right tool and merges numbers from every connected platform into one table.
Which ad had the cheapest cost per link click over the last 14 days? Compare by ad name, across Meta and Google.
ads_insights · level ad · 14 days
Cheapest is Customer video on Meta, at ₫1,527 per link click.
| Platform | Ad | Spend | Link clicks | Cost/click |
|---|---|---|---|---|
| Meta | Customer video | ₫1,240,000 | 812 | ₫1,527 |
| Brand search | ₫960,000 | 540 | ₫1,778 | |
| Meta | Price list image | ₫1,580,000 | 403 | ₫3,921 |
Price list image costs about 2.5 times as much. Ask next to see its copy and destination link.
Example questions
Each question below combines one or more tools: performance and ROAS, settings and targets, ad copy, search terms, Performance Max. The assistant picks the tools, with numbers straight from the platforms.
Summarise the last 7 days, excluding today, against the 7 days before: total spend, conversion value, ROAS and cost per conversion by platform. Name the 3 campaigns that lifted results and the 3 that dragged them down, with the numbers behind each.
For each running Google campaign, put its configured target ROAS or target CPA next to its actual ROAS and cost per conversion over the last 30 days. Which campaigns miss their target by more than 20%? Do not read targets from campaign names.
List the conversion actions counted in the conversions column and used for bidding, with their lookback windows and attribution model. Is anything like a page view or a first app open inflating conversions?
Over the last 30 days, which search terms spent money without converting? Rank them by cost, group them by theme, propose a negative keyword list and flag terms that mention competitors.
For each Performance Max asset group: ad strength, 30-day ROAS, which assets Google rates LOW and should be replaced, and whether its audience signals and search themes fit what we sell.
Which campaigns look mistargeted: locations outside the markets we sell to, location matching by interest rather than presence, missing exclusions, or a Search campaign with the Display Network switched on?
Compare running ads over the last 14 days by cost per conversion and ROAS. For the best 3 and the worst 3, read their headlines, copy and destination links, and explain what sets them apart.
Based on 30-day ROAS, current daily budgets and impression share lost to budget, which campaigns should get more, the same or less budget? Suggest a figure for each and explain why.
Spend yesterday was far below normal. Check account status, spend caps, rejected ads, ineligible campaigns and daily budgets, then give the main cause first.
Be explicit about the date range and the level: account, campaign, ad set or ad. To reconcile with Ads Manager, pick the same dates and leave today out, because presets such as Last 7 days in Ads Manager exclude today.
Security
Anyone can write the word secure. Here is how hecigo builds it, and how to verify it without taking hecigo's word for it.
Every tool declares readOnlyHint. There are no write tools today. When there are, a read-only workspace will not see them.
In Claude's connector settings, the tools sit under Read-only tools.
You grant access on Meta's and Google's own consent screens. Sign-in uses OAuth 2.1 with PKCE S256 required.
While granting access, the address bar shows facebook.com or accounts.google.com.
The workspace key is stored only as a SHA-256 hash. Ad tokens are sealed with AES-GCM, and no endpoint returns them.
The portal cannot show your key, not even to you. Rotating it stops the old key within 60 seconds.
Disconnect each platform in the portal. Revoke access on the platform itself. Refresh tokens rotate on every use.
After revoking, ask the assistant to check connections and that platform reports an error.
Each request builds a client for exactly one workspace. Numbers are fetched from the platform when you ask, not copied into a store of our own.
Ask it to list accounts: only the ones you connected appear.
Limits, stated up front
Google Ads has a single permission scope, and it includes changing campaigns. The real barrier is the Read only role of the account you authorise with, set on the ad account itself. Authorise with an account that has only that role.
Revoking a workspace key can take up to 60 seconds, because of edge caching.
Who it is for
Want to know where the ad money goes without opening three dashboards or learning each platform's jargon.
Compare creative by cost per result, and catch an ad pointing at the wrong destination before it spends more.
Group several ad accounts into one workspace and query across them. Need it on your own infrastructure? Write to hecigo.
Connection status
Each platform opens to customers once it approves hecigo's app. The integrations are built; what remains is each platform's own review.
Updated 13 September 2026.
FAQ
Any client that supports the Model Context Protocol with OAuth sign-in. It runs in production on Claude.
Ads Insights does not replace Cowork; it plugs into it, as a connector. Without it you export files from each ad manager or let the assistant drive a browser into Ads Manager: the numbers are stale the moment they are exported, every platform names its columns differently, and the assistant sits in a signed-in session that can edit ads. With it, the assistant reads each platform's API when you ask, the numbers arrive as one table, and no tool can change an ad.
Usually not. Signing in with Google creates your workspace straight away. When hecigo reviews sign-ups first, you get an email once approved; for a faster answer, message hecigo on Zalo or write to hi@hecigo.com. An invite code or workspace key you already hold still goes in the field under the Google button.
Performance numbers are fetched from the platform when you ask, not copied into a store of our own. hecigo keeps sealed access tokens and your workspace name.
Not yet. Campaign changes are being designed as two steps: the assistant drafts a plan with a diff, and a person approves that exact plan before it is applied.
Disconnect platforms in the portal, revoke access on the platform itself, or write to hi@hecigo.com to delete your workspace with written confirmation.
Yes: step by step from adding the connector to your first question, with fixes for common problems. Read the guide.
Paste the address, sign in, then ask. Stuck at any step? Message us on Zalo.
https://ads.hecigo.com/mcp