Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage Google Ads & Meta (Facebook) Ads from your AI coding tool. 99 MCP tools for auditing, creating, and optimizing ad accounts using natural language.
Manage Google Ads & Meta (Facebook) Ads from your AI coding tool. 99 MCP tools for auditing, creating, and optimizing ad accounts using natural language.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
AdWhiz is a hosted MCP server that connects your AI coding tool to the Google Ads API and Meta (Facebook) Graph API through a secure, authenticated proxy. It exposes 99 tools across 7 categories so you can audit, create, and manage ad campaigns across both platforms using plain English. All API calls are authenticated via your personal ADWHIZ_API_KEY and routed through the AdWhiz server at mcp.adwhiz.ai. No Google or Meta credentials are stored by the skill โ authentication is handled entirely server-side after you link your ad accounts at https://adwhiz.ai/connect.
OAuth 2.0: User authenticates with Google and/or Meta via AdWhiz's web UI. Refresh tokens (Google) and long-lived access tokens (Meta) are encrypted at rest (AES-256-GCM) and never exposed to the agent. API key scoping: Each ADWHIZ_API_KEY is bound to a single user's connected accounts. Cross-user access is not possible. Write safety: All Google Ads write tools create entities in PAUSED status by default. Meta write tools require explicit status parameters. Mutation logging: Every mutation is recorded in the get_operation_log tool for full auditability. Read-only by default: 36 of 99 tools are strictly read-only and cannot modify your accounts. Confirmation required: Write tools require user confirmation before executing via the agent's standard permission flow. No arbitrary code execution: The MCP server is a hosted HTTP service. No code is downloaded or executed on the user's machine beyond the thin MCP client wrapper.
ToolDescriptionlist_accountsList all accessible Google Ads accounts (auto-expands MCC child accounts)get_account_infoGet account details (currency, timezone, optimization score)
ToolDescriptionlist_campaignsList campaigns with status, type, budget, bidding strategyget_campaign_performanceCampaign metrics: cost, clicks, conversions, CTR, CPA, ROASlist_ad_groupsList ad groups with bids, filtered by campaignlist_adsList ads with headlines, descriptions, final URLslist_keywordsKeywords with match types, bids, quality scoresget_search_termsSearch terms report (actual queries triggering ads)list_negative_keywordsNegative keywords at campaign, ad group, or account levellist_assetsSitelinks, callouts, structured snippetslist_conversion_actionsConversion actions with status, type, categorylist_budgetsCampaign budgets with associated campaignslist_bidding_strategiesPortfolio bidding strategieslist_audience_segmentsAudience targeting criterialist_user_listsRemarketing/audience lists for targetingget_operation_logRecent mutations performed via AdWhizlist_recommendationsGoogle Ads recommendations (add keywords, raise bids, fix ad strength)get_change_historyChange audit log: who changed what and whenlist_geo_targetsGeographic location targeting on campaignslist_ad_schedulesAd schedule (dayparting) criteria on campaignslist_labelsLabels for organizing campaigns, ad groups, ads, keywordsgenerate_keyword_ideasKeyword ideas with search volume, competition, bid ranges
ToolDescriptioncreate_campaignCreate Search, Display, PMax, or Video campaign (starts PAUSED)update_campaignUpdate campaign nameset_campaign_statusPause, enable, or remove a campaigncreate_ad_groupCreate an ad group in a campaignupdate_ad_groupUpdate ad group name or CPC bidset_ad_group_statusPause, enable, or remove an ad groupcreate_responsive_search_adCreate RSA with headlines + descriptions (starts PAUSED)set_ad_statusPause, enable, or remove an adadd_keywordsAdd keywords with match types and bidsupdate_keyword_bidChange a keyword's CPC bidset_keyword_statusPause, enable, or remove a keywordadd_negative_keywordAdd negative keyword at campaign or ad group levelremove_negative_keywordRemove a negative keywordcreate_shared_negative_listCreate a shared negative keyword listadd_to_shared_listAdd keywords to a shared negative listattach_shared_listAttach shared list to a campaigncreate_sitelinkCreate a sitelink assetcreate_calloutCreate a callout assetcreate_structured_snippetCreate a structured snippet assetcreate_price_extensionCreate a price extension assetlink_asset_to_campaignLink asset to a campaignunlink_asset_from_campaignUnlink asset from a campaigncreate_conversion_actionCreate a conversion tracking actionupdate_conversion_actionUpdate conversion action name or statuscreate_budgetCreate a campaign budgetupdate_budgetUpdate budget amount or namecreate_bidding_strategyCreate a portfolio bidding strategyadd_audience_to_campaignAdd audience targeting to a campaignupdate_responsive_search_adUpdate RSA headlines, descriptions, or URLslink_asset_to_ad_groupLink asset to an ad groupunlink_asset_from_ad_groupRemove asset-to-ad-group linkageupload_click_conversionsUpload offline click conversions (gclid-based)upload_customer_listUpload hashed PII to Customer Match user listapply_recommendationApply a Google Ads recommendationdismiss_recommendationDismiss a Google Ads recommendationadd_geo_targetingAdd geographic location targeting to a campaignremove_geo_targetingRemove geographic location target from a campaignadd_ad_scheduleAdd ad schedule (dayparting) to a campaignremove_ad_scheduleRemove ad schedule criterion from a campaignset_device_bid_adjustmentSet device bid adjustment (mobile, desktop, tablet)set_demographic_targetingSet demographic targeting (age, gender, income)create_labelCreate a label for organizing entitiesapply_labelApply a label to a campaign, ad group, or adremove_labelRemove a label from a campaign, ad group, or adcreate_asset_groupCreate an asset group for Performance Max campaigns
ToolDescriptionrun_mini_auditQuick 3-metric audit: wasted spend, best/worst CPA, projected savingsrun_full_auditComprehensive audit: campaigns, keywords, search terms, issues, recommendations
ToolDescriptionrun_gaql_queryExecute a read-only GAQL query against your account (max 1,000 rows, SELECT only)
ToolDescriptionmeta_list_ad_accountsList all connected Meta ad accountsmeta_list_campaignsList campaigns with status, objective, budgetmeta_get_campaign_insightsPer-campaign metrics: spend, clicks, CTR, CPA, frequency (with optional breakdowns)meta_list_ad_setsList ad sets with targeting, status, budgetmeta_list_adsList ads with creative details (title, body, image URL)meta_get_account_insightsAccount-level aggregated metrics with daily breakdownmeta_get_ad_set_insightsPer-ad-set performance metrics: spend, clicks, CPA, frequencymeta_get_ad_insightsPer-ad performance metrics: spend, clicks, conversions, CPAmeta_get_ad_creativesList ad creatives or get creative for a specific admeta_search_interestsSearch targetable interest audiences by keywordmeta_search_geo_locationsSearch geographic locations for targetingmeta_estimate_audience_sizeEstimate reach of a targeting specmeta_get_account_pagesList Facebook pages available for running ads
ToolDescriptionmeta_set_campaign_statusPause or activate a Meta campaignmeta_update_campaign_budgetUpdate a Meta campaign's daily or lifetime budgetmeta_set_ad_set_statusPause or activate a Meta ad setmeta_set_ad_statusPause or activate a Meta admeta_create_campaignCreate a new Meta campaign with objective and budgetmeta_create_ad_setCreate an ad set with targeting, budget, optimization goalmeta_create_ad_creativeCreate ad creative with image/video, link, CTAmeta_create_adCreate an ad linking an ad set to a creativemeta_update_campaignUpdate campaign name, budget, end time, spend capmeta_update_ad_setUpdate ad set name, budget, targeting, schedulemeta_update_adUpdate ad name, creative, or statusmeta_create_custom_audienceCreate custom audience from customer lists or website visitorsmeta_create_lookalike_audienceCreate lookalike audience from source audiencemeta_upload_ad_imageUpload image from URL for ad creativesmeta_duplicate_campaignDuplicate campaign with all ad sets and ads
ToolDescriptionmeta_run_mini_auditQuick health audit: score (0-100) across wasted spend, CPA efficiency, budget utilization, creative fatigue
AdWhiz uses HTTP transport to connect to the hosted MCP server. No npm packages are downloaded or executed at runtime. { "mcpServers": { "adwhiz": { "transport": "http", "url": "https://mcp.adwhiz.ai/mcp", "headers": { "Authorization": "Bearer ${ADWHIZ_API_KEY}" } } } }
For platforms that cannot use the MCP protocol (GPT Actions, Dify, Coze, or any HTTP-based workflow), AdWhiz also exposes all 99 tools as a standard REST API with an OpenAPI 3.1.0 spec: OpenAPI spec: https://mcp.adwhiz.ai/api/v1/openapi.json Tool listing: https://mcp.adwhiz.ai/api/v1/tools Tool execution: POST https://mcp.adwhiz.ai/api/v1/tools/{tool_name} # Example: list campaigns via REST API curl -X POST https://mcp.adwhiz.ai/api/v1/tools/list_campaigns \ -H "Authorization: Bearer $ADWHIZ_API_KEY" \ -H "Content-Type: application/json" \ -d '{"customer_id": "1234567890"}' Import the OpenAPI spec URL into any platform that supports OpenAPI actions to auto-discover all 99 tools.
clawhub install adwhiz This adds the MCP server configuration above to your settings. You will be prompted to provide your ADWHIZ_API_KEY.
Sign up at https://adwhiz.ai Connect your Google Ads and/or Meta Ads account via OAuth Copy your API key from the dashboard settings page
"Audit my Google Ads account and show the top 5 waste areas" "Pause all campaigns with CPA above $150" "Add these negative keywords to my Search campaigns: [list]" "Create a new Search campaign targeting lawyers in New York with $100/day budget" "Show me search terms wasting money and suggest negatives" "What is my account's average Quality Score this month?"
"Audit my Meta Ads account and show the health score" "List all active Meta campaigns with their spend and CTR" "Pause the Meta campaign with the highest frequency" "Show me daily spend trends for my Meta account over the last 30 days" "Which Meta ad sets have the worst CPA?"
AdWhiz only accesses the ad accounts you explicitly linked No campaign data is stored beyond the duration of each API request Mutation logs are retained for 30 days for auditability You can revoke access at any time from https://adwhiz.ai/connect
Full documentation: https://adwhiz.ai/docs
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.