audit_conversion_tracking
ChatGPTReview 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. - lookback_days (optional): 7, 14, 30, 60, or 90 days (default: 30) Execution time: ~5-15 seconds (includes live API calls to ad platforms).
echo_test
ChatGPTEcho back the input message. Used for testing MCP connectivity and session management.
get_connections_status
ChatGPTView 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_usage_status
ChatGPTGet 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 Widget Display (ChatGPT): In ChatGPT, this tool displays an interactive widget 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.
google_ads
ChatGPTAccess 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}
linkedin_ads
ChatGPTAccess 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}
list_connected_accounts
ChatGPTList all connected ad accounts across platforms. Returns account IDs, names, and platforms for all active accounts. Use this at the start of every conversation to know which accounts are available. CRITICAL for multi-account users (agencies): - Always call this first to discover available accounts - Use the returned account IDs when calling any platform tool - If user mentions a business name, match it to an account from this list Returns for each account: - platform: google_ads, meta_ads, tiktok_ads, linkedin_ads - account_id: Platform account ID (pass to tools as customer_id/ad_account_id/advertiser_id/account_id) - account_name: Display name - account_tier: primary, secondary, or active - status: connected, needs_reauth Zero API calls — reads directly from database.
meta_ads
ChatGPTAccess all Meta Ads (Facebook/Instagram) 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, audience insights, wasted spend, creative fatigue, anomaly detection - Campaign Creation: Image, video, carousel campaigns with asset discovery and validation - Campaign Management: Update settings, pause/resume, duplicate campaigns - Ad Management: Create/update ads, ad sets, DCO ads - Targeting: Search and browse targeting options, audience analysis - Placements: Optimize ad placements across Facebook, Instagram, Audience Network - Lead Forms: List forms, get submissions - Creatives: View ad creatives, detect creative fatigue ⚠️ Side effects & confirmation: Write operations change a live Meta (Facebook/Instagram) account. New campaigns are created PAUSED and must be explicitly confirmed by the user before launch. Budget and status changes (pause/resume) take effect immediately and can disrupt ad delivery. Lead-form tools retrieve personal contact data submitted by users. When to use this tool: - "How are my Meta/Facebook campaigns performing?" - "Create a new Facebook image ad campaign" - "Show me my Instagram ad performance" - "What audiences should I target on Meta?" - "Pause my underperforming Meta 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_meta_campaign_performance, analyze_meta_ad_performance, get_meta_adset_performance, analyze_meta_wasted_spend, optimize_meta_budget, get_meta_audience_insights, detect_meta_creative_fatigue, optimize_meta_placements, explain_meta_anomaly, analyze_meta_audiences, get_meta_ad_creatives). You receive a JSON code block of metrics only: spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS, frequency, reach by campaign/ad/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_meta_campaign_performance" arguments: {"lookback_days": 30} Example — raw performance (user asked for raw data): action: "execute" tool_name: "get_meta_campaign_performance" arguments: {"lookback_days": 30, "raw_data": true}
monitoring_and_reporting
ChatGPTAccess 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}
switch_primary_account
ChatGPTActivate ad accounts for a platform. Two modes: 1. account_id (singular) — ADDS this account to the active set. Other already-active accounts stay active. Safe to call multiple times to activate accounts one by one. 2. account_ids (plural, list) — REPLACES the full active set with this exact list. Any account NOT in the list becomes inactive. Use this only when the user explicitly wants to set a specific group of accounts as the complete active set (e.g., "only use accounts A, B, C"). Use this tool when: - User wants to activate a different ad account (use account_id — singular) - User wants to activate multiple specific accounts (use account_ids — plural) - User says "also use my other account" (use account_id — additive) - User says "only use accounts X, Y" (use account_ids — replace) Get account IDs from list_connected_accounts. IMPORTANT: Returns updated connections list after activation.
tiktok_ads
ChatGPTAccess all TikTok Ads campaign management tools. Required first step: call this tool with action: "list_tools" (no other fields). Then call again with action: "execute", a specific tool_name from that list, and arguments. Calling action: "execute" without tool_name is INVALID and will return an error — do not retry the same broken call (issue #297 Bug G). Available capabilities: - Campaign Performance: Analyze metrics, wasted spend, budget optimization, creative fatigue, audience and geo insights, anomaly detection - Asset Discovery: Find existing TikTok images and videos to reuse - Asset Validation: Validate and prepare images/videos for TikTok ad specs - Campaign Creation: Create image-based and video-based TikTok ad campaigns, plus ad groups, ads, and carousel cards - Campaign Management: List campaigns/ad groups/ads, update settings and budgets, pause/resume, and delete campaigns/ad groups/ads - Targeting: Search TikTok targeting options ⚠️ Side effects & confirmation: Write operations change a live TikTok Ads account. New campaigns are created PAUSED and must be explicitly confirmed by the user before launch. Budget and status changes (pause/resume) take effect immediately and can disrupt ad delivery. Deleting a campaign, ad group, or ad is irreversible. When to use this tool: - "Create a new TikTok ad campaign" - "Show me my existing TikTok assets" - "Create a TikTok video campaign" - "Validate my images for TikTok ads" - "How are my TikTok campaigns performing?" 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_tiktok_campaign_performance, get_tiktok_ad_performance, analyze_tiktok_wasted_spend, optimize_tiktok_budget, detect_tiktok_creative_fatigue, explain_tiktok_anomaly, get_tiktok_audience_insights, analyze_tiktok_geo_performance). You receive a JSON code block of metrics only: spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS, hook rate, video completion rate, engagement rate by campaign/ad/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 — create campaign: action: "execute" tool_name: "create_tiktok_campaign" arguments: {"campaign_name": "Summer Sale", "objective": "CONVERSIONS"} Example — raw performance (user asked for raw data): action: "execute" tool_name: "get_tiktok_campaign_performance" arguments: {"lookback_days": 30, "raw_data": true}
