adwhiz-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@adwhiz-mcp What's the AI recommending I do right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DEXUN AdWhiz MCP Server
Let Claude Desktop / Cursor / any MCP-aware client talk to your DEXUN AdWhiz account. Ask Claude things like:
"List my connected ad accounts." "What's the AI recommending I do right now?" "Have there been any sign-ins from new IPs this week?" "How close am I to my API rate limit?"
Read-only for now (v0.1) — Claude can see your AdWhiz state but can't apply changes or pause campaigns. Mutation tools land in a later version once the optimizer exits shadow mode.
What you need
Node.js 18 or newer (
node --version)A DEXUN AdWhiz account (sign up free)
A DEXUN AdWhiz API key — generate one at /settings#api-keys
Either:
Claude Desktop (recommended)
Cursor with MCP enabled
Any other MCP-aware client
No npm install required. The server is a single Node script with zero runtime dependencies.
Related MCP server: Google Ads MCP Server
Install
Claude Desktop
Clone or download this repo somewhere stable on your machine:
git clone https://github.com/dexun-inc/adwhiz-mcp.git ~/.adwhiz-mcpOpen Claude Desktop's MCP config file. On macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:
%APPDATA%\Claude\claude_desktop_config.jsonAdd the
adwhizentry tomcpServers:{ "mcpServers": { "adwhiz": { "command": "node", "args": ["/absolute/path/to/.adwhiz-mcp/src/index.mjs"], "env": { "ADWHIZ_API_KEY": "dxk_live_PUT_YOUR_KEY_HERE" } } } }Replace the path with where you cloned the repo, and the API key with one from /settings#api-keys.
Quit Claude Desktop completely and reopen. The 5 AdWhiz tools should now show up when you start a new conversation.
Cursor
Same
git clonestep.Open Cursor → Settings → Features → Model Context Protocol → Add server.
Use the same
command+args+envshape as Claude Desktop.
Other MCP clients
Any client that follows the MCP spec can use this. The server speaks plain JSON-RPC 2.0 over stdio. Tell the client to run node /path/to/src/index.mjs and set ADWHIZ_API_KEY in the spawn environment.
What Claude can do
Tool | Use when the user asks |
| "What accounts do I have connected?" / "Show me my Meta accounts" |
| "What does the AI recommend right now?" / "Anything to do today?" |
| "How much has AdWhiz saved me?" / "Is the AI actually working?" |
| "What happened this week?" / "Any sign-ins I didn't make?" |
| "Am I close to my rate limit?" / "How much API quota do I have?" |
All five are read-only. They never apply budget changes, pause campaigns, or revoke keys. To do those things use the dashboard.
Environment
Variable | Default | Notes |
| (required) |
|
|
| Override for self-hosted / staging environments. |
Troubleshooting
Claude says "Server adwhiz is not responding" or the tools don't appear. Run the script manually to see stderr output:
ADWHIZ_API_KEY=dxk_live_... node /path/to/src/index.mjsIt should sit idle waiting for stdin. If it errors immediately, the message tells you what's wrong (most commonly: API key missing or node is too old).
Tools error with "Unauthorized". Your API key was revoked or you copied it wrong. Generate a fresh one at https://app.7275.com/settings#api-keys.
Rate limited.
You're hitting your plan's per-key RPM cap (60/120/600/3000 RPM by tier). Either wait for the window to reset (get_quota tells you when) or upgrade.
Security model
The MCP server runs locally on YOUR machine. Your API key never leaves your machine.
All HTTP requests go directly to
app.7275.comover HTTPS.Claude sees only the data the tools return — same data your dashboard shows you.
This server is open source. Audit it before installing on a sensitive machine.
Versioning
v0.1 — Read-only tools: list accounts / recommendations / activity / quota / identity.
v0.2 (planned) —
apply_recommendationonce auto-apply is calibration-gated.v0.3 (planned) —
pause_campaign+change_budgetdirect mutations.
License
MIT — see LICENSE.
Issues / questions
Bug reports + feature requests: open an issue on the main repo or email service@7275.com.
Privacy Policy
This extension talks only to the DEXUN AdWhiz API (https://app.7275.com/api/v1)
using the API key you configure. It reads your ad-account metadata, AI
recommendations, savings summary, and audit events — it never modifies
campaigns or spends money, and it sends no data to any third party.
Full policy: https://www.7275.com/en/legal/privacy
Available Tools
5 toolsget_quotaGet API quota statusARead-only
Get the current rate-limit window for this API key — how many requests/min you're allowed (tier-dependent), how many you have left, and when the window resets. Use this to budget batch operations or diagnose why a previous tool call got rate-limited.
Inputs: no named parameters.
get_recent_activityGet recent account activityARead-only
List the user's most recent security + system audit events (sign-ins, API key changes, OAuth connections, subscription changes, AI changes applied). Use this when the user asks 'what happened recently' or 'did anything change'. Optional kind filter restricts to one event type (e.g. 'sign_in').
Inputs: kind, limit.
get_savings_summaryGet savings summaryARead-only
Get the user's bottom-line: how much money the AI has saved them across all campaigns, broken down by time window (this month, last 7 days, lifetime). This is the headline number on their dashboard. Use this when the user asks 'is this working' / 'how much has it saved me' / 'what's the ROI'.
Inputs: no named parameters.
list_ad_accountsList connected ad accountsARead-only
List every advertising account the user has connected to DEXUN AdWhiz. Returns one row per account with platform (google_ads / meta_ads / tiktok_ads), human-readable name, and connection status. Use this when the user asks 'what accounts do I have' or wants to refer to one of their accounts by name in a follow-up question.
Inputs: no named parameters.
list_recommendationsList AI optimization recommendationsARead-only
List the AI's current open optimization recommendations across all the user's connected accounts. Each recommendation is one campaign-level action (increase budget / decrease budget / pause) with the predicted ROAS, confidence, and reason. Use this when the user asks 'what should I do' or 'what does the AI recommend'. Recommendations refresh daily.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool addresses a distinct aspect: accounts, recommendations, savings, activity, and quota. There is no ambiguity or overlapping purpose, making it clear which tool to select for a given query.
All tools follow a consistent verb_noun pattern (list_* and get_*), with clear object names. The naming is uniform and predictable, aiding agent selection.
With only 5 tools, the server is tightly scoped to its core purpose of providing AI-driven ad optimization insights. Each tool is necessary and none feel superfluous.
The tool surface covers the main read-only workflows: listing accounts, getting recommendations, savings summary, activity, and quota. A potential gap is the lack of an 'apply recommendation' tool, but that likely falls outside the server's advisory role.
Maintenance
Related MCP Connectors
Read-only MCP access to your DEXUN AdWhiz account: ad accounts, AI recommendations, savings.
Query OneLens cloud-cost data in natural language: breakdowns, trends, cost centers. Read-only.
Read-only Google Analytics 4 MCP server for AI assistants.
Read-only access to your AnvilAds Google Ads data: connected ad accounts, campaigns, performance summaries, the latest morning or weekly report, lead totals, and ad audit grades. AnvilAds is an AI agent that builds, launches, and optimizes Google Ads; you approve every launch in the AnvilAds dashboard. Auth is a per-business API key (Bearer).
Related MCP Servers
- AlicenseCqualityBmaintenanceRead-only MCP server for Google Ads, enabling querying campaigns, ad groups, ads, insights, and keywords without create/update/delete operations.17166 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to Google Ads account data including campaigns, ad groups, keywords, and performance reports. Enables querying via GAQL through an MCP interface.MIT
- FlicenseNot gradedqualityCmaintenanceA read-only MCP server for the Google Ads API, exposing reporting tools for account summaries, campaigns, performance, search terms, and conversion actions. Enables natural-language queries to Google Ads data without write access.-
- FlicenseNot gradedqualityDmaintenanceA read-only MCP server for querying Meta Ads accounts through Meta's Marketing API. It provides tools to retrieve ad accounts, campaigns, ad sets, ads, and performance insights.-