Model Context Protocol

MCP Server

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

EndpointPOST https://mcp.getdadseo.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 DadSEO, 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 DadSEO API key from Settings → Developer API.

1. Claude Code

Run in your terminal
claude mcp add dadseo \
  --transport http \
  --url https://mcp.getdadseo.com \
  --header "Authorization: Bearer dadseo_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": {
      "dadseo": {
        "type": "streamable-http",
        "url": "https://mcp.getdadseo.com?token=dadseo_sk_YOUR_KEY"
      }
    }
  }
}

3. Claude Desktop / Cursor / Windsurf

Add this to your MCP configuration file:

mcp_config.json
{
  "mcpServers": {
    "dadseo": {
      "type": "streamable-http",
      "url": "https://mcp.getdadseo.com",
      "headers": {
        "Authorization": "Bearer dadseo_sk_YOUR_KEY"
      }
    }
  }
}

4. Any MCP Client

Send a JSON-RPC request to the endpoint:

curl
curl -X POST https://mcp.getdadseo.com \
  -H "Authorization: Bearer dadseo_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 dadseo_sk_. Generate one from Settings → Developer API in your dashboard.

Authorization Header
Authorization: Bearer dadseo_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.getdadseo.com
TransportStreamable HTTP (JSON)
AuthBearer token (dadseo_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
dadseo_get_me

Get your profile, plan, and usage limits.

Sites

read
dadseo_list_sites

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

read
dadseo_get_site

Get detailed information about a specific site.

write
dadseo_create_site

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

write
dadseo_delete_site

Permanently delete a site and all associated data.

Audits

read
dadseo_list_audits

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

write
dadseo_run_audit

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

read
dadseo_get_audit

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

Specialized Audits

write
dadseo_run_schema_audit

Detect, validate, and suggest Schema.org improvements.

write
dadseo_run_sitemap_audit

Validate XML sitemaps and check URLs.

write
dadseo_run_technical_audit

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

write
dadseo_run_competitors_audit

Compare rankings and identify competitive gaps.

write
dadseo_run_geo_audit

Check visibility across Google AIO, ChatGPT, and Perplexity.

write
dadseo_run_content_intel

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

write
dadseo_run_hreflang_audit

Validate hreflang tags for international SEO.

write
dadseo_run_internal_links_audit

Analyze link structure, orphan pages, equity distribution.

write
dadseo_run_offpage_audit

Backlink profile, brand mentions, digital PR opportunities.

write
dadseo_generate_strategy_plan

Generate a Strategy Canvas using Rumelt's Strategy Kernel.

Analytics

read
dadseo_get_queries

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

read
dadseo_get_kpi

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

read
dadseo_get_stats

Aggregate dashboard statistics across all sites.

read
dadseo_list_pages

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

Topics

read
dadseo_get_topics

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

write
dadseo_run_topics

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

Rankings

read
dadseo_get_rankings

List tracked keywords and current ranking positions.

write
dadseo_add_tracked_keyword

Start tracking a keyword with optional target URL.

Monitoring

read
dadseo_list_alerts

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

read
dadseo_list_actions

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

write
dadseo_create_action

Create an SEO action task linked to audit findings.

write
dadseo_update_action

Update task status, priority, or title.

Examples

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

“Run a full SEO audit on my site”

The AI will call dadseo_list_sites to find your site, then dadseo_run_audit to start the audit, and poll dadseo_get_audit for results.

“What are my top performing keywords this month?”

Uses dadseo_get_queries with date range parameters and sorts by clicks.

“Check if my site appears on ChatGPT and Perplexity”

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

“Create action tasks from my latest audit findings”

Reads dadseo_get_audit for findings, then uses dadseo_create_action to create prioritized tasks.

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