Model Context Protocol

MCP Server

Connect any AI assistant to DadAds. Run audits, track rankings, and manage your ADS intelligence through the Model Context Protocol with 30 tools available.

EndpointPOST https://mcp.getdadads.com

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and services. Instead of copy-pasting data between your AI assistant and DadAds, MCP gives your AI direct access to run audits, read analytics, and manage your sites.

MCP works with Claude Code, Claude Desktop, Cursor, Windsurf, and any other MCP-compatible client.

Quickstart

Get connected in under a minute. You need your DadAds API key from Settings → Developer API.

1. Claude Code

Run in your terminal
claude mcp add dadads \
  --transport http \
  --url https://mcp.getdadads.com \
  --header "Authorization: Bearer dadads_sk_YOUR_KEY"

2. VS Code

Add to your VS Code settings (settings.json). The API key is passed as a query parameter since VS Code doesn't support custom headers for MCP:

settings.json
{
  "mcp": {
    "servers": {
      "dadads": {
        "type": "streamable-http",
        "url": "https://mcp.getdadads.com?token=dadads_sk_YOUR_KEY"
      }
    }
  }
}

3. Claude Desktop / Cursor / Windsurf

Add this to your MCP configuration file:

mcp_config.json
{
  "mcpServers": {
    "dadads": {
      "type": "streamable-http",
      "url": "https://mcp.getdadads.com",
      "headers": {
        "Authorization": "Bearer dadads_sk_YOUR_KEY"
      }
    }
  }
}

4. Any MCP Client

Send a JSON-RPC request to the endpoint:

curl
curl -X POST https://mcp.getdadads.com \
  -H "Authorization: Bearer dadads_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}},"id":1},
    {"jsonrpc":"2.0","method":"notifications/initialized"},
    {"jsonrpc":"2.0","method":"tools/list","id":2}
  ]'

Authentication

The MCP server uses the same API keys as the REST API. Pass your key as a Bearer token in the Authorization header on every request.

API keys are prefixed with dadads_sk_. Generate one from Settings → Developer API in your dashboard.

Authorization Header
Authorization: Bearer dadads_sk_live_abc123def456...
Rate limit: 60 requests per minute per API key, same as the REST API.

Configuration

The MCP server uses Streamable HTTP transport with stateless JSON responses. No session management is required.

SettingValue
EndpointPOST https://mcp.getdadads.com
TransportStreamable HTTP (JSON)
AuthBearer token (dadads_sk_*)
Rate limit60 req/min per key
SessionsStateless — no session ID needed

Available Tools

30 tools across 8 categories. read = read-only, write = creates or modifies data.

Account

read
dadads_get_me

Get your profile, plan, and usage limits.

Sites

read
dadads_list_sites

List all registered websites with domain, business type, and GSC status.

read
dadads_get_site

Get detailed information about a specific site.

write
dadads_create_site

Register a new website for ADS analysis. Specify domain, name, and business type.

write
dadads_delete_site

Permanently delete a site and all associated data.

Audits

read
dadads_list_audits

List all audits for a site with status, type, and finding counts.

write
dadads_run_audit

Start a new audit (full, schema, sitemap, technical, competitors, etc.).

read
dadads_get_audit

Get detailed audit results including diagnosis, guiding policy, and findings.

Specialized Audits

write
dadads_run_schema_audit

Detect, validate, and suggest Schema.org improvements.

write
dadads_run_sitemap_audit

Validate XML sitemaps and check URLs.

write
dadads_run_technical_audit

Crawlability, performance, security, mobile, Core Web Vitals.

write
dadads_run_competitors_audit

Compare rankings and identify competitive gaps.

write
dadads_run_geo_audit

Check visibility across Google AIO, ChatGPT, and Perplexity.

write
dadads_run_content_intel

JTBD framework analysis, query fan-out, passage-level evaluation.

write
dadads_run_hreflang_audit

Validate hreflang tags for international ADS.

write
dadads_run_internal_links_audit

Analyze link structure, orphan pages, equity distribution.

write
dadads_run_offpage_audit

Backlink profile, brand mentions, digital PR opportunities.

write
dadads_generate_strategy_plan

Generate a Strategy Canvas using Rumelt's Strategy Kernel.

Analytics

read
dadads_get_queries

Google Search Console data: clicks, impressions, CTR, position. Supports date range and pagination.

read
dadads_get_kpi

6-category KPI snapshot: visibility, retrieval quality, topical authority, engagement, brand, outcomes.

read
dadads_get_stats

Aggregate dashboard statistics across all sites.

read
dadads_list_pages

Crawled pages with title, meta, word count, content grade, and audit decision.

Topics

read
dadads_get_topics

Topic clusters with JTBD mapping, query counts, and top URLs.

write
dadads_run_topics

Cluster GSC queries into semantic topics and map to customer journey.

Rankings

read
dadads_get_rankings

List tracked keywords and current ranking positions.

write
dadads_add_tracked_keyword

Start tracking a keyword with optional target URL.

Monitoring

read
dadads_list_alerts

Traffic and ranking anomalies with severity, metric changes, and affected URLs.

read
dadads_list_actions

ADS task board items with status, priority, and category.

write
dadads_create_action

Create an ADS action task linked to audit findings.

write
dadads_update_action

Update task status, priority, or title.

Examples

Once connected, your AI assistant can use DadAds tools directly. Here are some things you can ask:

“Run a full ADS audit on my site”

The AI will call dadads_list_sites to find your site, then dadads_run_audit to start the audit, and poll dadads_get_audit for results.

“What are my top performing keywords this month?”

Uses dadads_get_queries with date range parameters and sorts by clicks.

“Check if my site appears on ChatGPT and Perplexity”

Calls dadads_run_geo_audit to test AI platform visibility and reports the findings.

“Create action tasks from my latest audit findings”

Reads dadads_get_audit for findings, then uses dadads_create_action to create prioritized tasks.

Need help? support@getdadads.com — Also check the REST API Reference for the underlying endpoints.