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

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 get_connections_status Execution time: 1-3 seconds (cached database query) Data source: campaign_daily_metrics table (updated nightly) Note: Meta does not have keyword or search-term data; it uses interest-based targeting.

get_meta_campaign_performance

Get your current tool-call usage for the billing period. **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 - For annual subscribers, the pooled yearly allowance and annual reset date On hosts that support interactive widgets it renders a usage meter. **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 READ-ONLY and safe to call anytime.

get_usage_status

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

Access monitoring, scheduled reporting, and research 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:** - **Scheduled Briefs**: Set up daily/weekly performance reports delivered by email - **Campaign Monitors**: Create 24/7 alerts for metric thresholds (ROAS, CPA, spend, CTR) - **Research Jobs**: Launch async AI-powered research (competitor analysis, keyword research, market landscape) - **Report Generation**: Generate on-demand performance reports across all ad platforms - **Task Management**: List, manage, and review scheduled tasks, monitors, and pending actions **⚠️ Side effects & confirmation:** Creating briefs, monitors, and reports schedules recurring jobs that send email notifications. Monitors and signal actions can recommend campaign changes and — when the user approves them — apply changes such as pausing campaigns or adjusting budgets, which disrupt live ad delivery. Deleting a monitor is irreversible. **When to use this tool:** - "Set up a daily performance brief" - "Alert me when ROAS drops below 2x" - "Research my competitors' ad strategies" - "Show me my scheduled tasks" - "Generate a report for last week" **Example — list tools:** action: "list_tools" **Example — create a monitor:** action: "execute" tool_name: "create_monitor" arguments: {"platform": "google_ads", "metric": "roas", "operator": "less_than", "threshold": 2.0}

monitoring_and_reporting