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 32 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

One-line install — prompts for your API key and registers the server for you:

Run in your terminal
curl -fsSL https://getdadseo.com/install.sh | bash

Or configure it manually:

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

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

write
dadseo_share_audit

Create a public share link for an audit's report — no login needed to view.

write
dadseo_unshare_audit

Revoke an audit's public share link.

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.

WebMCP Standard (Chrome 149+)

WebMCP (In-Browser Agents)

40 client-side tools across 4 domain categories. read = read-only, write = creates or modifies data.

In addition to our server-side MCP endpoint, DadSEO natively implements WebMCP — Chrome's proposed W3C web standard for exposing structured tools to in-browser AI agents (Gemini in Chrome, autonomous web agents, and assistive extensions) without brittle DOM scraping.

When viewing DadSEO in any WebMCP-capable browser, DadSEO automatically registers all 40 client-side tools into document.modelContext with full AbortSignal lifecycle management.

Core SEO & Strategy Audits

Full site crawl audits, strategy kernels, technical health, schema validation, sitemaps, and topical authority.

read
dadseo_quick_audit

Run a 30-second SEO eyeball audit on any webpage URL to evaluate title, meta, headings, content depth, and image alt text.

write
dadseo_run_full_audit

Run a comprehensive Rumelt Strategy Kernel audit on a registered site.

read
dadseo_get_audit

Retrieve completed audit results, diagnosis, and punch list findings.

write
dadseo_run_technical_audit

Run technical SEO audit covering Core Web Vitals, Crawlability, and Security Headers.

write
dadseo_run_schema_audit

Validate Schema.org structured data, detect rich snippet opportunities, and generate JSON-LD fixes.

write
dadseo_run_sitemap_audit

Audit XML sitemaps for syntax errors, orphan URLs, and indexation parity.

write
dadseo_run_topical_authority

Evaluate topical authority, semantic coverage, and entity depth.

write
dadseo_run_programmatic_audit

Detect programmatic template cannibalization and parameter collisions.

Specialized & Intelligence Audits

GEO / AI search visibility, brand sentiment, content intelligence, links, competitors, and international SEO.

write
dadseo_run_geo_audit

Audit GEO and AI-Search visibility across Google AIO, ChatGPT, Perplexity, and Claude.

read
dadseo_brand_lookup

Analyze AI search citation share and brand sentiment across LLM search engines.

write
dadseo_run_content_intel

Run JTBD customer journey mapping and query fan-out analysis.

write
dadseo_run_content_audit

Detect thin content, evaluate content depth, and score readability.

write
dadseo_run_link_audit

Audit internal link equity distribution, broken links, and orphan pages.

read
dadseo_get_backlinks

Retrieve backlink profile, referring domains, anchor text, and spam signals.

write
dadseo_run_competitor_audit

Run competitive gap analysis comparing keyword overlap, rankings, and topical coverage.

write
dadseo_run_local_audit

Audit local SEO signals, NAP consistency, and Google Business Profile factors.

write
dadseo_run_hreflang_audit

Validate international hreflang tags, reciprocal links, and language-region targeting.

write
dadseo_run_images_audit

Audit images for missing alt text, oversized dimensions, modern format support (WebP/AVIF), and lazy-loading.

write
dadseo_run_social_audit

Audit OpenGraph and Twitter Card metadata tags and preview snippets across social platforms.

Search Console & Keyword Intelligence

Direct Search Console metrics, keyword discovery, keyword difficulty, topic clustering, and rank tracking.

read
dadseo_get_gsc_queries

Retrieve Google Search Console queries, clicks, impressions, CTR, and average position.

read
dadseo_get_site_kpi

Retrieve 6-category KPI score snapshot (Visibility, Quality, Topical Authority, Engagement, Brand, Outcomes).

read
dadseo_list_pages

Retrieve crawled and discovered pages list with content grades and audit status.

read
dadseo_get_growth

Retrieve traffic velocity, inflection points, gainers, losers, and growth trend projections.

read
dadseo_keyword_ideas

Search for SEO keyword ideas, monthly search volume, competition level, and search intent from DadSEO.

read
dadseo_keyword_difficulty

Retrieve keyword difficulty score, search volume, CPC, and competitive ranking intensity.

write
dadseo_cluster_topics

Cluster GSC queries or keywords into semantic topic themes with search intent and difficulty.

read
dadseo_get_rankings

Retrieve tracked keyword rankings, current positions, target URLs, and search intent.

write
dadseo_add_tracked_keyword

Add a new keyword to continuous rank tracking with optional target URL.

Strategy Kernel, Actions & Assistant

Rumelt Strategy Kernel canvas, automated Kanban action punch list, content writing, AI chat assistant, and report sharing.

write
dadseo_generate_plan

Generate Rumelt Strategy Kernel (Diagnosis, Guiding Policy, Coherent Actions) for a site.

write
dadseo_generate_actions

Convert audit findings into prioritized actionable tasks on the Kanban board.

read
dadseo_list_actions

Retrieve Kanban tasks with status, priority, category, and affected URLs.

write
dadseo_update_action

Update task status (todo, in_progress, done), priority, title, or description.

read
dadseo_list_alerts

Retrieve active SEO alerts, ranking anomalies, and traffic inflection warnings.

read
dadseo_get_context

Retrieve unified site context, GSC performance, business profile, and audit summary for AI reasoning.

write
dadseo_create_site

Register a new site under the current account.

write
dadseo_update_site_context

Update a site's business context: rewrite grounding sections, add/remove competitors or key pages, or append a research-log entry.

write
dadseo_write_article

Draft an SEO-optimized article outline or full draft with keyword targets and intent.

write
dadseo_optimize_content

Analyze and optimize existing content for target keywords, readability, and topic coverage.

write
dadseo_assistant_chat

Send a conversational SEO query or strategy command to the DadSEO AI assistant.

write
dadseo_share_audit

Create or revoke a public share link for an audit report without requiring user login.

WebMCP Audit & Agentic SEO Detection

DadSEO crawlers automatically detect declarative WebMCP tool attributes (<form tool="...">) and Origin-Trial headers on your pages as an Agentic SEO readiness signal.

Enable WebMCP in Chrome (Experimental)
1. Navigate to chrome://flags/#enable-webmcp-testing in Chrome 149+
2. Set the flag to "Enabled" and relaunch
3. Open DevTools or an agent extension to inspect document.modelContext

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.