Skip to main content
Glama
adwhiz-mcp
by DEXUN-inc

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

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

  1. Clone or download this repo somewhere stable on your machine:

    git clone https://github.com/dexun-inc/adwhiz-mcp.git ~/.adwhiz-mcp
  2. Open Claude Desktop's MCP config file. On macOS:

    ~/Library/Application Support/Claude/claude_desktop_config.json

    On Windows:

    %APPDATA%\Claude\claude_desktop_config.json
  3. Add the adwhiz entry to mcpServers:

    {
      "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.

  4. Quit Claude Desktop completely and reopen. The 5 AdWhiz tools should now show up when you start a new conversation.

Cursor

  1. Same git clone step.

  2. Open Cursor → Settings → Features → Model Context Protocol → Add server.

  3. Use the same command + args + env shape 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

list_ad_accounts

"What accounts do I have connected?" / "Show me my Meta accounts"

list_recommendations

"What does the AI recommend right now?" / "Anything to do today?"

get_savings_summary

"How much has AdWhiz saved me?" / "Is the AI actually working?"

get_recent_activity

"What happened this week?" / "Any sign-ins I didn't make?"

get_quota

"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

ADWHIZ_API_KEY

(required)

dxk_live_* or dxk_test_*. Generate at /settings#api-keys.

ADWHIZ_BASE_URL

https://app.7275.com

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.mjs

It 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.com over 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_recommendation once auto-apply is calibration-gated.

  • v0.3 (planned) — pause_campaign + change_budget direct 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 tools
get_quotaGet API quota statusA
Read-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 activityA
Read-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 summaryA
Read-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 accountsA
Read-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 recommendationsA
Read-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

    A4.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (list_* and get_*), with clear object names. The naming is uniform and predictable, aiding agent selection.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Read-only MCP server for Google Ads, enabling querying campaigns, ad groups, ads, insights, and keywords without create/update/delete operations.
      17
      166 PyPI
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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
    • F
      license
      Not graded
      quality
      C
      maintenance
      A 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.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -