AutoAdy MCP Server

Meta/Facebook ads intelligence tools for AI assistants. Built by AutoAdy.

As of v1.3.0 this package is a thin stdio proxy of the canonical AutoAdy MCP connector at https://www.autoady.io/api/mcp. tools/list, tools/call, resources/list and resources/read are forwarded to the remote server, so the stdio transport and the remote connector always expose the same canonical tool vocabulary — no drift between the two.

Tools (canonical vocabulary)

tools/list returns the connector's full catalog (~45 tools) live from the server. Highlights:

| Tool | Description | |------|-------------| | get_connected_account / list_ad_accounts / switch_account | See and switch the active Meta ad account | | run_full_audit | Full account audit | | diagnose_drop | "Why did my account break?" investigation | | get_account_insights, get_campaign_insights, get_adset_insights, get_ads | Performance breakdowns at every level | | get_top_performing_ads, analyze_winning_ad, get_winning_frameworks | Find and deconstruct winners | | get_account_health, audit_tracking, get_fatigue_forecast | Health, tracking and fatigue intelligence | | pause_ad, bulk_pause_ads, adjust_campaign_budget, scale_budget_relative, … | Execution tools (Pro plan) | | url_to_ads, multiply_winner, creative_matrix, competitor_creatives | Creative generation workflows (Pro/Agency) | | list_skills, get_skill | AutoAdy's expert media-buying playbooks |

Every tool accepts an optional account_id to target a specific ad account without switching.

Legacy autoady_* names (deprecated aliases)

The 23 legacy autoady_* tool names from v1.x keep working, but are deprecated — prefer the canonical names above.

• Legacy names with a canonical 1:1 equivalent are transparently remapped to the remote tool (they no longer appear in tools/list, but tools/call still accepts them): autoady_list_accounts → list_ad_accounts, autoady_get_health_score → get_account_health, autoady_extract_creative_dna → extract_creative_dna, autoady_analyze_winning_ad → analyze_winning_ad, autoady_url_to_ads → url_to_ads, autoady_multiply_winner → multiply_winner, autoady_competitor_creatives → competitor_creatives, autoady_creative_matrix → creative_matrix, autoady_emergency_recovery → emergency_recovery, autoady_enable_creative_loop → enable_creative_loop, autoady_list_skills → list_skills, autoady_get_skill → get_skill.
• Legacy tools without a canonical equivalent stay available and are appended to tools/list: autoady_get_results, autoady_get_benchmarks, autoady_compare_metrics, autoady_check_fatigue, autoady_generate_ad_copy, autoady_generate_hooks, autoady_get_winner_insights, autoady_fatigue_alerts, autoady_subtitle_video, autoady_push_creative_to_adset, autoady_save_creative.

If the remote connector is unreachable, tools/list falls back to the legacy catalog and tool calls return a clean error explaining the failure — the server never crashes on network issues.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "autoady": {
      "command": "npx",
      "args": ["-y", "@autoady/mcp-server"],
      "env": {
        "AUTOADY_API_KEY": "adk_..."
      }
    }
  }
}

Alternative: remote connector via mcp-remote

If you'd rather talk to the hosted connector directly (OAuth / remote flow, no local process):

{
  "mcpServers": {
    "autoady": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.autoady.io/api/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

Other MCP Clients

Run directly:

npx -y @autoady/mcp-server   # AUTOADY_API_KEY=adk_... in the environment

Or from a checkout: npm install && npm run build && node dist/index.js.

Configuration

| Env var | Required | Default | Purpose | |---------|----------|---------|---------| | AUTOADY_API_KEY | yes | — | Your AutoAdy API key (adk_...) | | AUTOADY_MCP_URL | no | https://www.autoady.io/api/mcp | Point the proxy at a different connector (local dev / self-host) |

Get your API key at autoady.io/settings.

Examples

Audit an account:

"Run a full audit on my Meta ad account"

Diagnose a drop:

"Leads collapsed this week — diagnose what broke"

Get results:

"Show spend, leads and CPL by campaign for the last 7 days"

Find and multiply winners:

"Find my top performing ads, analyze the best one, and generate 10 variations"

Get benchmarks:

"What are the average Meta ads benchmarks for ecommerce?"

Links

• AutoAdy - AI-powered Meta Ads management
• Get API Key
• Documentation