# hecigo Ads Insights

> A hosted Model Context Protocol server for advertising reporting. It answers spend, click and cost-per-result questions about Meta Ads, Google Ads and TikTok Ads inside an assistant such as Claude, in one table. Google Ads is connected today; Meta Ads and TikTok Ads are built and waiting on each platform's app review. Run by hecigo in Ho Chi Minh City, Vietnam.

This server cannot change campaigns, budgets or creatives; it only reads.

Every page here is also Markdown: send `Accept: text/markdown` to https://ads.hecigo.com/, or fetch https://ads.hecigo.com/index.md?lang=en (or lang=vi).

## When to use Ads Insights

Reach for it when a person asks one of these about their own ad accounts:

- **What was spent, and what a result cost**, by account, campaign, ad set or ad name, over a date range, across every connected platform in one answer.
- **Which creative works best**, compared by ad name. This is the reliable comparison when destination links carry no UTM parameters.
- **What is running right now**, with status, daily or lifetime budget, and start and end dates.
- **What an ad actually says and where it links**, to catch an ad pointing somewhere unintended.
- **Why spend is zero or lower than expected**: account status, spend caps, rejected ads, campaigns not eligible.
- **Whether the connection still works**, before blaming an empty report on the account.

Do not route here for: changing campaigns, budgets or creatives (it cannot); ad platforms other than Meta, Google and TikTok; organic social, SEO or web analytics; or choosing a budget, audience or creative on someone's behalf.

## How to connect

- **MCP endpoint:** https://ads.hecigo.com/mcp, Streamable HTTP, stateless, JSON-RPC 2.0 over POST.
- **Authentication:** OAuth 2.1 authorization code with PKCE (S256) and dynamic client registration. An unauthenticated call returns 401 with a `WWW-Authenticate` header whose `resource_metadata` points at https://ads.hecigo.com/.well-known/oauth-protected-resource. Scope: `ads:read`.
- **What the person does:** signs in once at https://ads.hecigo.com/ with Google or an invite code, then grants access to each ad account on Meta's or Google's own consent screen. hecigo never sees a platform password.
- **Sign-up:** signing in with Google creates a workspace straight away. At times hecigo reviews sign-ups first and emails a one-time link on approval. Help: hi@hecigo.com or Zalo (https://zalo.me/3108963776852260798).

## Tools

- `ads_health`: Check ad platform connections. Which ad platforms the workspace has connected, and whether each credential still works.
- `ads_accounts`: List ad accounts. Ad accounts, advertisers and customers the workspace can see, with currency and status.
- `ads_insights`: Read ad performance. Spend, impressions, clicks, CTR, CPC, conversions, cost per conversion, conversion value and ROAS by account, campaign, ad set or ad name, over a date range, plus optional columns such as reach, frequency and search impression share.
- `ads_entities`: List campaigns and ad sets with budgets. What is running now: status, delivery, daily or lifetime budget, objective, start and end dates.
- `ads_creatives`: Read ad copy and destination links. What each ad says and where a click goes: headline, body, call to action, destination URL, review status.
- `ads_settings`: Read campaign settings: bidding, targets and targeting. How each campaign or ad set is set up: bidding strategy with its real target ROAS or CPA, budget, conversion goals, attribution windows, locations, languages, audiences, networks and bid adjustments, plus the account's conversion actions.
- `ads_search_terms`: Read Google search terms. What people actually searched before clicking a Google ad: match type, spend, clicks, conversions, value and ROAS per search term, filterable to terms that spent without converting, plus Performance Max search categories.
- `ads_asset_groups`: Read Performance Max asset groups. Performance Max below the campaign: each asset group's ad strength, spend, conversions and ROAS, every asset with Google's performance label, audience signals and search themes.
- `ads_delivery`: Find out why ads are not spending. Everything each platform reports as stopping or limiting delivery: account status, spend caps, rejected ads.

## Machine-readable

- [OpenAPI](https://ads.hecigo.com/openapi.json): the HTTP surface, including the MCP and OAuth endpoints
- [MCP server card](https://ads.hecigo.com/.well-known/mcp/server-card.json): transport, authentication and tools
- [OAuth protected resource metadata](https://ads.hecigo.com/.well-known/oauth-protected-resource)
- [OAuth authorization server metadata](https://ads.hecigo.com/.well-known/oauth-authorization-server)
- [Sitemap](https://ads.hecigo.com/sitemap.xml)

## Pages

- [Ads Insights, English](https://ads.hecigo.com/?lang=en): what it answers, example prompts, how each security promise can be checked
- [Ads Insights, Tiếng Việt](https://ads.hecigo.com/?lang=vi): the same page in Vietnamese
- [User guide](https://ads.hecigo.com/guide?lang=en): adding the connector, signing in, connecting ad accounts, questions by task, reconciling numbers, common problems (Markdown: https://ads.hecigo.com/guide.md?lang=en)
- [Product overview on hecigo.com](https://hecigo.com/ads-insights/)
- [Privacy Policy](https://hecigo.com/privacy/)
- [Terms of Service](https://hecigo.com/terms/)
- [hecigo](https://hecigo.com/llms.txt): the company that runs it, HECIGO TECHNOLOGY CO., LTD