{
  "name": "com.hecigo/ads-insights",
  "title": "hecigo Ads Insights",
  "version": "0.1.0",
  "description": "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. Meta Ads, Google Ads and TikTok Ads all connect self-serve, each on the platform's own consent screen. Run by hecigo in Ho Chi Minh City, Vietnam. This server cannot change campaigns, budgets or creatives; it only reads.",
  "websiteUrl": "https://ads.hecigo.com/",
  "documentationUrl": "https://ads.hecigo.com/llms.txt",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://ads.hecigo.com/mcp"
    }
  ],
  "authentication": {
    "type": "oauth2",
    "required": true,
    "protectedResourceMetadata": "https://ads.hecigo.com/.well-known/oauth-protected-resource",
    "authorizationServerMetadata": "https://ads.hecigo.com/.well-known/oauth-authorization-server",
    "scopes": [
      "ads:read"
    ]
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "tools": [
    {
      "name": "ads_health",
      "title": "Check ad platform connections",
      "description": "Which ad platforms the workspace has connected, and whether each credential still works.",
      "annotations": {
        "title": "Check ad platform connections",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_accounts",
      "title": "List ad accounts",
      "description": "Ad accounts, advertisers and customers the workspace can see, with currency and status.",
      "annotations": {
        "title": "List ad accounts",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_insights",
      "title": "Read ad performance",
      "description": "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, search impression share and video views, view rate, cost per view and watch-through.",
      "annotations": {
        "title": "Read ad performance",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_entities",
      "title": "List campaigns and ad sets with budgets",
      "description": "What is running now: status, delivery, daily or lifetime budget, objective, start and end dates.",
      "annotations": {
        "title": "List campaigns and ad sets with budgets",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_creatives",
      "title": "Read ad copy and destination links",
      "description": "What each ad says and where a click goes: headline, body, call to action, destination URL, review status.",
      "annotations": {
        "title": "Read ad copy and destination links",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_settings",
      "title": "Read campaign settings: bidding, targets and targeting",
      "description": "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.",
      "annotations": {
        "title": "Read campaign settings: bidding, targets and targeting",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_search_terms",
      "title": "Read Google search terms",
      "description": "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.",
      "annotations": {
        "title": "Read Google search terms",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_asset_groups",
      "title": "Read Performance Max asset groups",
      "description": "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.",
      "annotations": {
        "title": "Read Performance Max asset groups",
        "readOnlyHint": true
      }
    },
    {
      "name": "ads_delivery",
      "title": "Find out why ads are not spending",
      "description": "Everything each platform reports as stopping or limiting delivery: account status, spend caps, rejected ads.",
      "annotations": {
        "title": "Find out why ads are not spending",
        "readOnlyHint": true
      }
    },
    {
      "name": "analytics_properties",
      "title": "List Search Console sites and Google Analytics properties",
      "description": "The Search Console sites, and Google Analytics 4 properties where connected, that the workspace's Google connections reach, and which of them are read by default.",
      "annotations": {
        "title": "List Search Console sites and Google Analytics properties",
        "readOnlyHint": true
      }
    },
    {
      "name": "search_console_report",
      "title": "Read Google Search Console",
      "description": "Organic Google search: clicks, impressions, CTR and average position by query, page, country, device or day, with site totals that include the queries Google withholds.",
      "annotations": {
        "title": "Read Google Search Console",
        "readOnlyHint": true
      }
    }
  ],
  "publisher": {
    "name": "hecigo",
    "url": "https://hecigo.com",
    "email": "hi@hecigo.com"
  }
}