Adspirer

[
  {
    "name": "start_here",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Show the user where to start and what to try next with Adspirer — a visual 'first wins' guide personalized to their connected platforms, real account data, and what they've already done.\n\n**Call this when:**\n- A user has just connected Adspirer (first session, few or no tool calls yet)\n- The user asks \"what can you do?\", \"where do I start?\", \"what should I try?\", or anything about Adspirer's capabilities\n- The user seems unsure what to do next\n\nFree — never counts against the user's quota. Rende"
  },
  {
    "name": "search_tools",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Find the right Adspirer tool(s) for a task by describing what you want to do in natural language. Returns the best-matching tool names with a one-line summary — then call `get_tool_schema` with a name to get its exact parameters before calling it. Use this instead of guessing tool names. Optionally filter by `platform` (google-ads, meta-ads, tiktok-ads, linkedin-ads, amazon-ads, chatgpt-ads, microsoft-ads)."
  },
  {
    "name": "get_tool_schema",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get the exact, authoritative signature (name, parameters, types, required fields, allowed values) for one or more tools by name. Call this after `search_tools` and BEFORE calling a tool, so you send correct arguments and never guess. The schema returned is the live tool definition — always current. This is a TOP-LEVEL tool like `search_tools`: call it DIRECTLY by name when it is in your tool list, e.g. get_tool_schema({\"tool_names\": [\"pause_meta_campaign\"]}). If your client does not list it, cal"
  },
  {
    "name": "get_campaign_performance",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Analyze Google Ads campaign performance with comprehensive insights and recommendations.\n\n⚠️ IMPORTANT: This tool retrieves READ-ONLY data. Safe to call multiple times.\n\n**Returns detailed analysis:**\n- Campaign structure and ad group organization\n- Keyword performance with quality scores and match types\n- Ad group performance breakdown\n- Performance metrics (CTR, conversions, CPC, cost, ROAS)\n- Optimization recommendations with actionable insights\n- Performance trends (last 7 days)\n\n**Parameter"
  },
  {
    "name": "get_usage_status",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get your current tool-call usage for the billing period.\n\n**Returns:**\n- Current usage (calls used / limit) — monthly limit or annual pool\n- Subscription tier (Free, Plus, Pro, Enterprise) and billing period (monthly / annual)\n- When the quota or annual pool resets\n- For annual subscribers, the pooled yearly allowance and annual reset date\n\nOn hosts that support interactive widgets it renders a usage meter.\n\n**Use this tool when:**\n- User asks \"how many calls do I have left?\"\n- User asks about t"
  },
  {
    "name": "get_meta_campaign_performance",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "User asks about Meta/Facebook/Instagram ad performance, campaign metrics, ROAS, spend analysis, or wants to understand how their Meta ads are performing.\n\nThis tool retrieves comprehensive campaign performance metrics from Meta Ads.\n\nReturns:\n- Account summary (total spend, impressions, reach, conversions, ROAS)\n- Campaign breakdown with status and objectives\n- Top performing campaigns by ROAS\n- Meta-specific metrics (reach, frequency, reach/impressions ratio)\n- Optimization recommendations\n\nWhe"
  },
  {
    "name": "audit_conversion_tracking",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Review your conversion tracking setup across ad platforms. Checks Meta Pixel (event volume, CAPI status, dedup, diagnostics), LinkedIn (conversion rules, CAPI, Insight Tag), and Google Ads (conversion actions, enhanced conversions, attribution). Returns a health score (0-100), grade (A-F), detailed findings, and suggestions with self-validation steps for each platform.\n\nNote: Some checks rely on API data availability and may not capture all configurations. Where findings are inconclusive, the to"
  },
  {
    "name": "get_connections_status",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "View connected ad accounts and OAuth connections.\n\nShows all connected ad platforms (Google Ads, TikTok Ads, Meta Ads, LinkedIn Ads) with:\n- Connection status and account details\n- Primary account indicator\n- Option to switch primary account\n- Quick links to connect new platforms\n\nUse this tool when user asks about:\n- \"how many accounts do I have\" / \"how many ad accounts\"\n- \"what accounts are connected\" / \"connected accounts\"\n- \"which account am I using\" / \"current account\"\n- \"show my connection"
  },
  {
    "name": "switch_primary_account",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Activate ad accounts for a platform.\n\nTwo modes:\n\n1. `account_id` (singular) — ADDS this account to the active set. Other\n   already-active accounts stay active. Safe to call multiple times to\n   activate accounts one by one.\n\n2. `account_ids` (plural, list) — REPLACES the full active set with this\n   exact list. Any account NOT in the list becomes inactive. Use this only\n   when the user explicitly wants to set a specific group of accounts as\n   the complete active set (e.g., \"only use accounts"
  },
  {
    "name": "diagnose_funnel",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "DIAGNOSE why a user's ads aren't producing sales/leads — the ordered root-cause check that tells them WHICH part of their funnel is broken and what to do about it.\n\n**Call this when the user asks:**\n- \"why aren't my ads selling / working / converting?\", \"I'm not getting any sales\", \"my ads aren't performing\", \"what's wrong with my account?\", \"what would you do to increase sales?\", \"I'm losing money on ads\"\n- any open-ended \"something is wrong and I don't know what\" question\n\n**How it differs fro"
  },
  {
    "name": "competitor_ads_research",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Research what a COMPETITOR is actually advertising right now — their live ad creatives, headlines, offers, calls to action, formats, and how long each ad has been running — pulled from public ad-transparency sources and read with vision analysis, then placed SIDE BY SIDE with the user's own connected ad account.\n\n**Call this when the user asks:**\n- \"what ads is <competitor> running\", \"show me my competitor's ads\"\n- \"what are competitors doing\", \"competitor ad research/analysis/intelligence\"\n- \"w"
  },
  {
    "name": "monitoring_and_reporting",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access monitoring, scheduled reporting, and research tools.\n\n**Use action=\"list_tools\" first** to see available operations and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**Available capabilities:**\n- **Scheduled Briefs**: Set up daily/weekly performance reports delivered by email\n- **Campaign Monitors**: Create 24/7 alerts for metric thresholds (ROAS, CPA, spend, CTR)\n- **Research Jobs**: Launch async AI-powered research (competitor analysis, keyword "
  },
  {
    "name": "google_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all Google Ads campaign management tools.\n\n**Use action=\"list_tools\" first** to see available operations and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**Available capabilities:**\n- **Campaign Performance**: Analyze metrics, wasted spend, budget optimization, search terms, anomaly detection\n- **Campaign Creation**: Search, Performance Max, YouTube, Demand Gen, **Display** (+ Smart Display) campaigns with full asset validation\n- **Campaign Manag"
  },
  {
    "name": "meta_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all Meta Ads (Facebook/Instagram) campaign management tools.\n\n**Use action=\"list_tools\" first** to see available operations and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**Available capabilities:**\n- **Campaign Performance**: Analyze metrics, audience insights, wasted spend, creative fatigue, anomaly detection\n- **Campaign Creation**: Image, video, carousel campaigns with asset discovery and validation\n- **Campaign Management**: Update setting"
  },
  {
    "name": "linkedin_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all LinkedIn Ads campaign management tools.\n\n**Use action=\"list_tools\" first** to see available operations and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**Available capabilities:**\n- **Campaign Performance**: Analyze metrics, engagement, audience insights, wasted spend, anomaly detection\n- **Campaign Creation**: Image, video, carousel, text ad campaigns with asset discovery\n- **Campaign Management**: Update settings, pause/resume, clone, batch"
  },
  {
    "name": "tiktok_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all TikTok Ads campaign management tools.\n\n**Required first step:** call this tool with `action: \"list_tools\"`.\nThen call again with `action: \"execute\"`, a specific `tool_name` from that list, and\n`arguments`. Calling `action: \"execute\"` without `tool_name` is INVALID and will\nreturn an error — do not retry the same broken call (issue #297 Bug G).\n\n**Available capabilities:**\n- **Campaign Performance**: Analyze metrics, wasted spend, budget optimization, creative fatigue, audience and geo"
  },
  {
    "name": "amazon_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all Amazon Ads campaign management tools (Sponsored Products + Sponsored Brands).\n\n**Required first step:** call this tool with `action: \"list_tools\"`.\nThen call again with `action: \"execute\"`, a specific `tool_name` from that list, and\n`arguments`. Calling `action: \"execute\"` without `tool_name` is INVALID and will\nreturn an error — do not retry the same broken call.\n\n**Available capabilities:**\n- **Accounts**: List advertiser profiles (per-marketplace accounts)\n- **Campaign Management**"
  },
  {
    "name": "chatgpt_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all ChatGPT Ads (OpenAI Ads) tools — ads shown inside ChatGPT responses.\n\n**Required first step:** call this tool with `action: \"list_tools\"`.\nThen call again with `action: \"execute\"`, a specific `tool_name` from that list, and\n`arguments`. Calling `action: \"execute\"` without `tool_name` is INVALID and will\nreturn an error — do not retry the same broken call.\n\n**Multi-account:** a user can connect several ChatGPT Ads accounts (one Advertiser\nAPI key each). When more than one is connected,"
  },
  {
    "name": "microsoft_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all Microsoft Advertising (Bing Ads) tools — Search, Audience Network, Shopping and Performance Max campaigns on Bing/Microsoft.\n\n**Required first step:** call this tool with `action: \"list_tools\"`.\nThen call again with `action: \"execute\"`, a specific `tool_name` from that list, and\n`arguments`. Calling `action: \"execute\"` without `tool_name` is INVALID and will\nreturn an error — do not retry the same broken call.\n\n**Multi-account:** a user can connect several Microsoft Advertising accoun"
  },
  {
    "name": "walmart_ads",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Access all Walmart Connect (Sponsored Search) tools — Sponsored Products, Sponsored Brands and Sponsored Videos on Walmart.com.\n\n**Required first step:** call this tool with `action: \"list_tools\"`.\nThen call again with `action: \"execute\"`, a specific `tool_name` from that list, and\n`arguments`. Calling `action: \"execute\"` without `tool_name` is INVALID and will\nreturn an error — do not retry the same broken call.\n\n**Multi-account:** a user can connect several Walmart advertisers. When more than "
  },
  {
    "name": "google_analytics",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Read Google Analytics 4 reports and metadata for the user's connected GA4 properties.\n\n**Use action=\"list_tools\" first** to discover available actions and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**When to use:**\n- Website / app traffic, sessions, users, page views, bounce rate, engagement\n- Conversions, conversion events, key events, goal completions\n- Audience demographics, geography, device breakdown\n- Traffic sources (organic, paid, referral, so"
  },
  {
    "name": "klaviyo",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Read and act on the user's Klaviyo (email + SMS marketing) account.\n\n**Use action=\"list_tools\" first** to discover available actions and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**When to use:**\n- Klaviyo lists, segments, profiles, subscribers\n- Email campaign performance (opens, clicks, conversions, revenue)\n- Flows (welcome series, abandoned cart, post-purchase)\n- Adding profiles or events, triggering flows\n- \"Show my Klaviyo campaign stats\", \"add"
  },
  {
    "name": "google_search_console",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Read organic-search performance for the user's verified sites, and submit URLs for re-indexing.\n\n**Use action=\"list_tools\" first** to discover available actions and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**When to use:**\n- Organic search performance — clicks, impressions, CTR, average position\n- Which search queries bring traffic, and which pages rank for them\n- Breakdowns by query, page, country, device, or date\n- Comparing PAID search (`google_a"
  },
  {
    "name": "google_tag_manager",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Read and manage tags and variables in the user's Google Tag Manager containers.\n\n**Use action=\"list_tools\" first** to discover available actions and their parameters.\nThen use action=\"execute\" with the specific tool_name and arguments.\n\n**When to use:**\n- Which tags (conversion pixels, analytics, remarketing) are on their site\n- Whether a specific pixel/tag exists and is configured correctly\n- Diagnosing why a conversion pixel isn't firing — read the tag config\n- Creating or updating a tag or a "
  }
]