Skip to main content
Glama
SE Ranking MCP Server

SE Ranking MCP Server

by TeamDay-AI

SE Ranking MCP Server

This Model Context Protocol (MCP) server connects AI assistants to SE Ranking's SEO data and project management APIs. It enables natural language queries for:

  • Keyword research and competitive analysis

  • Backlink analysis and monitoring

  • Domain traffic and ranking insights

  • Website audits and technical SEO

  • AI search visibility tracking

  • Project and rank tracking management

Prerequisites

Before you begin, please ensure you have the following software and accounts ready:

  • SE Ranking Account: You will need an active SE Ranking account to generate an API token. If you don’t have one, you can sign up here.

  • Docker: A platform for developing, shipping, and running applications in containers. If you don’t have it, you can download it from the official Docker website.

  • Git: A free and open-source distributed version control system. You can download it from the official Git website.

  • AI Assistant: You will need an MCP-compatible client, such as Claude Desktop or the Gemini CLI.

Related MCP server: DataForSEO MCP Server

API Tokens

This MCP server supports two types of API access:

Token

Environment Variable

Format

Purpose

Data API

DATA_API_TOKEN

UUID (e.g., 80cfee7d-xxxx-xxxx-xxxx-fc8500816bb3)

Access to keyword research, domain analysis, backlinks data, SERP analysis, and website audits. Tools prefixed with DATA_.

Project API

PROJECT_API_TOKEN

40-char hex (e.g., 253a73adxxxxxxxxxxxx340aa0a939)

Access to project management, rank tracking, backlink monitoring, and account management. Tools prefixed with PROJECT_.

Get your tokens from: https://online.seranking.com/admin.api.dashboard.html

You can use one or both tokens depending on which tools you need. If you only use Data API tools, you can omit PROJECT_API_TOKEN, and vice versa.

Rate Limits

API

Default Rate Limit

Data API

10 requests per second

Project API

5 requests per second

Rate limits are customizable. Contact api@seranking.com to request adjustments.

Installation

Choose the installation method that best fits your needs:

  • Option 1: Docker (Recommended) - Best for standard usage, stability, and ease of updates. Use this if you just want to run the tool without managing dependencies.

  • Option 2: Local Node.js Server (For Developers) - Best for development, debugging, or environments where Docker isn't available (like Replit). Use this if you need to modify the code or run a custom setup.

  1. Open your terminal (or Command Prompt/PowerShell on Windows).

  2. Clone the project repository from GitHub:

git clone https://github.com/seranking/seo-data-api-mcp-server.git
  1. Navigate into the new directory:

cd seo-data-api-mcp-server
  1. Build the Docker Image:

docker build -t se-ranking/seo-data-api-mcp-server .
# Check that the image is built and named `se-ranking/seo-data-api-mcp-server`:
docker image ls

How to Update SEO-MCP (Docker)

To ensure you have the latest features, pull the latest changes and rebuild:

git pull origin main
docker build -t se-ranking/seo-data-api-mcp-server .

Option 2: Local Node.js Server (For Developers)

In order to run the local Node server, you need to have Node.js 20+ version installed on your machine.

  1. Install dependencies:

npm install
  1. Build the project:

npm run build
  1. Start the server:

npm run start-http

Then your HTTP server should be running at: http://0.0.0.0:5000/mcp.

In case you'd like to modify the HOST and PORT, you can do so by creating a .env file in the root directory of the project with the settings you want to override, for example:

HOST=127.0.0.1
PORT=5555

Additionally, when running in external environments like Replit, you can set the DATA_API_TOKEN and PROJECT_API_TOKEN environment variables in the configuration panel.

Note: If you change the API token values when the server is running, you need to restart the server.

Verifying the HTTP Server

To send a sample test request and verify your setup:

./test-http-server-curl-request.sh '<your-api-token-here>'

For batch MCP Requests testing:

./test-batch-http-server-curl-request.sh '<your-api-token-here>'

Connect to Claude Desktop

Claude Desktop reads its configuration from claude_desktop_config.json.

  • Click on the Claude menu and select Settings....

  • In the Settings window, navigate to the Developer tab in the left sidebar.

  • Click the Edit Config button to open the configuration file. This action creates a new configuration file if one doesn’t exist or opens your existing configuration.

The file is located at:

  • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  • Windows: %AppData%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Example of Claude Desktop configuration for MCP server

JSON Configuration Template:

{
  "mcpServers": {
    "seo-data-api-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATA_API_TOKEN",
        "-e",
        "PROJECT_API_TOKEN",
        "se-ranking/seo-data-api-mcp-server"
      ],
      "env": {
        "DATA_API_TOKEN": "<your-data-api-token-here>",
        "PROJECT_API_TOKEN": "<your-project-api-token-here>"
      }
    }
  }
}
  • Replace the DATA_API_TOKEN and PROJECT_API_TOKEN placeholder values with your tokens (see API Tokens section).

  • After saving claude_desktop_config.json, restart Claude Desktop. You should see the server under MCP Servers/Tools.

  • To verify the setup, ask Claude: Do you have access to MCP? It should respond by listing seo-data-api-mcp.

Claude Desktop: Verify the MCP access

  • Your setup is complete! You can now run complex SEO queries using natural language.

Claude Desktop: List MCP Servers

Connect to Gemini CLI

  • Open the Gemini CLI settings file, which is typically located at: ~/.gemini/settings.json

  • Add the following JSON configuration, making sure to replace the API token placeholder values.

{
  "mcpServers": {
    "seo-data-api-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATA_API_TOKEN",
        "-e",
        "PROJECT_API_TOKEN",
        "se-ranking/seo-data-api-mcp-server"
      ],
      "env": {
        "DATA_API_TOKEN": "<your-data-api-token-here>",
        "PROJECT_API_TOKEN": "<your-project-api-token-here>"
      }
    }
  }
}

Replace the DATA_API_TOKEN and PROJECT_API_TOKEN placeholder values with your tokens (see API Tokens section).

  • Save the configuration file.

  • To verify the setup, launch the Gemini CLI by running gemini in your terminal. Once the interface is active, press Ctrl+T to view the available MCP servers. Ensure seo-data-api-mcp is listed.

Gemini CLI: Configured MCP Servers

  • Your setup is complete! You can now run complex SEO queries using natural language.

Gemini CLI: SEO Queries Example

Available Tools

Data API Tools

Module

Tool Name

Description

account

DATA_getCreditBalance

Get current Data API credit balance and plan details.

account

DATA_getSubscription

Get information about the current Data API subscription.

SERP

DATA_getSerpHtmlDump

Retrieves the raw HTML dump of a completed SERP task as a ZIP file (returned as an MCP embedded resource, application/zip).

SERP

DATA_getSerpLocations

Retrieves a list of available locations for SERP analysis.

SERP

DATA_getSerpResults

Runs a SERP query and returns results. Creates task, polls until complete, and returns organic/ads/featured snippets (standard) or all SERP types including AI Overview, Maps, Reviews (advanced).

SERP

DATA_getSerpTaskAdvancedResults

Retrieves the status or advanced results of a specific SERP task.

SERP

DATA_getSerpTaskResults

Retrieves the status or standard results of a specific SERP task. Returns organic, ads, and featured_snippet types only.

SERP

DATA_getSerpTasks

Retrieves a list of all SERP tasks added to the queue in the last 24 hours.

ai search

DATA_getAiDiscoverBrand

Identifies and returns the brand name associated with a given target domain, subdomain, or URL.

ai search

DATA_getAiOverview

Retrieves a high-level overview of a domain's performance in AI search engines.

ai search

DATA_getAiOverviewLeaderboard

Returns the AI Overview visibility leaderboard for a market — which domains appear most often in AI-search answers for tracked prompts.

ai search

DATA_getAiPromptsByBrand

Retrieves a list of prompts where the specified brand is mentioned in AI search results.

ai search

DATA_getAiPromptsByTarget

Retrieves a list of prompts (queries) that mention the specified target in AI search results.

backlinks

DATA_exportBacklinksData

Retrieves large-scale backlinks asynchronously, returning a task ID to check status later.

backlinks

DATA_getAllBacklinks

Retrieves a comprehensive list of backlinks for the specified target, with extensive filtering and sorting options.

backlinks

DATA_getBacklinksAnchors

Retrieves a list of anchor texts for backlinks pointing to the specified target.

backlinks

DATA_getBacklinksAuthority

Fetch authority metrics for a target (domain, host or URL).

backlinks

DATA_getBacklinksCount

Returns the total number of backlinks for the target. Supports batch requests.

backlinks

DATA_getBacklinksExportStatus

Checks the status of an asynchronous backlinks export task. Returns download URL when complete.

backlinks

DATA_getBacklinksIndexedPages

Fetch site pages that have backlinks, with sorting and limit controls.

backlinks

DATA_getBacklinksMetrics

Returns key statistics for a target (backlinks count, referring domains, etc.). Supports batch requests.

backlinks

DATA_getBacklinksRaw

Returns all backlinks pointing to a target using cursor-based pagination for large datasets.

backlinks

DATA_getBacklinksRefDomains

Retrieves a list of referring domains pointing to the specified target.

backlinks

DATA_getBacklinksSummary

Retrieves a summary of backlink metrics for one or multiple targets.

backlinks

DATA_getCumulativeBacklinksHistory

Returns live backlinks count for every day within the specified date range.

backlinks

DATA_getDistributionOfDomainAuthority

Returns distribution of Domain InLink Rank of all domains referencing a target.

backlinks

DATA_getDomainAuthority

Returns the domain InLink Rank (Domain Authority) of the target page's root domain.

backlinks

DATA_getDomainAuthorityHistory

Returns the historical time-series of domain InLink Rank for a target domain.

backlinks

DATA_getNewLostBacklinksCount

Returns count of (newly) found or lost backlinks for every day in the date range.

backlinks

DATA_getNewLostRefDomainsCount

Returns count of referring domains found or lost in the date range, by day.

backlinks

DATA_getPageAuthority

Returns the InLink Rank (Page Authority) for a target URL.

backlinks

DATA_getPageAuthorityHistory

Returns historical values of InLink Rank for a specific target page.

backlinks

DATA_getReferringIps

Returns IPv4 addresses that belong to backlinks pointing to a target.

backlinks

DATA_getReferringIpsCount

Returns the number of unique IPs linking to a target.

backlinks

DATA_getReferringSubnetsCount

Returns the number of unique subnets/C-blocks linking to a target.

backlinks

DATA_getTotalRefDomainsCount

Returns the number of unique domains linking to a target. Supports batch requests.

backlinks

DATA_listNewLostBacklinks

Returns a list of backlinks found or lost within the specified date range.

backlinks

DATA_listNewLostReferringDomains

Returns referring domains found or lost in the specified date range.

domain analysis

DATA_getDomainAdsByDomain

Retrieves paid ads for a specific domain.

domain analysis

DATA_getDomainAdsByKeyword

Retrieves paid ads for a specific keyword.

domain analysis

DATA_getDomainCompetitors

Retrieves up to 500 organic or paid competitors for a target domain, sorted by shared keyword count.

domain analysis

DATA_getDomainKeywords

Retrieves keywords for which a domain ranks in organic or paid search.

domain analysis

DATA_getDomainKeywordsComparison

Compares keyword rankings of two websites. Find common keywords or keyword gaps.

domain analysis

DATA_getDomainOverviewDatabases

Fetch domain overview by database.

domain analysis

DATA_getDomainOverviewHistory

Retrieves historical data for domain traffic and keyword rankings.

domain analysis

DATA_getDomainOverviewWorldwide

Retrieves an aggregated worldwide overview of domain metrics.

domain analysis

DATA_getDomainPages

Retrieves a list of individual pages ranking within a specified domain.

domain analysis

DATA_getDomainSubdomains

Retrieves a list of subdomains for a domain with search performance metrics.

domain analysis

DATA_getUrlOverviewWorldwide

Retrieves worldwide overview of organic and paid traffic metrics for a specific URL.

keyword research

DATA_exportKeywords

Retrieves metrics for a bulk list of keywords.

keyword research

DATA_getKeywordQuestions

Retrieves question-based keywords containing the seed keyword.

keyword research

DATA_getLongTailKeywords

Retrieves long-tail variations for the seed keyword.

keyword research

DATA_getRelatedKeywords

Retrieves keywords semantically related to the seed keyword.

keyword research

DATA_getSimilarKeywords

Retrieves keywords similar to the seed keyword.

website audit

DATA_createAdvancedAudit

Launches an advanced website audit that renders JavaScript. Suitable for SPAs.

website audit

DATA_createStandardAudit

Launches a standard website audit that crawls HTML. Suitable for static sites.

website audit

DATA_deleteAudit

Permanently deletes a website audit report and all associated data.

website audit

DATA_getAuditHistory

Retrieves a historical snapshot of a specific audit run.

website audit

DATA_getAuditPagesByIssue

Retrieves URLs affected by a specific issue within an audit.

website audit

DATA_getAuditReport

Retrieves the full detailed report for a completed website audit.

website audit

DATA_getAuditStatus

Checks the real-time status of a specific website audit.

website audit

DATA_getCrawledPages

Returns all URLs found during an audit.

website audit

DATA_getFoundLinks

Returns every hyperlink discovered during the audit.

website audit

DATA_getIssuesByUrl

Retrieves all issues found on a specific page within an audit.

website audit

DATA_listAudits

Retrieves all website audits associated with your account.

website audit

DATA_recheckAudit

Launches a new crawl of a previously completed audit.

website audit

DATA_updateAuditTitle

Changes the title of an existing website audit report.

Project API Tools

Module

Tool Name

Description

account

PROJECT_getUserProfile

Get information about the currently logged in user.

AIRT — brands

PROJECT_getSiteBrand

Get the brand name configured for an AI Result Tracker site.

AIRT — brands

PROJECT_saveSiteBrand

Set the brand name for an AI Result Tracker site.

AIRT — llm engines

PROJECT_createLlmEngine

Add an LLM engine (e.g. ChatGPT, Perplexity, Google AI Overview, Gemini) for an AIRT site.

AIRT — llm engines

PROJECT_deleteLlmEngine

Remove an LLM engine from an AIRT site.

AIRT — llm engines

PROJECT_getLlmEngine

Get configuration of a specific LLM engine.

AIRT — llm engines

PROJECT_getLlmStatistics

Get AIRT engine statistics (prompt hits, brand mentions) for a site.

AIRT — llm engines

PROJECT_getLlmStatus

Get real-time status of LLM answer generation for an AIRT site.

AIRT — llm engines

PROJECT_listLlmEngines

List all LLM engines configured for an AIRT site.

AIRT — llm engines

PROJECT_updateLlmEngine

Partial update of an LLM engine (region_name, lang_code).

AIRT — prompts

PROJECT_addPrompts

Add a batch of tracked prompts to an AIRT prompt group.

AIRT — prompts

PROJECT_deletePrompts

Delete specific tracked prompts.

AIRT — prompts

PROJECT_getPromptAnswer

Get the full LLM answer captured for a specific tracked prompt.

AIRT — prompts

PROJECT_getPromptsRankings

Get ranking statistics (brand mentions, competitor mentions) for tracked prompts.

AIRT — prompts

PROJECT_listPrompts

List tracked prompts for an AIRT site, optionally filtered by prompt group.

AIRT — prompt groups

PROJECT_changePromptGroupOrder

Reorder prompt groups within an AIRT site.

AIRT — prompt groups

PROJECT_createPromptGroup

Create a new prompt group for an AIRT site.

AIRT — prompt groups

PROJECT_deleteAllPromptsInGroup

Delete all prompts inside a specified prompt group.

AIRT — prompt groups

PROJECT_deletePromptGroup

Delete a prompt group.

AIRT — prompt groups

PROJECT_listPromptGroups

List all prompt groups for an AIRT site.

AIRT — prompt groups

PROJECT_movePromptsBetweenGroups

Move prompts from one group to another.

AIRT — prompt groups

PROJECT_movePromptsToGroup

Move selected prompts into a specified group.

AIRT — prompt groups

PROJECT_updatePromptGroup

Rename a prompt group.

analytics

PROJECT_getGoogleSearchConsole

Get popular queries from Google Search Console for a website.

analytics

PROJECT_getSeoPotential

Assess potential traffic volume, traffic cost, and potential customers for a website.

backlink checker

PROJECT_addDisavowedBacklinks

Add a list of URLs to the disavowed backlinks list.

backlink checker

PROJECT_addProjectBacklink

Add a single backlink to the backlink monitor for a website.

backlink checker

PROJECT_createBacklinkGroup

Create a new group for organizing backlinks.

backlink checker

PROJECT_deleteBacklinkGroup

Delete a backlink group.

backlink checker

PROJECT_deleteDisavowedBacklink

Remove a backlink from the disavowed backlinks list.

backlink checker

PROJECT_deleteProjectBacklinks

Delete a list of backlinks from the backlink monitor.

backlink checker

PROJECT_getBacklinkGscImportStatus

Get the status of a backlink import from Google Search Console.

backlink checker

PROJECT_getBacklinkStats

Get backlink statistics for a website.

backlink checker

PROJECT_importProjectBacklinks

Import a list of backlinks to the backlink monitor.

backlink checker

PROJECT_listBacklinkGroups

Get a list and count of backlink groups for a website.

backlink checker

PROJECT_listDisavowedBacklinks

Get a list and count of disavowed backlinks for a website.

backlink checker

PROJECT_listProjectBacklinks

Get a list of backlinks from the backlink monitor.

backlink checker

PROJECT_moveBacklinksToGroup

Move backlinks from one group to another.

backlink checker

PROJECT_recheckProjectBacklinks

Run an index or status check for a list of backlinks.

backlink checker

PROJECT_renameBacklinkGroup

Change the name of a backlink group.

backlink checker

PROJECT_runBacklinkGscImport

Start a backlink import from Google Search Console.

backlink checker

PROJECT_updateBacklinkImportSettings

Update settings for automatic backlink import from GSC.

competitors

PROJECT_addCompetitor

Add a competitor website to a project for position tracking.

competitors

PROJECT_deleteCompetitor

Remove a competitor website from a project.

competitors

PROJECT_getAllCompetitorsMetrics

Get data on sites ranked in TOP 10 for tracked queries (14-day history).

competitors

PROJECT_getCompetitorPositions

Get statistics on competitor keyword positions.

competitors

PROJECT_getCompetitorTop10

Get TOP 10 results for tracked keywords in a project.

competitors

PROJECT_getCompetitorTop100

Get top 100 results for tracked keywords in a project.

competitors

PROJECT_listCompetitors

Get a list of all competitors added to a project with statistics.

keyword groups

PROJECT_createKeywordGroup

Add a group for project keywords.

keyword groups

PROJECT_deleteKeywordGroup

Delete a project keyword group.

keyword groups

PROJECT_listKeywordGroups

Get a list of keyword groups for a project.

keyword groups

PROJECT_moveKeywordsToGroup

Transfer project keywords from one group to another.

keyword groups

PROJECT_updateKeywordGroup

Update the name of a project keyword group.

marketing plan

PROJECT_addPlanTask

Add a new task to the marketing plan for a website.

marketing plan

PROJECT_deletePlanTask

Delete a task from the marketing plan.

marketing plan

PROJECT_listPlanItems

Get all marketing plan sections, items, and notes for a website.

marketing plan

PROJECT_setPlanTaskStatus

Set the completion status of a marketing plan task.

marketing plan

PROJECT_updatePlanTask

Update an existing marketing plan task.

project groups

PROJECT_createProjectGroup

Add a new project group to a user account.

project groups

PROJECT_deleteProjectGroup

Delete a project group.

project groups

PROJECT_listProjectGroups

Get a list of all project groups from a user account.

project groups

PROJECT_moveProjectsToGroup

Transfer projects from one group to another.

project groups

PROJECT_updateProjectGroup

Rename a project group.

project management

PROJECT_addKeywords

Add new keywords to a project.

project management

PROJECT_addSearchEngine

Add a new search engine to a project.

project management

PROJECT_createProject

Add a new project to the user account.

project management

PROJECT_deleteKeywords

Delete keywords from a project.

project management

PROJECT_deleteProject

Delete a project from the user account.

project management

PROJECT_deleteSearchEngine

Delete a search engine from a project.

project management

PROJECT_getAdsStats

Get total number of top and bottom advertisements by day.

project management

PROJECT_getHistoricalDates

Returns standard comparison dates available for reporting.

project management

PROJECT_getChart

Get daily visibility / average-position / keywords-in-top-N time-series for a project, suitable for charts.

project management

PROJECT_getCheckDates

Get the list of dates on which position checks were run for a project.

project management

PROJECT_getKeywordStats

Get keyword ranking statistics for a specified time period.

project management

PROJECT_getSearchEngines

Get a list of search engines employed by a project.

project management

PROJECT_getSummary

Get a project's summary statistics.

project management

PROJECT_listKeywords

Get a list of keywords with target pages for a project.

project management

PROJECT_listProjects

Get a list of all user projects.

project management

PROJECT_runPositionCheck

Run a ranking position check for keywords or entire project.

project management

PROJECT_setKeywordPosition

Manually set position for a project's keyword.

project management

PROJECT_updateKeyword

Update keyword settings (target URL, tags, group) for a project keyword.

project management

PROJECT_updateProject

Change/update project settings.

project management

PROJECT_updateSearchEngine

Update an existing search engine in a project.

sub-accounts

PROJECT_createSubAccount

Create a new sub-account.

sub-accounts

PROJECT_deleteSubAccount

Delete a user sub-account.

sub-accounts

PROJECT_getSubAccountDetails

Get extended information about a sub-account.

sub-accounts

PROJECT_listOwnedProjects

Get website IDs that belong to a sub-account.

sub-accounts

PROJECT_listSharedProjects

Get website IDs shared with a sub-account.

sub-accounts

PROJECT_listSubAccounts

Get a list of all sub-accounts of the current user.

sub-accounts

PROJECT_shareProject

Share one or more websites with a sub-account.

sub-accounts

PROJECT_updateSubAccount

Edit sub-account settings, limits, and permissions.

system

PROJECT_getAvailableRegions

Get the list of all available regions supported by Google.

system

PROJECT_getAvailableSearchEngines

Get the list of all available search engines.

system

PROJECT_getGoogleLanguages

Get a complete list of possible languages for Google search engine.

system

PROJECT_getSearchVolume

Get search volume data for a region and keyword list (max 10 keywords).

system

PROJECT_getVolumeRegions

Get regions where SE Ranking can run keyword search volume checks.

url tags

PROJECT_addTag

Add a tag to the site and attach it to a link and/or domain.

url tags

PROJECT_deleteTag

Delete a tag.

url tags

PROJECT_listTags

Get a list of landing page tags added to domains and/or links.

url tags

PROJECT_updateTag

Add tags to a domain and/or link, replacing previously added tags.

website audit

PROJECT_createAudit

Launch a website audit for a domain with full settings (crawl sources, limits, thresholds, schedule, disabled_issues, disallow_ext).

website audit

PROJECT_listAudits

List all website audits for the account with pagination, search, and date filters.

website audit

PROJECT_getAuditStatus

Real-time status of a specific audit (queued, processing, finished, cancelled, expired).

website audit

PROJECT_getAuditReport

Full detailed report for a completed audit — health score, domain properties, section-by-section breakdown.

website audit

PROJECT_getCrawledPages

Paginated list of all URLs found during the audit.

website audit

PROJECT_getAuditPagesByIssue

Paginated list of URLs affected by a specific issue within an audit.

website audit

PROJECT_getIssuesByUrl

All issues (errors, warnings, notices) found on a specific page within an audit.

website audit

PROJECT_getFoundLinks

Every hyperlink discovered during the audit, with filtering.

website audit

PROJECT_getAuditHistory

Historical snapshot of a specific audit run by date.

website audit

PROJECT_updateAuditTitle

Change an audit's title (backward-compatible /audit/{id}/edit).

website audit

PROJECT_getAuditSettings

Read current settings for an existing audit — required before partial updates and for modifying disabled_issues.

website audit

PROJECT_updateAuditSettings

Partial-update an audit's settings (title, settings object, schedule, disabled_issues). disabled_issues / schedule_wdays are replace operations.

website audit

PROJECT_resetAuditSettings

Reset all audit settings to defaults. Does not remove sitemaps / source-pages lists.

website audit

PROJECT_listAuditSitemaps

List sitemap URLs configured as crawl sources for an audit.

website audit

PROJECT_addAuditSitemap

Add a sitemap URL as a crawl source. Auto-enables source_sitemap.

website audit

PROJECT_deleteAuditSitemap

Remove a sitemap from an audit's crawl sources.

website audit

PROJECT_listAuditSourcePages

List uploaded custom-page URL lists used as a crawl source.

website audit

PROJECT_addAuditSourcePages

Upload a custom list of pages (one URL per line) to crawl. Auto-enables source_file.

website audit

PROJECT_deleteAuditSourcePages

Remove an uploaded source-pages list from an audit.

website audit

PROJECT_recheckAudit

Launch a new crawl of a previously completed audit with the same settings.

website audit

PROJECT_deleteAudit

Permanently delete an audit and all associated data.

Available Prompts

Prompt Name

Arguments

Description

serp-analysis

keyword, location1, location2, language, device

Create two SERP tasks for the query in two locations and compare top 10 organic domains, overlap, and unique competitors.

backlink-gap

my_domain, competitors, min_domain_trust

Fetch backlinks for competitors with a minimum Domain Trust, compare against your domain, and find opportunities.

domain-traffic-competitors

domain

Analyze a domain's global/country organic traffic, top competitors by shared keywords, and provide strategic recommendations.

keyword-clusters

market, seed_keywords

Pull related/similar keywords for a market, clean/deduplicate, and cluster them by intent/theme with volume and H1/H2 ideas.

ai-share-of-voice

domain, competitors, country, llm_engines

Estimate share of voice in AI search (e.g. ChatGPT, Perplexity) vs competitors, listing winning topics and gap-closing actions.

Usage Example: Finding Keyword Opportunities

With the configuration complete, you can now use natural language prompts to interact with your SE Ranking data. Here is an example prompt to identify low-hanging keyword opportunities for a domain.

Copy and paste the following into your configured AI assistant:

Use the seo-mcp to identify the Keywords my domain is overlooking and find low-hanging fruit opportunities.
1. Analyze my domain's keyword performance:
   - Find keywords my domain has lost (not ranking) using the tool for getDomainKeywords with pos_change=lost.
   - Find keywords where my domain's position has gone down using the tool for getDomainKeywords with pos_change=down.
2. Conduct a competitive analysis:
   - Identify my top 2 competitors by finding all competitors with the tool for getDomainCompetitors and ordering them by common_keywords DESC.
   - Find 30 keywords that these competitors are ranking for but my domain is not. Use the getDomainKeywordsComparison tool with diff=1, order_field=volume, and order_type=DESC.
3. Identify new keyword opportunities:
   - For 10 of the competitor keywords found in the previous step, use the tools for getRelatedKeywords and getSimilarKeywords to find the top 5 related and similar keywords for each, ordered by volume DESC.
4. Synthesize and Report:
   - Create a final report of the findings. In the report, highlight potential low-hanging fruit from the new keyword opportunities by analyzing their CPC and keyword difficulty.
Domain to review: seranking.com
Market: us

What This Prompt Does

This prompt instructs the model to perform a comprehensive competitive analysis by:

  • Finding Lost & Declining Keywords: It first identifies keywords for seranking.com that have either been lost from the rankings or have dropped in position.

  • Identifying Top Competitors: It finds all organic competitors and sorts them to identify the top two based on the number of shared keywords.

  • Uncovering Competitor-Ranked Keywords: It compares seranking.com against its top competitors to find 30 high-volume keywords that they rank for, but seranking.com does not.

  • Generating a Final Report: Finally, it synthesizes all of this information into a concise report, highlighting the most promising opportunities for growth.

Troubleshooting

Docker image problems

If you’re having trouble getting the MCP server to connect, here are a few steps to diagnose the issue.

Verifying if the Docker container is running when you run your AI Assistant (Claude or Gemini). If you start a chat with an AI, and your MCP Server is set up properly via JSON config, it should automatically start the Docker container.

To check if it’s running, open your terminal and run:

docker ps

If it’s working correctly, you will see an output similar to this:

CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS     NAMES
de4e410ef0fd   se-ranking/seo-data-api-mcp-server       "docker-entrypoint.s…"   9 seconds ago    Up 8 seconds              musing_bhabha

This confirms that your AI assistant has successfully started the container, and it’s listening for connections.

If docker ps shows no running containers related to the MCP server, it usually points to a configuration issue:

  • Incorrect/invalid JSON: Double-check the claude_desktop_config.json or settings.json for any syntax errors like missing commas or brackets. You can validate the JSON here: https://jsonlint.com/.

  • Incorrect image name: Double-check the claude_desktop_config.json or settings.json for the correct image name se-ranking/seo-data-api-mcp-server

Docker image running, but MCP server is not visible in Claude Desktop / Gemini CLI

If the docker image is running, but the MCP server is not visible in Claude Desktop, you can investigate the container by:

docker inspect <container-id>

For the following example, the container ID is de4e410ef0fd:

CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS     NAMES
de4e410ef0fd   se-ranking/seo-data-api-mcp-server       "docker-entrypoint.s…"   9 seconds ago    Up 8 seconds              musing_bhabha

Note: you can shorten the container ID in case no other containers share that prefix, ex. docker inspect de4. When you're running multiple AI chats and/or tools connected to the MCP Servers, there can be multiple containers running, but all with the same IMAGE name.

This will show you the big JSON output, where particularly important is the "Config" section, ex.:

{
  "Config": {
    "Hostname": "0977c3dc06fb",
    "Domainname": "",
    "User": "",
    "AttachStdin": true,
    "AttachStdout": true,
    "AttachStderr": true,
    "Tty": false,
    "OpenStdin": true,
    "StdinOnce": true,
    "Env": [
      "DATA_API_TOKEN=80cfee7d-xxxx-xxxx-xxxx-fc8500816bb3",
      "PROJECT_API_TOKEN=253a73adxxxxxxxxxxxxxx340aa0a939",
      "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
      "NODE_VERSION=20.19.5",
      "YARN_VERSION=1.22.22",
      "NODE_ENV=production"
    ]
  }
}

Which shows you if you have the correct environment variables set.

Contributing

Prerequisites

  • Node.js 20+

  • npm

Running Tests

# Run all tests (compiles TypeScript first)
npm test

# Run only E2E tests
npm run test:e2e

# Run tests in watch mode
npm run test:watch

Environment Variables for Testing

Create a .env file in the project root with the following variables:

Variable

Required

Description

DATA_API_TOKEN

Yes

API token for Data API tools

PROJECT_API_TOKEN

Yes

API token for Project API tools

E2E_ENABLED

No

Set to true to enable E2E tests

GEMINI_E2E_ENABLED

No

Set to true to enable Gemini assistant tests

E2E Tests

E2E tests make real API calls to SE Ranking services. They are disabled by default to avoid unnecessary API usage during development.

  • When E2E_ENABLED=false or unset, E2E tests are skipped

  • Set E2E_ENABLED=true to run the full test suite with live API calls

  • Ensure you have valid API tokens before enabling E2E tests

Other Development Commands

# Lint code
npm run lint
npm run lint:fix

# Format code
npm run format
npm run format:check

# Type check
npm run typecheck

Support

SE Ranking API documentation: https://seranking.com/api/integrations/mcp/.

In case you have any questions or need help, please contact us at api@seranking.com

Available Tools

100 tools
DATA_createAdvancedAuditCreate Advanced AuditA

Data Tool: Launches an advanced website audit that renders JavaScript before analyzing the page. Suitable for Single-Page Applications (SPAs) or dynamic content.

Inputs: domain (required), title, settings.

DATA_createStandardAuditCreate Standard AuditA

Data Tool: Launches a standard website audit that crawls the HTML of a website. Suitable for most static and server-side rendered sites.

Inputs: domain (required), title, settings.

DATA_deleteAuditDelete AuditA

Data Tool: Permanently deletes a specified website audit report and all of its associated data.

Inputs: audit_id (required).

DATA_exportBacklinksDataExport Backlinks DataB

Data Tool: Retrieves large-scale backlinks asynchronously, returning a task ID to check status later.

Inputs: target (required), mode.

DATA_exportKeywordsExport Keywords MetricsC

Data Tool: Retrieves metrics for a bulk list of keywords.

Inputs: source (required), keywords (required), cols, sort, +1 more.

DATA_getAiDiscoverBrandAI Search Discover BrandA

Data Tool: Identifies and returns the brand name associated with a given target domain, subdomain, or URL. Useful for determining what brand name to use in other AI search queries.

Inputs: source (required), target (required), scope.

DATA_getAiOverviewAI Search Overview (SE Ranking)A

Data Tool: Retrieves a high-level overview of a domain's performance in AI search engines. Returns aggregated data if no engine is specified, or engine-specific data if an engine is provided.

Inputs: source (required), target (required), brand, scope, +1 more.

DATA_getAiOverviewLeaderboardAI Search Comparison & Leaderboard (SE Ranking)A

Data Tool: Compare multiple domains/brands in AI search engines (ChatGPT, Perplexity, Gemini, AI Overview, AI Mode). Use this for AI search comparison, competitor analysis, and visibility benchmarking. Returns brand presence, link presence, share of voice rankings, and leaderboard for each domain across AI engines.

Inputs: source (required), engines (required), primary (required), competitors (required), +1 more.

DATA_getAiPromptsByBrandAI Search: Get Prompts by Brand (SE Ranking)B

Data Tool: Retrieves a list of prompts where the specified brand is mentioned in AI search results.

Inputs: brand (required), engine (required), source (required), sort, +11 more.

DATA_getAiPromptsByTargetAI Search: Get Prompts by Target (SE Ranking)C

Data Tool: Retrieves a list of prompts (queries) that mention the specified target in AI search results.

Inputs: engine (required), source (required), target (required), sort, +12 more.

DATA_getAuditHistoryGet Audit HistoryB

Data Tool: Retrieves a historical snapshot of a specific audit run, providing the full context of that audit.

Inputs: date (required), audit_id (required).

DATA_getAuditPagesByIssueGet Audit Pages By IssueC

Data Tool: Retrieves a paginated list of all URLs affected by a specific issue within a given audit.

Inputs: code (required), audit_id (required), limit, offset.

DATA_getAuditReportGet Audit ReportA

Data Tool: Retrieves the full, detailed report for a completed website audit. Includes health score, domain properties, and broken down checks.

Inputs: audit_id (required).

DATA_getAuditStatusGet Audit StatusA

Data Tool: Checks the real-time status of a specific website audit, whether it’s queued, currently processing, or already finished.

Inputs: audit_id (required).

DATA_getBacklinksAnchorsBacklinks AnchorsB

Data Tool: Retrieves a list of anchor texts for backlinks pointing to the specified target, with sorting and limit options.

Inputs: target (required), mode, limit, output, +1 more.

DATA_getBacklinksAuthorityBacklinks AuthorityB

Data Tool: Fetch authority metrics for a target (domain, host or URL) (v1/backlinks/authority)

Inputs: target (required), output.

DATA_getBacklinksCountGet Total Backlinks CountA

Data Tool: Returns the total number of backlinks for the target. Supports batch requests.

Inputs: target (required), mode, output.

DATA_getBacklinksExportStatusGet Backlinks Export StatusA

Data Tool: Checks the status of an asynchronous backlinks export task. Returns task status (queued_for_processing, processing, complete) and download URL when complete.

Inputs: task_id (required).

DATA_getBacklinksIndexedPagesBacklinks Indexed PagesB

Data Tool: Fetch site pages that have backlinks, with sorting and limit controls (v1/backlinks/indexed-pages)

Inputs: target (required), mode, limit, output, +1 more.

DATA_getBacklinksMetricsGet Backlink MetricsC

Data Tool: Returns key statistics for a target, such as the number of backlinks, referring domains, etc. Supports batch requests.

Inputs: target (required), mode, output.

DATA_getBacklinksRawFetch Backlinks in BatchesA

Data Tool: Returns all backlinks pointing to a target using cursor-based pagination for large datasets.

Inputs: target (required), mode, next, limit, +3 more.

DATA_getBacklinksRefDomainsBacklinks Referring DomainsB

Data Tool: Retrieves a list of referring domains pointing to the specified target, with options for sorting and limiting results.

Inputs: target (required), mode, limit, output, +1 more.

DATA_getBacklinksSummaryBacklinks SummaryC

Data Tool: Retrieves a summary of backlink metrics for one or multiple targets (domains, subdomains, or URLs).

Inputs: target (required), mode, output.

DATA_getCrawledPagesGet Crawled PagesB

Data Tool: Returns a paginated list of all URLs found during an audit, providing a complete sitemap as discovered by the crawler.

Inputs: audit_id (required), limit, offset.

DATA_getCumulativeBacklinksHistoryGet Cumulative Backlinks HistoryA

Data Tool: Returns a number of live backlinks for every day within the specified date range for the specified target.

Inputs: target (required), mode, date_to, date_from.

DATA_getDistributionOfDomainAuthorityGet Distribution of Domain AuthorityA

Data Tool: Returns information about the distribution of Domain InLink Rank (Domain Authority) of all the domains that reference a specific target.

Inputs: target (required), mode, histogramMode.

DATA_getDomainAdsByDomainDomain Ads by DomainB

Data Tool: Retrieves paid ads for a specific domain.

Inputs: domain (required), source (required), to, from, +2 more.

DATA_getDomainAdsByKeywordDomain Ads by KeywordB

Data Tool: Retrieves paid ads for a specific keyword.

Inputs: source (required), keyword (required), to, from, +2 more.

DATA_getDomainAuthorityGet Domain AuthorityB

Data Tool: Returns information about the domain InLink Rank (Domain Authority) of the target page’s root domain.

Inputs: target (required).

DATA_getDomainAuthorityHistogramGet Domain Authority HistogramB

Data Tool: Returns a bucketed histogram of Domain InLink Rank (Domain Authority) for referring domains linking to the target.

Inputs: target (required), mode.

DATA_getDomainAuthorityHistoryGet Domain Authority HistoryA

Data Tool: Returns historical Domain InLink Rank (Domain Authority) values for a target domain. The target is always resolved to its PLD (pay-level domain) regardless of whether a root domain, host, or URL is provided.

Inputs: target (required), date_to, date_from, granularity.

DATA_getDomainCompetitorsDomain CompetitorsB

Data Tool: Retrieves a list of organic or paid competitors for a domain.

Inputs: domain (required), source (required), type, stats.

DATA_getDomainKeywordsDomain KeywordsB

Data Tool: Retrieves a list of keywords for which a domain ranks in organic or paid search.

Inputs: domain (required), source (required), url, cols, +33 more.

DATA_getDomainKeywordsComparisonDomain Keywords ComparisonA

Data Tool: Analyzes and compares the keyword rankings of two websites: domain and compare. It can find keywords they have in common (diff=0) or identify a 'keyword gap' (diff=1)—keywords for which the domain ranks, but the compare domain does not. To find keywords the compare domain has but domain misses, swap the values of domain and compare.

Inputs: source (required), compare (required), url, cols, +7 more.

DATA_getDomainOverviewDatabasesDomain Overview DBC

Data Tool: Fetch domain overview by database (v1/domain/overview/db)

Inputs: domain (required), source (required), url, with_subdomains.

DATA_getDomainOverviewHistoryDomain Overview HistoryB

Data Tool: Retrieves historical data for domain traffic and keyword rankings.

Inputs: domain (required), source (required), url, type, +1 more.

DATA_getDomainOverviewWorldwideDomain Overview WorldwideC

Data Tool: Retrieves an aggregated worldwide overview of domain metrics.

Inputs: domain (required), fields, currency, show_zones_list.

DATA_getIssuesByUrlGet Issues By URLA

Data Tool: Retrieves a detailed list of all issues (errors, warnings, and notices) that were found on a single, specific page within an audit.

Inputs: audit_id (required), url, url_id.

DATA_getKeywordQuestionsKeyword QuestionsB

Data Tool: Retrieves a list of question-based keywords containing the seed keyword.

Inputs: source (required), keyword (required), sort, limit, +19 more.

DATA_getLongTailKeywordsLongtail KeywordsC

Data Tool: Retrieves a list of long-tail variations for the seed keyword.

Inputs: source (required), keyword (required), sort, limit, +18 more.

DATA_getNewLostBacklinksCountGet Daily New and Lost Backlinks CountB

Data Tool: Returns a number of (newly) found or lost backlinks for every day within the specified date range.

Inputs: target (required), mode, output, date_to, +6 more.

DATA_getNewLostRefDomainsCountGet New and Lost Referring Domains CountA

Data Tool: Returns the number of referring domains, at least one backlink from which was newly found or lost in the specified date range, broken down by day.

Inputs: target (required), mode, date_to, date_from, +1 more.

DATA_getPageAuthorityGet Page AuthorityB

Data Tool: Returns information about the InLink Rank (Page Authority) for a target URL.

Inputs: target (required).

DATA_getPageAuthorityHistoryGet Page Authority HistoryC

Data Tool: Returns information about the historical values of InLink Rank for a specific target page.

Inputs: target (required), date_to, date_from, granularity.

DATA_getReferringIpsGet Referring IPsC

Data Tool: Returns information about IPv4 addresses that belong to backlinks that point to a target.

Inputs: target (required), mode, limit, order_by.

DATA_getReferringIpsCountGet Referring IPs CountB

Data Tool: Returns the number of unique IPs linking to a target.

Inputs: target (required), mode.

DATA_getReferringSubnetsCountGet Referring Subnets CountB

Data Tool: Returns the number of unique subnets/C-blocks linking to a target.

Inputs: target (required), mode.

DATA_getRelatedKeywordsRelated KeywordsC

Data Tool: Retrieves a list of keywords semantically related to the seed keyword.

Inputs: source (required), keyword (required), sort, limit, +19 more.

DATA_getSerpHtmlDumpGet SERP HTML DumpA

Data Tool: Retrieves the raw HTML dump of a completed SERP task as a ZIP file. Returns binary ZIP data containing the SERP HTML page(s). Useful for debugging, archiving, or parsing the actual SERP page content.

Inputs: task_id (required).

DATA_getSerpLocationsSERP locationsB

Data Tool: Retrieves available locations for SERP analysis. After getting a location_id, use 'getSerpResults' to run SERP queries.

Inputs: q (required), country_code (required).

DATA_getSerpResultsGet SERP resultsA

Data Tool: Runs a SERP query and returns results. Creates task, polls every 5 seconds until complete (5 min timeout), and returns organic/ads/featured snippets (standard) or all SERP types including AI Overview, Maps, Reviews (advanced). Supports progress notifications.

Inputs: query (required), location_id (required), language_code (required), tag, +5 more.

DATA_getSerpTaskAdvancedResultsGet SERP task status and advanced resultsA

Data Tool: Retrieves the status or advanced results of a specific SERP task. Note that SERP tasks usually take 60 seconds to finish. If the task is still running, returns {"status": "processing"}. If complete, returns the full JSON results including "items". Returns ALL SERP item types (Maps, Reviews, AI Overview, etc.). Costs 10 credits for the 1st call.

Inputs: task_id (required).

DATA_getSerpTaskResultsGet SERP task status and resultsA

Data Tool: Retrieves the status or standard results of a specific SERP task. Note that SERP tasks usually take 60 seconds to finish. If the task is still running, returns {"status": "processing"}. If complete, returns the full JSON results including "items". This endpoint provides results for the following SERP item types only: organic, ads, and featured_snippet. For AI Overview, Maps, Reviews, Sitelinks, Videos, Images, Top Ads, etc., use 'getSerpTaskAdvancedResults'.

Inputs: task_id (required).

DATA_getSerpTasksList SERP tasksA

Data Tool: Retrieves a list of all SERP tasks added to the queue in the last 24 hours.

Inputs: no named parameters.

DATA_getSimilarKeywordsSimilar KeywordsC

Data Tool: Retrieves a list of keywords similar to the seed keyword.

Inputs: source (required), keyword (required), sort, limit, +19 more.

DATA_getTotalRefDomainsCountGet Total Referring Domains CountC

Data Tool: Returns the number of unique domains linking to a target. Supports batch requests.

Inputs: target (required), mode, output.

DATA_listAuditsList AuditsB

Data Tool: Retrieves a list of all website audits associated with your account, providing key details and statistics for each.

Inputs: limit, offset, search, date_end, +1 more.

DATA_listNewLostReferringDomainsList New and Lost Referring DomainsB

Data Tool: Returns a list of referring domains, at least one backlink from which was (newly) found or lost in the specified date range for the specified target.

Inputs: target (required), mode, limit, date_to, +3 more.

DATA_recheckAuditRecheck AuditA

Data Tool: Launches a new crawl of a previously completed audit, using the same settings.

Inputs: type (required), audit_id (required).

DATA_updateAuditTitleUpdate Audit TitleC

Data Tool: Changes the title of an existing website audit report.

Inputs: title (required), audit_id (required).

PROJECT_addCompetitorAdd CompetitorA

Project Tool: Requires a project ID (site_id). Add a competitor website to a project for position tracking.

Inputs: url (required), site_id (required), name, subdomain_match.

PROJECT_addKeywordsAdd KeywordsC

Project Tool: Requires a project ID. Add new keywords to a project.

Inputs: site_id (required), keywords (required).

PROJECT_addSearchEngineAdd Search Engine to ProjectC

Project Tool: Add a new search engine to a project.

Inputs: site_id (required), search_engine_id (required), phone, lang_code, +6 more.

PROJECT_createKeywordGroupCreate Keyword GroupC

Project Tool: Requires a project ID. Add a group for project keywords.

Inputs: name (required), site_id (required).

PROJECT_createProjectCreate ProjectC

Project Tool: Requires a project ID. Add a new project to the user account.

Inputs: url (required), title (required), depth, check_day, +7 more.

PROJECT_createProjectGroupCreate Project GroupC

Project Tool: Requires a project ID. Add a new project group to a user account.

Inputs: name (required).

PROJECT_deleteCompetitorDelete CompetitorC

Project Tool: Requires a competitor ID. Remove a competitor website from a user project.

Inputs: competitor_id (required).

PROJECT_deleteKeywordGroupDelete Keyword GroupC

Project Tool: Requires a project ID. Delete a project keyword group.

Inputs: group_id (required).

PROJECT_deleteKeywordsDelete KeywordsC

Project Tool: Requires a project ID. Delete keywords from a project.

Inputs: site_id (required), keywords_ids (required).

PROJECT_deleteProjectDelete ProjectC

Project Tool: Requires a project ID. Delete a project from the user account.

Inputs: site_id (required).

PROJECT_deleteProjectGroupDelete Project GroupC

Project Tool: Requires a project ID. Delete a project group.

Inputs: group_id (required).

PROJECT_deleteSearchEngineDelete Search EngineB

Project Tool: Delete a search engine from a project.

Inputs: site_id (required), site_engine_id (required).

PROJECT_getAdsStatsGet Ads StatsB

Project Tool: Requires a project ID. Get total number of top and bottom advertisements by day.

Inputs: site_id (required), date_to, date_from, keywords_ids, +1 more.

PROJECT_getAllCompetitorsMetricsGet All Competitors MetricsB

Project Tool: Requires a project ID (site_id). Get data on the sites that were ranked in the TOP 10 for each of the tracked queries. The history is stored for 14 days.

Inputs: date (required), site_id (required), site_engine_id (required), tags, +1 more.

PROJECT_getAvailableRegionsGet Available RegionsA

Project Tool: Get the list of all available regions supported by Google search engine.

Inputs: no named parameters.

PROJECT_getAvailableSearchEnginesGet Available Search EnginesB

Project Tool: Get the list of all available search engines supported by the system.

Inputs: no named parameters.

PROJECT_getCompetitorPositionsGet Competitor PositionsC

Project Tool: Requires a competitor ID. Get statistics on the positions of competitor keywords that were added to the project.

Inputs: competitor_id (required), date_to, date_from, site_engine_id, +1 more.

PROJECT_getCompetitorTop10Get Competitor Top 10C

Project Tool: Requires a project ID (site_id). Get a list of the TOP 10 results for the keywords that are tracked in a project.

Inputs: date (required), site_id (required), keyword_id (required), site_engine_id (required).

PROJECT_getCompetitorTop100Get Competitor Top 100C

Project Tool: Requires a project ID (site_id). Get a list of the top 100 results for the keywords that are tracked in a project.

Inputs: date (required), site_id (required), keyword_id (required), site_engine_id (required), +1 more.

PROJECT_getHistoricalDatesGet Historical DatesB

Project Tool: Returns standard comparison dates (e.g., yesterday, last month, etc.) available for reporting.

Inputs: site_id (required), site_engine_id (required).

PROJECT_getKeywordStatsGet Keyword StatsC

Project Tool: Requires a project ID. Get keyword ranking statistics for a specified time period.

Inputs: site_id (required), in_top, date_to, date_from, +3 more.

PROJECT_getSearchEnginesGet Search EnginesC

Project Tool: Requires a project ID. Get a list of search engines employed by a project.

Inputs: site_id (required).

PROJECT_getSummaryGet SummaryB

Project Tool: Requires a project ID. Get a project's summary statistics.

Inputs: site_id (required).

PROJECT_listCompetitorsList CompetitorsA

Project Tool: Requires a project ID (site_id). Get a list of all competitors added to the project together with statistics.

Inputs: site_id (required).

PROJECT_listKeywordGroupsList Keyword GroupsA

Project Tool: Requires a project ID. Get a list of keyword groups for a specified project.

Inputs: site_id (required).

PROJECT_listKeywordsList KeywordsB

Project Tool: Get a list of keywords with target pages for a project.

Inputs: site_id (required), site_engine_id.

PROJECT_listProjectGroupsList Project GroupsC

Project Tool: Requires a project ID. Get a list of all project groups from a user account.

Inputs: no named parameters.

PROJECT_listProjectsList ProjectsD

Project Tool: Requires a project ID. Get a list of all user projects.

Inputs: no named parameters.

PROJECT_listTagsList TagsA

Project Tool: Requires a project ID. Get a list of landing page tags that are added to domains and/or links.

Inputs: site_id (required).

PROJECT_moveKeywordsToGroupMove Keywords to GroupC

Project Tool: Requires a project ID. Transfer project keywords from one group to another.

Inputs: group_id (required), keywords_ids (required).

PROJECT_moveProjectsToGroupMove Projects to GroupC

Project Tool: Requires a project ID. Transfer projects from one project group to another (or to a specific group).

Inputs: group_id (required), site_ids (required).

PROJECT_runPositionCheckRun Position CheckB

Project Tool: Requires a project ID. Run a ranking position check for specified keywords or for the entire project.

Inputs: site_id (required), keywords, site_engine_id.

PROJECT_setKeywordPositionSet Keyword PositionC

Project Tool: Manually set position for a project's keyword.

Inputs: date (required), site_id (required), position (required), keyword_id (required), +1 more.

PROJECT_updateKeywordGroupUpdate Keyword GroupC

Project Tool: Requires a project ID. Update the name of a project keyword group.

Inputs: name (required), group_id (required).

PROJECT_updateProjectUpdate ProjectC

Project Tool: Requires a project ID. Change/update project settings.

Inputs: site_id (required), url, depth, title, +6 more.

PROJECT_updateProjectGroupUpdate Project GroupC

Project Tool: Requires a project ID. Rename a project group.

Inputs: name (required), group_id (required).

PROJECT_updateSearchEngineUpdate Search EngineB

Project Tool: Update an existing search engine in a project.

Inputs: site_id (required), site_engine_id (required), phone, lang_code, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 100 tools

    Disambiguation3/5

    The tools are organized into DATA_ and PROJECT_ prefixes, which helps, but within each category there are many similar tools (e.g., multiple backlinks retrieval tools) that could cause confusion. Descriptions provide differentiation, but the sheer number and naming proximity make misselection possible.

    Naming Consistency5/5

    All tools follow a strict CATEGORY_verbNoun pattern with consistent verb usage (get, list, create, delete, update, etc.) and clear nouns. The naming is highly predictable and uniform across the entire set.

    Tool Count2/5

    With 100 tools, the surface is very large. While the domain of SEO is broad, this number feels excessive and could overwhelm an agent. Many tools are highly specialized, and the count suggests a lack of consolidation or abstraction.

    Completeness4/5

    The tool set covers major SEO areas: website audits, backlinks, keyword research, SERP results, project management, competitors, etc. There are minor omissions (e.g., no tool for managing tag assignments beyond listing), but overall the coverage is thorough.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides AI assistants with access to Semrush SEO API functionality including domain analytics, keyword research, backlink analysis, and competitor insights.
      7
      16
      MIT
    • -
      license
      C
      quality
      Not graded
      maintenance
      Enables AI assistants to access comprehensive SEO data through DataForSEO APIs, including SERP results, keyword research, backlink analysis, on-page metrics, and domain analytics. Supports real-time search engine data from Google, Bing, and Yahoo with customizable filtering and multiple deployment options.
      36
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to access SurfRank's AI visibility analytics platform through 24 tools. It allows agents to run AI-visibility reports, research keywords, track competitors, and manage projects directly from chat interfaces.
      24
      7 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables to access SE Ranking SEO data through natural language queries, providing keyword analysis, competitor research, and performance tracking.
      28
      1
      Apache 2.0