SEO Intelligence MCP Server

Unified MCP Server for comprehensive SEO intelligence - Orchestrates DataForSEO, LocalFalcon, and SERPApi actors for AI assistant integration. Built by John Rippy | johnrippy.link

🏆 2025 Zapier Automation Hero of the Year — Project Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more →

---

Overview

This MCP (Model Context Protocol) Server provides a unified interface for AI assistants to access comprehensive SEO intelligence capabilities. It orchestrates multiple specialized Apify actors:

DataForSEO: SERP rankings, keyword research, on-page audits, backlink analysis
LocalFalcon: Local ranking grid scans
SERPApi: Real-time SERP snapshots

Available Tools

Input Parameters

Required for Production

apifyToken - Your Apify API token (for running sub-actors)
API credentials for the specific tool:
DataForSEO: dataForSeoLogin, dataForSeoPassword
LocalFalcon: localFalconApiKey
SERPApi: serpApiKey

Common Parameters

Example Usage

SERP Rankings Tracking

{
"tool": "serp_rankings",
"domain": "example.com",
"keywords": ["digital marketing", "seo services", "local seo"],
"location": "Saint Louis, MO",
"dataForSeoLogin": "your-login",
"dataForSeoPassword": "your-password",
"apifyToken": "your-apify-token"
}

Local Grid Scan

{
"tool": "local_grid_scan",
"toolInput": {
"businessName": "Joe's Plumbing",
"keyword": "plumber near me",
"gridSize": 9,
"radiusMiles": 10
},
"location": "Saint Louis, MO",
"localFalconApiKey": "your-localfalcon-key",
"apifyToken": "your-apify-token"
}

Real-Time SERP Snapshot

{
"tool": "realtime_serp",
"toolInput": {
"query": "best marketing agency",
"engine": "google",
"device": "mobile"
},
"location": "New York, NY",
"serpApiKey": "your-serpapi-key",
"apifyToken": "your-apify-token"
}

Full SEO Audit

{
"tool": "full_audit",
"domain": "example.com",
"location": "Chicago, IL",
"dataForSeoLogin": "your-login",
"dataForSeoPassword": "your-password",
"localFalconApiKey": "your-localfalcon-key",
"apifyToken": "your-apify-token"
}

Output Format

All tools return a standardized result format:

{
"tool": "serp_rankings",
"status": "success",
"timestamp": "2025-12-27T12:00:00.000Z",
"summary": "Tracked 5 keywords for example.com - Avg position: 4.2",
"data": {
// Tool-specific data
}
}

MCP Integration

This actor exposes MCP tools via the Key-Value Store:

// Fetch MCP tools definition
const kvStore = await client.keyValueStore(runId);
const mcpTools = await kvStore.getRecord('MCP_TOOLS');

// Get the latest result
const output = await kvStore.getRecord('OUTPUT');

Pricing

Pay-per-event pricing based on tool usage:

Demo Mode

Set demoMode: true to test with sample data without consuming API credits or running sub-actors.

Webhook Support

Configure webhookUrl to receive results via HTTP POST when the run completes. Perfect for Zapier, Make, or n8n integrations.

Related Actors

This MCP Server orchestrates these specialized actors:

localhowl~dataforseo-serp - SERP and keyword data
localhowl~dataforseo-onpage - On-page SEO audits
localhowl~dataforseo-backlinks - Backlink analysis
localhowl~localfalcon-grid - Local ranking grids
localhowl~serpapi-realtime - Real-time SERP snapshots

Support

GitHub: Report issues
LinkedIn: John Rippy
Website: johnrippy.link