DataForSEO MCP server

This MCP server for SEO tools enables large language models to interact with DataForSEO APIs and other SEO tools, allowing you to perform keyword research, backlink analysis, SEO audits, and more through natural language interactions.

Installation

To get started with the SEO Tools MCP Server, follow these steps:

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

The server requires API credentials for the services you want to use. These are set through environment variables:

DataForSEO API (Required)

export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

Local Falcon API (Optional)

export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

Running the Server

Basic Usage (DataForSEO only)

# After setting environment variables
npm start

Full Integration (DataForSEO and Local Falcon)

# After setting all environment variables
npm start

Available Tools

The server provides access to numerous SEO-related tools across different categories:

SERP API Tools

These tools retrieve search engine results data:

• serp_google_organic_live - Get real-time Google organic search results
• serp_google_maps_live - Get Google Maps search results
• serp_google_organic_task_post - Create a Google organic search task

Keywords Data Tools

For keyword research and analysis:

• keywords_google_ads_search_volume - Get search volume for keywords
• keywords_google_ads_keywords_for_site - Get keyword suggestions for a domain
• keywords_google_trends_explore - Explore keyword trends over time

Backlinks Tools

For analyzing backlink profiles:

• backlinks_summary - Get a summary of a domain's backlink profile
• backlinks_backlinks - Get a list of backlinks for a domain
• backlinks_referring_domains - Get referring domains for a target

Local Falcon Tools

When configured with Local Falcon API:

• localfalcon_calculate_grid_points - Calculate grid points around a base coordinate
• localfalcon_search_gmb_locations - Search for Google My Business locations
• localfalcon_get_ranking_at_coordinate - Get business ranking at specific coordinate
• localfalcon_run_grid_search - Run a full grid search for local rankings

Integration with LLMs

This server implements the Model Context Protocol (MCP), making it compatible with LLMs like Claude. The basic integration flow:

1. Start the MCP server with your API credentials
2. Connect to it from your LLM platform according to their MCP implementation
3. Use natural language to request SEO data, which gets translated into API calls
4. Receive and analyze the results

For specific integration examples, refer to the examples directory in the repository.

Example Usage Scenarios

Keyword Research

Use the keywords_google_ads_search_volume tool to get search volumes for a list of keywords or the labs_google_keyword_ideas tool to generate keyword ideas based on seed terms.

Competitor Analysis

Combine labs_google_domain_rank_overview with backlinks_summary to get a comprehensive view of a competitor's SEO profile.

Local SEO Analysis

With Local Falcon integration, use localfalcon_run_grid_search to analyze local ranking performance across a geographic area.

Technical SEO Audit

Use the OnPage API tools to identify technical issues affecting a website's SEO performance.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.