SEO Tools

v1.0.0Marketing & SEOstable

Enables LLMs to interact with DataForSEO and other SEO APIs through natural language, allowing for keyword research, SERP analysis, backlink analysis, and local SEO tasks.

seo-tools-mcp-servermcpai-integration
Share:
77
Stars
0
Downloads
0
Weekly
0/5

What is SEO Tools?

SEO Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables llms to interact with dataforseo and other seo apis through natural language, allowing for keyword research, serp analysis, backlink analysis, and local seo tasks.

Enables LLMs to interact with DataForSEO and other SEO APIs through natural language, allowing for keyword research, SERP analysis, backlink analysis, and local SEO tasks.

This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables LLMs to interact with DataForSEO and other SEO APIs

Use Cases

Perform keyword research, SERP analysis, and backlink analysis.
Execute local SEO tasks through DataForSEO and other SEO APIs.
Skobyn

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 6, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx seo-tools-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SEO Tools

SEO Tools MCP Server is a TypeScript stdio MCP server that exposes the full DataForSEO API suite — and optionally Local Falcon — as MCP tools, enabling LLMs to perform comprehensive SEO research through natural language. It covers SERP analysis (Google, Bing, Yahoo), keyword research and volume data, DataForSEO Labs advanced analytics, backlink profiling, on-page website audits, domain analytics, content analysis, AI Optimization data from ChatGPT/Claude/Gemini/Perplexity, and local SEO grid searches via Local Falcon. Each API category is a separately filterable module, so you can expose only the subset of tools relevant to your workflow to avoid consuming excessive context window space with hundreds of tool definitions.

Prerequisites

  • Node.js and npm installed
  • A DataForSEO account with API credentials (login and password) — sign up at https://dataforseo.com
  • A Local Falcon API key (optional — only required for local SEO grid search features)
  • An MCP-compatible client such as Claude Desktop
  • The repository cloned locally (no published npm package — must build from source)
1

Clone the repository and install dependencies

Clone the dataforseo-mcp-server repository and install Node.js dependencies.

git clone https://github.com/Skobyn/dataforseo-mcp-server.git
cd dataforseo-mcp-server
npm install
2

Build the project

Compile the TypeScript source to JavaScript. The build output is what the MCP server actually runs.

npm run build
3

Set your DataForSEO credentials

Export your DataForSEO login and password as environment variables. These are used for API authentication on every request.

export DATAFORSEO_LOGIN="your_dataforseo_login"
export DATAFORSEO_PASSWORD="your_dataforseo_password"
4

Configure your MCP client

Add the SEO Tools server to your claude_desktop_config.json. Pass credentials as environment variables and optionally restrict which API modules are enabled to reduce context usage.

{
  "mcpServers": {
    "seo-tools": {
      "command": "node",
      "args": ["/path/to/dataforseo-mcp-server/build/index.js"],
      "env": {
        "DATAFORSEO_LOGIN": "your_login",
        "DATAFORSEO_PASSWORD": "your_password",
        "ENABLED_MODULES": "SERP,KEYWORDS_DATA,BACKLINKS,LABS"
      }
    }
  }
}
5

Optionally enable Local Falcon for local SEO

To enable local SEO grid search features, add your Local Falcon API key to the environment. This is completely optional.

export LOCALFALCON_API_KEY="your_localfalcon_api_key"
6

Restart Claude Desktop and run an SEO query

Restart your MCP client. The enabled DataForSEO tools will be available. Test with a keyword research or SERP analysis query.

SEO Tools Examples

Client configuration

MCP configuration limiting exposure to SERP, keyword research, backlinks, and Labs modules to reduce context usage.

{
  "mcpServers": {
    "seo-tools": {
      "command": "node",
      "args": ["/Users/you/dataforseo-mcp-server/build/index.js"],
      "env": {
        "DATAFORSEO_LOGIN": "your_dataforseo_login",
        "DATAFORSEO_PASSWORD": "your_dataforseo_password",
        "ENABLED_MODULES": "SERP,KEYWORDS_DATA,BACKLINKS,LABS"
      }
    }
  }
}

Prompts to try

Example SEO research prompts using the DataForSEO MCP tools.

- "Get Google organic search results for the query 'best project management software' and summarize the top 10 results"
- "What is the monthly search volume for the keyword 'mcp server' in the United States?"
- "Get keyword suggestions for the domain example.com from Google Ads"
- "Analyze the backlink profile for competitor.com — how many referring domains do they have?"
- "Run a Google Maps search for 'coffee shop near Times Square' and show me the local pack results"
- "What keywords is example.com ranking for according to DataForSEO Labs?"

Troubleshooting SEO Tools

API calls return 404 errors for specific endpoints

DataForSEO access is granted per module. A 404 on a known endpoint typically means that module is not enabled for your account, not a bug in the server. The server returns a 'DataForSEO module not enabled' message in this case. Log into the DataForSEO dashboard to enable the specific module, or use tools from modules that are already active on your account.

Too many tools are exposed and the LLM gets confused or context is exhausted

Use the ENABLED_MODULES environment variable to limit which API categories are registered as tools. Set it to a comma-separated list such as 'SERP,KEYWORDS_DATA' to expose only what you need. For even finer control, use ENABLED_TOOLS to specify individual tool names.

Authentication errors — 'Invalid credentials' or 401 responses

Verify DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD match the credentials shown in your DataForSEO account dashboard. These are your DataForSEO account login email and API password, not an API key — the API uses HTTP Basic Auth with these values.

Frequently Asked Questions about SEO Tools

What is SEO Tools?

SEO Tools is a Model Context Protocol (MCP) server that enables llms to interact with dataforseo and other seo apis through natural language, allowing for keyword research, serp analysis, backlink analysis, and local seo tasks. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SEO Tools?

Follow the installation instructions on the SEO Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with SEO Tools?

SEO Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SEO Tools free to use?

Yes, SEO Tools is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Marketing & SEO MCP Servers

Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "seo-tools-mcp-server": { "command": "npx", "args": ["-y", "seo-tools-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SEO Tools?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides