Adspirer

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. Note: Some checks rely on API data availability and may not capture all configurations. Where findings are inconclusive, the tool provides guidance on how to verify directly in the platform's dashboard. Parameters: - platform (optional): 'google_ads', 'meta_ads', or 'linkedin_ads'. If omitted, reviews all connected platforms. - account_id (optional): scope the audit to ONE account (Google Ads customer ID, Meta ad account ID, or LinkedIn account ID). If omitted, EVERY active account on the platform is audited — for a user with many active accounts that is many live API calls. To audit a single account, pass account_id; do NOT switch or deactivate active accounts to narrow the audit (that changes account state for the whole login). - customer_id (optional): alias for account_id. - lookback_days (optional): 7, 14, 30, 60, or 90 days (default: 30) Execution time: ~5-15 seconds (includes live API calls to ad platforms).

audit_conversion_tracking

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. **Call this when the user asks:** - "what ads is <competitor> running", "show me my competitor's ads" - "what are competitors doing", "competitor ad research/analysis/intelligence" - "what messaging/offers/creatives do they use", "what's working for them" - "how do my ads compare to <competitor>", "am I bidding on their brand" - anything about competitor creative, competitor copy, or competitive ad strategy **Inputs:** `competitor_domains` (REQUIRED — a list of competitor WEBSITE DOMAINS like ['semrush.com','ahrefs.com']). ⛔ It must be a DOMAIN, not a brand name: a bare brand returns zero results. If the user names a company without giving a website, ASK for the domain — do NOT guess it and do NOT auto-discover competitors. `region` (optional ISO country like 'US','IN','GB' — defaults to the user's own account market; note TikTok and LinkedIn ads are worldwide and cannot be filtered by market). `sources` (optional list — which ad platforms to pull: `['google']` (default, Google Search/Display/YouTube ads), add `'meta'` for their Facebook/Instagram ads, `'tiktok'` for their TikTok ads, and/or `'linkedin'` for their LinkedIn ads — e.g. `['google','meta','tiktok','linkedin']`. Add 'meta' when the user asks about Facebook/Instagram/Meta ads, 'tiktok' when they ask about TikTok ads, and 'linkedin' when they ask about LinkedIn/B2B ads or want a fuller picture). `max_creatives` (optional cap). **What it returns:** an interactive gallery of their real creatives with run-durations, plus the user's own ads and any competitor brand terms they already pay for. ⛔ It does NOT return competitor spend, ROAS, conversions, CPC or impressions — no source publishes those, so the tool never estimates them. Do not ask it for, or infer, how a competitor's ads PERFORM; a long run-duration is a duration, not proof it works. ⚠️ Plus, Pro & Max (not Free). Renders an interactive widget; the text fallback carries the same findings.

competitor_ads_research

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. **Call this when the user asks:** - "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" - any open-ended "something is wrong and I don't know what" question **How it differs from the performance tools:** those DESCRIBE the numbers for one platform. This walks the whole chain in ORDER — is conversion tracking real → should there even be revenue → is there traffic → is it converting → (we can't see the landing page) → where is the money going — and STOPS at the first broken step, reporting the rest as 'not assessed' rather than 'fine'. That ordering is the point: a broken pixel makes every number below it meaningless, and advice about bids or budgets would be guesswork until it's fixed. **Inputs (all optional):** `platform` and `account_id` to narrow to one account; `lookback_days` (14-90, default 60). With no arguments it checks every connected account and leads with the worst one — call it bare. ⛔ It ABSTAINS honestly: if the account has too little data, or the numbers can't be verified, it says so and says what would unlock an answer, rather than guessing. It never invents benchmarks or promises outcomes. If the funnel is healthy and the user wants budget advice, follow up with generate_media_plan. Renders an interactive widget; the text carries the same diagnosis.

diagnose_funnel

Analyze Google Ads campaign performance with comprehensive insights and recommendations. ⚠️ IMPORTANT: This tool retrieves READ-ONLY data. Safe to call multiple times. **Returns detailed analysis:** - Campaign structure and ad group organization - Keyword performance with quality scores and match types - Ad group performance breakdown - Performance metrics (CTR, conversions, CPC, cost, ROAS) - Optimization recommendations with actionable insights - Performance trends (last 7 days) **Parameters:** - lookback_days: 7, 30, 60, 90, or 120 days (default: 30) - start_date: Optional start date (YYYY-MM-DD). Overrides lookback_days when used with end_date. - end_date: Optional end date (YYYY-MM-DD). Overrides lookback_days when used with start_date. ⚠️ DATE CLARIFICATION: If the user's date request is vague or ambiguous (e.g., "March to June" without a year, "last quarter", "recently", "a few months ago"), ask the user to specify exact dates before calling this tool. Do not assume or guess dates. - customer_id: Optional (uses connected account if omitted) - campaign_id: Optional. When provided, scopes the analysis to a single campaign (all metrics, ad groups, keywords, and trends reflect that campaign only). Omit for account-wide analysis. Use `list_campaigns` first to find the campaign ID. **Execution time:** 2-5 seconds (direct backend API call) **Data source:** Cached database (updated nightly via metrics collection) **Use this tool to:** - Review current campaign performance - Identify optimization opportunities - Get data-driven recommendations - Analyze keyword and ad effectiveness - Understand what's working and what needs improvement 📊 **AFTER calling this tool, provide these insights to the user:** **How to Interpret Metrics:** - **CTR (Click-Through Rate):** Industry average is 3-5% for search ads - Above 5%: Excellent ad relevance - Below 2%: Consider improving ad copy or targeting - **Conversion Rate:** Industry average is 2-5% - Low CR + High CTR = Landing page issue - Low CR + Low CTR = Ad/targeting issue - **CPA (Cost Per Acquisition):** Compare to your target CPA - Track the trend over time - Adjust bids if CPA is consistently too high 💡 **Optimization Tips:** - Wait at least 2 weeks before making major changes (learning phase) - Focus on high-performing keywords and pause low performers - Test different ad copy variations (A/B testing) - Adjust bids based on device/location performance - Review search terms report for negative keyword opportunities 💬 **Community**: For optimization discussions and tips, visit our Discord: https://discord.gg/dH3Qt4YS

get_campaign_performance

View connected ad accounts and OAuth connections. Shows all connected ad platforms (Google Ads, TikTok Ads, Meta Ads, LinkedIn Ads) with: - Connection status and account details - Primary account indicator - Option to switch primary account - Quick links to connect new platforms Use this tool when user asks about: - "how many accounts do I have" / "how many ad accounts" - "what accounts are connected" / "connected accounts" - "which account am I using" / "current account" - "show my connections" / "list my accounts" - "connection status" / "account status" - "what platforms do I have connected" - Account count, account list, or connection overview Do not use for: - Discovering campaigns, ads, or keywords (use discover_existing_assets) - Performance data or metrics (use performance tools) - Creating or managing campaigns This is specifically for OAuth connections and account management.

get_connections_status

User asks about Meta/Facebook/Instagram ad performance, campaign metrics, ROAS, spend analysis, or wants to understand how their Meta ads are performing. This tool retrieves comprehensive campaign performance metrics from Meta Ads. Returns: - Account summary (total spend, impressions, reach, conversions, ROAS) - Campaign breakdown with status and objectives - Top performing campaigns by ROAS - Meta-specific metrics (reach, frequency, reach/impressions ratio) - Optimization recommendations When to use this tool: - "How are my Meta ads performing?" - "What's my Facebook campaign ROAS?" - "Show me Instagram ad performance" - "Which Meta campaigns are doing best?" - "Analyze my Meta ad spend" Parameters: - lookback_days: 7, 14, 30 (default), 60, or 90 days - date_range: preset alternative to lookback_days / start_date / end_date. One of: 'last_7_days', 'last_14_days', 'last_30_days', 'last_60_days', 'last_90_days'. (Both 'last_30_days' and 'last_30d' / 'last_month' aliases accepted.) - start_date: Optional start date (YYYY-MM-DD). Overrides lookback_days when used with end_date. - end_date: Optional end date (YYYY-MM-DD). Overrides lookback_days when used with start_date. ⚠️ DATE CLARIFICATION: If the user's date request is vague or ambiguous (e.g., "March to June" without a year, "last quarter", "recently", "a few months ago"), ask the user to specify exact dates before calling this tool. Do not assume or guess dates. - include_recommendations: true (default) or false - ad_account_id: Required for multi-account users. Get from list_connected_accounts Execution time: 1-3 seconds (cached database query) Data source: campaign_daily_metrics table (updated nightly) Note: Unlike Google Ads, Meta does not have keyword or search term data. Meta uses interest-based targeting.

get_meta_campaign_performance

Get your current usage status with interactive quota widget. This tool shows your tool call usage for the current billing period and provides upgrade options if needed. For annual subscribers it shows the pooled yearly allowance ("X / 1,800 used this year"), the annual reset date, and confirms there is no monthly cap. **Returns:** - Current usage (calls used / limit) — monthly limit or annual pool - Subscription tier (Free, Plus, Pro, Enterprise) and billing period (monthly / annual) - When the quota or annual pool resets - Upgrade options with pricing **Use this tool when:** - User asks "how many calls do I have left?" - User asks about their subscription or quota - User wants to check their usage - User asks about upgrading their plan **Interactive widget:** On hosts that support interactive tool widgets, this tool renders a usage card with: - Visual progress bar showing usage - Upgrade buttons that open Stripe checkout - Plan comparison with pricing **Note:** This tool is READ-ONLY and safe to call anytime.

get_usage_status

Access all Google Ads campaign management tools. **Use action="list_tools" first** to see available operations and their parameters. Then use action="execute" with the specific tool_name and arguments. **Available capabilities:** - **Campaign Performance**: Analyze metrics, wasted spend, budget optimization, search terms, anomaly detection - **Campaign Creation**: Search, Performance Max, YouTube, Demand Gen, **Display** (+ Smart Display) campaigns with full asset validation - **Campaign Management**: Update settings, pause/resume, bid strategies, budget changes - **Keyword Management**: Add/remove/update keywords and negative keywords - **Ad Management**: Create ads, update headlines/descriptions/content, pause/resume ads - **Extensions**: Callout extensions, structured snippets, sitelinks - **PMax Controls**: Search themes, audience signals - **Audiences**: Search and discover audience segments - **Business Profile**: Get/infer/save business profile, benchmarking context - **Asset Management**: Upload images, validate and prepare assets, discover existing assets **⚠️ Side effects & confirmation:** Write operations change a live Google Ads account. New campaigns are created **PAUSED** and must be explicitly confirmed by the user before launch. Budget, bid, and status changes (pause/resume) take effect immediately and can disrupt ad delivery. Keyword and ad removals may not be reversible. **When to use this tool:** - "How are my Google Ads campaigns performing?" - "Create a new search campaign" - "Pause my underperforming campaigns" - "Add negative keywords to reduce wasted spend" - "Research keywords for my business" - "What's my campaign structure?" **Raw data mode (performance tools only):** If the user asks for "raw data", "raw metrics", "just the numbers", "no recommendations", or "no commentary" — pass `raw_data: true` inside `arguments` when calling any performance tool (`get_campaign_performance`, `analyze_wasted_spend`, `optimize_budget_allocation`, `analyze_search_terms`, `explain_performance_anomaly`). You receive a JSON code block of metrics only: spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS by campaign/date. Severity labels, suggested bids, suggested budgets, industry benchmarks, and optimization recommendations are stripped. Default is `false` (full formatted analysis). **Example — list tools:** action: "list_tools" **Example — get performance:** action: "execute" tool_name: "get_campaign_performance" arguments: {"customer_id": "123-456-7890", "lookback_days": 30} **Example — raw performance (user asked for raw data):** action: "execute" tool_name: "get_campaign_performance" arguments: {"customer_id": "123-456-7890", "lookback_days": 30, "raw_data": true}

google_ads

Read Google Analytics 4 reports and metadata for the user's connected GA4 properties. **Use action="list_tools" first** to discover available actions and their parameters. Then use action="execute" with the specific tool_name and arguments. **When to use:** - Website / app traffic, sessions, users, page views, bounce rate, engagement - Conversions, conversion events, key events, goal completions - Audience demographics, geography, device breakdown - Traffic sources (organic, paid, referral, social, direct) - Comparing ad spend (from `google_ads` / `meta_ads`) to actual site outcomes - "How is my website performing?", "show GA4 conversions", "what's my bounce rate" If the user hasn't connected Google Analytics, this tool returns a friendly message asking them to open Settings → Connections to authorize the connection. **Example — list actions:** action: "list_tools" **Example — run a report:** action: "execute" tool_name: "google_analytics-run-report" arguments: {"propertyId": "493035312", "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}], "metrics": [{"name": "sessions"}, {"name": "totalUsers"}]}

google_analytics

Access all LinkedIn Ads campaign management tools. **Use action="list_tools" first** to see available operations and their parameters. Then use action="execute" with the specific tool_name and arguments. **Available capabilities:** - **Campaign Performance**: Analyze metrics, engagement, audience insights, wasted spend, anomaly detection - **Campaign Creation**: Image, video, carousel, text ad campaigns with asset discovery - **Campaign Management**: Update settings, pause/resume, clone, batch update, budget/schedule/targeting changes - **Creative Management**: Add/update/pause/resume/delete creatives (image, text, video, carousel) - **Multi-Campaign Composition**: Add campaigns to existing groups (different audiences), add creatives to campaigns (A/B testing) - **Targeting**: Search targeting options, research business for targeting, 19 targeting facets - **Conversions**: List, associate, manage conversion tracking - **Campaign Groups**: List and update campaign groups - **AI Features**: Generate ad creatives, explain objectives, research business targeting **⚠️ Side effects & confirmation:** Write operations change a live LinkedIn Ads account. New campaigns are created **PAUSED** and must be explicitly confirmed by the user before launch. Budget, schedule, targeting, and status changes (pause/resume) take effect immediately and can disrupt ad delivery. Deleting a creative is irreversible. **When to use this tool:** - "How are my LinkedIn campaigns performing?" - "Create a new LinkedIn sponsored content campaign" - "Show me my LinkedIn ad engagement metrics" - "What targeting options are available on LinkedIn?" - "Pause my underperforming LinkedIn campaigns" **Raw data mode (performance tools only):** If the user asks for "raw data", "raw metrics", "just the numbers", "no recommendations", or "no commentary" — pass `raw_data: true` inside `arguments` when calling any performance tool (`get_linkedin_campaign_performance`, `get_linkedin_engagement_metrics`, `get_linkedin_audience_insights`, `analyze_linkedin_wasted_spend`, `optimize_linkedin_budget`, `explain_linkedin_anomaly`, `analyze_linkedin_creative_performance`). You receive a JSON code block of metrics only: spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, engagement rate, lead form completion rate by campaign/creative/date. Severity labels, suggested bids, suggested budgets, industry benchmarks, and optimization recommendations are stripped. Default is `false` (full formatted analysis). **Example — list tools:** action: "list_tools" **Example — get performance:** action: "execute" tool_name: "get_linkedin_campaign_performance" arguments: {"lookback_days": 30} **Example — raw performance (user asked for raw data):** action: "execute" tool_name: "get_linkedin_campaign_performance" arguments: {"lookback_days": 30, "raw_data": true}

linkedin_ads