Serpstat MCP Server
OfficialProvides tools for accessing Google search data, including domain analysis, keyword rankings, and competitor visibility metrics via the Serpstat API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Serpstat MCP Server analyze the organic search competitors for shopify.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Serpstat MCP Server
A TypeScript server that integrates Serpstat SEO API with Anthropic's Model Context Protocol (MCP), enabling AI assistants like Claude to access comprehensive SEO data and analysis tools.
Table of Contents
Related MCP server: SE Ranking MCP Server
About MCP
The Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI assistants to securely connect to external data sources and tools. This server implements MCP to provide Claude and other compatible AI assistants with access to Serpstat's powerful SEO analytics API.
Description
This project implements a TypeScript server that provides an API interface for working with Serpstat tools via the MCP protocol. The server supports request handling, parameter validation, logging, and working with multiple SEO analysis tools.
Features
๐ Comprehensive SEO Analysis: Access domain info, keyword research, competitor analysis, and backlink data
โ Input Validation: Robust parameter validation using Zod schemas
๐ Event Logging: Detailed logging with Winston for debugging and monitoring
โ๏ธ Flexible Configuration: Environment-based configuration with sensible defaults
๐งช Well Tested: Jest tests for parameter validation and business logic
๐ TypeScript: Full type safety throughout the codebase
Prerequisites
Node.js 18.0.0 or higher (Download Node.js)
Valid Serpstat API token (get one from Serpstat)
Compatible AI Assistant: Claude Desktop, Gemini CLI, or any MCP-compatible client
Installation
Global Installation (Recommended)
npm install -g @serpstat/serpstat-mcp-serverLocal Installation
npm install @serpstat/serpstat-mcp-serverConfiguration
Environment Variables
Set the following environment variables (can be in .env file):
SERPSTAT_API_TOKENโ Your Serpstat API token (required)SERPSTAT_API_URLโ Serpstat API URL (default: https://api.serpstat.com/v4)LOG_LEVELโ Logging level: error, warn, info, debug (default: info)SERPSTAT_ENABLED_CATEGORIESโ Filter tools by categories (optional, comma-separated, default: all categories enabled)
Claude Desktop & Gemini CLI Configuration
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Add to your Gemini CLI config:
Linux: ~/.gemini/settings.json
{
"mcpServers": {
"serpstat": {
"command": "npx",
"args": ["-y", "@serpstat/serpstat-mcp-server"],
"env": {
"SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE",
"LANG": "en_US.UTF-8",
"LC_ALL": "en_US.UTF-8"
}
}
}
}For local development, use the full path:
{
"mcpServers": {
"serpstat": {
"command": "node",
"args": ["/path/to/node_modules/serpstat-mcp-server/dist/index.js"],
"env": {
"SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE"
}
}
}
}Filtering Tools by Category
You can limit which tools are available by specifying SERPSTAT_ENABLED_CATEGORIES environment variable. This is useful for:
Reducing context window usage in AI assistants
Focusing on specific SEO analysis areas
Creating specialized configurations for different use cases
Available categories:
domain- Domain analysis tools (domain info, competitors, domain keywords, etc.)keywords- Keyword research tools (keyword suggestions, search volume, difficulty, etc.)backlinks- Backlink analysis tools (backlink summary, anchors, referring domains, etc.)url- URL analysis tools (URL traffic, competitors, keywords, etc.)projects- Project management tools (create, list, delete projects)credits- Credits and usage monitoring toolsrt- Rank tracking tools (rank history, SERP tracking, etc.)audit- Site audit tools (full site SEO audit, error reports, etc.)page-audit- One-page audit tools (single page analysis, on-page SEO, etc.)
Example: Enable only keyword and domain tools
{
"mcpServers": {
"serpstat": {
"command": "npx",
"args": ["-y", "@serpstat/serpstat-mcp-server"],
"env": {
"SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE",
"SERPSTAT_ENABLED_CATEGORIES": "keywords,domain"
}
}
}
}Example: Enable only backlink analysis
{
"mcpServers": {
"serpstat": {
"command": "npx",
"args": ["-y", "@serpstat/serpstat-mcp-server"],
"env": {
"SERPSTAT_API_TOKEN": "YOUR_SERPSTAT_API_TOKEN_HERE",
"SERPSTAT_ENABLED_CATEGORIES": "backlinks"
}
}
}
}Default behavior (all tools enabled):
If SERPSTAT_ENABLED_CATEGORIES is not specified or is empty, all tools are available (65 total tools across all categories).
Usage Examples
After installation and configuration in Claude Desktop, you can ask Claude:
Domain Analysis
"Show me domain info for example.com"
"Find competitors for my-site.com in Google US"
"Get top 50 keywords that example.com ranks for"
Market Research
"Show me all available market research categories"
"Find top domains in 'E-commerce' category for Google US"
"Get top 20 domains in '/Arts & Entertainment/TV & Video' category sorted by traffic"
"Analyze competitive landscape in 'Business & Industrial' category with domains that have SDR above 50"
"Find leading players in 'Health & Fitness' market with minimum 100k monthly traffic"
Keyword Research
"Find related keywords to 'digital marketing'"
"Get keyword suggestions for 'iphone 15' excluding 'rent' keywords"
"Get comprehensive keyword data for [
iphone,samsung,googel pixel] including search volume, CPC, and difficulty"
Competitor Analysis
"Show me competitor domains ranking for
pizza deliverykeyword with visibility metrics""Get top search results for
laptop computerskeyword showing positions, domains and SERP features""Get unique keywords for domain1.com vs domain2.com"
Backlink Analysis
"Analyze backlinks summary for domain.com"
"Get anchor text analysis for domain.com backlinks"
"Get active backlinks for domain.com showing linking pages and target URLs"
"Get referring domains for domain.com with domain authority metrics"
"Get lost backlinks for domain.com showing removed links and deletion dates"
"Get top 10 anchors for domain.com with backlink counts and referring domains"
"Get backlinks intersection for domain.com vs competitor1.com and competitor2.com showing shared referring domains"
"Get threat backlinks for domain.com showing malicious links from sites flagged for security threats"
Project Management
"Create a new project for example.com named My SEO Project"
"List all my projects with pagination"
"Delete project with ID 1234567"
Credits & Usage Monitoring
"Show me my audit credits statistics"
"Check my API credits usage and remaining quota"
Rank Tracking
"List all my rank tracker projects"
"Check parsing status for project 12345 in region 2840"
Site Audit
"Get audit settings for project 1113915"
"Start site audit for project 1113915"
"Stop site audit for project 1113915"
MCP Tools
Domain Analysis Tools
Tool Name | Description | Key Parameters |
get_domains_info | Get SEO information for multiple domains | domains, se, filters |
get_domain_competitors | Get list of competitor domains | domain, se, size, filters |
get_domain_keywords | Get keywords that domain ranks for | domain, se, page, size |
get_domain_urls | Get URLs within a domain and their keyword counts | domain, se, page, size |
get_domain_regions_count | Get keyword count by region for a domain | domain, sort, order |
get_domain_uniq_keywords | Get unique keywords for two domains not ranked by a third domain | se, domains, minusDomain |
get_market_categories | Get complete list of 1000+ market research categories | none |
get_category_top_domains | Get top-performing domains in a specific market category with SEO metrics | category_id, se, filters, sort, page, size |
Keyword Research Tools
Tool Name | Description | Key Parameters |
get_keywords | Get related organic keywords for a given keyword | keyword, se, filters |
get_related_keywords | Get semantically related keywords with frequency, CPC, competition, and difficulty data | keyword, se, filters, sort |
get_keyword_suggestions | Get search suggestions for a keyword using full-text search with geographic names info | keyword, se, filters |
get_keywords_info | Get keyword overview with volume, CPC, competition, difficulty, and SERP features | keywords, se, withIntents |
get_keyword_full_top | Get Google's top-100 search results for analyzed keywords | keyword, se, size |
get_keyword_top_urls | Get website pages that rank for the largest amount of analyzed keyword variations | keyword, se, page, page_size |
get_keyword_competitors | Get domains that rank for the given keyword in Google top-20 results with competitor analysis | keyword, se, filters, sort |
get_keyword_top | Get Google's top-100 search results for the analyzed keyword with position, URL, and SERP features | keyword, se, filters, size |
URL Analysis Tools
Tool Name | Description | Key Parameters |
get_url_summary_traff | Get traffic and keyword statistics for website pages matching a specific URL mask | se, domain, urlContains |
get_url_competitors | Get list of URL competitors showing domains competing for same keywords in top-10 results | se, url, sort, page |
get_url_keywords | Get keywords for which specified URL ranks in top-100 Google and top-50 Bing search results | se, url, filters, sort |
get_url_missing_keywords | Get keywords that competitors rank for but the given URL does not, identifying keyword gaps | url, se, filters, sort |
Backlinks Analysis Tools
Tool Name | Description | Key Parameters |
get_backlinks_summary | Get comprehensive backlinks summary with referring domains, quality metrics, and changes | domain, subdomain |
get_anchors | Get anchor text analysis for backlinks with metrics on referring domains and backlinks | query, searchType, anchor, sort |
get_active_backlinks | Get a list of active backlinks showing linking pages, target pages, and link attributes | query, searchType, sort, page |
get_referring_domains | Get a list of referring domains with domain rank metrics and referring pages count | query, searchType, sort, page |
get_lost_backlinks | Get a list of lost backlinks showing linking pages, target pages, and deletion dates | query, searchType, sort, page |
get_top_pages_by_backlinks | Get a list of top pages by backlinks with various filtering and sorting parameters | query, searchType, sort, size |
get_top10_anchors | Get TOP-10 anchors with the number of backlinks and referring domains | query, searchType |
get_backlinks_intersection | Get backlinks from domains that link to multiple analyzed sites for competitive analysis | query, intersect, sort, page |
get_active_outlinks | Get active outbound links from a domain or URL with target URLs and anchor text | query, searchType, sort, filters |
get_active_outlink_domains | Get external domains that receive outbound links from analyzed domain | query, searchType, sort, filters |
get_threat_backlinks | Get malicious backlinks pointing to analyzed domain from sites flagged for security threats | query, searchType, sort, filters |
Project Management Tools
Tool Name | Description | Key Parameters |
create_project | Create a new project in Serpstat for tracking SEO metrics and site audits | domain, name, groups |
delete_project | Delete an existing project from Serpstat by project ID | project_id |
list_projects | Retrieve a list of projects associated with the account with pagination | page, size |
Credits & Usage Monitoring Tools
Tool Name | Description | Key Parameters |
get_credits_for_audit_stats | Check available audit credits (one-page audit, JavaScript scanning, crawl limits) No cost | none |
get_credits_stats | Check API credits usage, account info, and browser plugin limits No cost | none |
Rank Tracking Tools
Tool Name | Description | Key Parameters |
get_rt_projects_list | Get rank tracker projects with ID, name, domain, creation date, and tracking status No cost | page, pageSize |
get_rt_project_status | Check if rank tracker project is parsing (true=processing, false=ready) No cost | projectId, regionId |
get_rt_project_regions_list | Get list of regions for a rank tracker project with status, SERP type, device, and location No cost | projectId |
get_rt_project_keyword_serp_history | Get Google's top-100 SERP history for rank tracker keywords with positions and URLs No cost | projectId, projectRegionId, page |
get_rt_project_url_serp_history | Get ranking history of URLs for rank tracker keywords with historical position data No cost | projectId, projectRegionId, page |
Site Audit Tools
Tool Name | Description | Key Parameters |
get_site_audit_settings | Get audit settings for a project including scan parameters, scheduling, and error thresholds No cost | projectId |
set_site_audit_settings | Update audit settings for a project with scan configuration, scheduling, and notifications No cost | projectId, mainSettings, ... |
start_site_audit | Start audit session for a project and receive reportId for tracking progress (1 credit/page, 10 credits/page with JS rendering) | projectId |
stop_site_audit | Stop active audit session for a project No cost | projectId |
get_site_audit_results_by_categories | Get audit results statistics grouped by issue categories (pages status, meta tags, links, etc.) No cost | reportId |
get_site_audit_history | Get historical error count data for a specific error type across multiple audit reports No cost | projectId, errorName, limit, offset |
get_site_audits_list | Get list of all audit reports for a project with summary statistics and progress information No cost | projectId, limit, offset |
get_site_audit_scanned_urls_list | Get list of URLs that will be scanned based on project scan settings No cost | projectId |
get_site_audit_project_default_settings | Get default audit settings template to use when creating new projects No cost | - |
get_site_audit_bref_info | Get essential summary information from latest audit including SDO score, issue counts by priority, scan progress, and completion status No cost | reportId |
get_site_audit_deteailed_report | Get number of errors categorized by type with comparison to previous report showing countAll, countNew, and countFixed No cost | reportId, compareReportId (optional) |
get_site_audit_pages_spec_errors | Get list of all pages where a specific error was detected with filtering by mode (all/new/solved) and pagination support No cost | reportId, compareReportId, projectId, errorName, mode, limit, offset |
get_site_audit_elements_with_issues | Get list of sub-elements (URLs) containing specific errors using CRC from get_site_audit_pages_spec_errors response No cost | reportId, projectId, errorName, crc, compareReportId (optional), mode, limit, offset |
One Page Audit Tools
Tool Name | Description | Key Parameters |
page_audit_start_scan | Scan a single webpage with JavaScript rendering. Returns pageId and reportId for tracking. Use page_audit_get_reports_for_page to check progress via status and progress fields (10 credits per scan) | name, url, userAgent (recommended: 0 for Chrome), httpAuthLogin (optional), httpAuthPass (optional) |
page_audit_get_last_scans | Get list of all one-page audit projects with pageId, url, name, status, lastActiveReport (latest scan results with SDO score), finishedReportCount, settings No cost | limit (optional, default 30), offset (optional, default 0), teamMemberId (optional) |
page_audit_get_reports_for_page | Get history of all audit reports for a specific page with reportId, auditDate, status (1=in progress, 3=finalizing, 4=completed), SDO score (0-100), error counts, progress (0-100) No cost | pageId, limit (optional), offset (optional) |
page_audit_get_results_report | Get detailed audit results with categories array (errors grouped by meta_tags, headings, content, multimedia, https, pagespeed_desktop/mobile, etc), hasAdditionRows flag for drill-down availability No cost | pageId (from page_audit_get_last_scans or page_audit_start_scan) |
page_audit_rescan | Rescan existing one-page audit project and create new audit report. Returns reportId. Track progress via page_audit_get_reports_for_page (10 credits per rescan) | pageId, name, userAgent (recommended: 0 for Chrome), httpAuthLogin (optional), httpAuthPass (optional) |
page_audit_stop | Stop active one-page audit scan. Returns boolean indicating success No cost | pageId |
page_audit_delete | Remove one-page audit project from customer project list permanently. Returns boolean No cost | pageId |
page_audit_get_report_by_categories | Get audit results by categories for specific report. Use compareReportId to see countNew (errors added) and countFixed (errors resolved) No cost | reportId, compareReportId (optional, enables change tracking) |
page_audit_report_drill_down | Get detailed problematic elements list. ONLY works for errors with hasAdditionRows=true. Response varies by error type (e.g., image URLs for multimedia errors) No cost | reportId, error (must match error.key), mode (all/new/solved, optional), compareReportId (optional), page (optional), size (optional, max 1000) |
page_audit_get_scan_names | Get list of all one-page audit project names with pageId, name, url, finishedReportCount for project discovery No cost | teamMemberId (optional) |
page_audit_scan_logs | Get chronological log of scan events with message (event name), type (info/warning/error), params (event-specific data or []), created_at timestamp for debugging No cost | reportId (optional, all scans if not specified), page (optional, default 0), pageSize (optional, default 100) |
Search Engines (se parameter)
Common search engine codes:
g_us- Google USAg_uk- Google United Kingdomg_ca- Google Canadag_au- Google Australiag_de- Germanyg_fr- Google Franceg_es- Google Spaing_it- Google Italyg_pl- Google Polandg_ua- Google Ukraine
See a full list of Search Engines Short Names
Troubleshooting
Common Issues
"Command not found: serpstat-mcp-server"
Make sure you installed the package globally with
-gflagVerify your PATH includes npm global binaries:
npm config get prefixTry reinstalling:
npm uninstall -g @serpstat/serpstat-mcp-server && npm install -g @serpstat/serpstat-mcp-server
"API token error" or "Unauthorized"
Check that
SERPSTAT_API_TOKENis set correctly in your environmentVerify your token is valid and active in your Serpstat account
Ensure your token has sufficient API credits and permissions
"Module not found" errors
Make sure all dependencies are installed:
npm installTry rebuilding:
npm run clean && npm run build
Claude Desktop doesn't recognize the server
Restart Claude Desktop after configuration changes
Check the config file path and JSON syntax
Verify the server starts correctly: run
serpstat-mcp-serverin terminal
"Can't find npx"
You need to install Node.js - download and install Node.js
Rate limit errors
Most Serpstat plans have 1 RPS (1 request per second) limit
Wait between requests or contact Serpstat support for higher limits
Check your API usage in the Serpstat dashboard
Debug Mode
Enable debug logging by setting:
export LOG_LEVEL=debugOr in your Claude Desktop config:
{
"mcpServers": {
"serpstat": {
"command": "npx",
"args": ["-y", "@serpstat/serpstat-mcp-server"],
"env": {
"SERPSTAT_API_TOKEN": "YOUR_TOKEN_HERE",
"LANG": "en_US.UTF-8",
"LC_ALL": "en_US.UTF-8",
"LOG_LEVEL": "debug"
}
}
}
}Development
Getting Started
Clone the repository:
git clone git@github.com:SerpstatGlobal/serpstat-mcp-server-js.git cd serpstat-mcp-server-jsInstall dependencies:
npm installSet environment variables:
cp .env.example .env # Edit .env with your Serpstat API tokenBuild the project:
npm run buildStart the server:
npm startFor development mode (auto-reload):
npm run dev
Testing
To run tests:
npm testRun specific test file:
npx jest src/__tests__/services/keyword_tools.test.tsRun specific test by name:
npx jest --testNamePattern="methodName"Scripts
npm run buildโ Compile TypeScript sources to JavaScript (output indist/)npm startโ Run the compiled server fromdist/npm run devโ Run the server in development mode with hot-reloadnpm testโ Run all testsnpm run lintโ Run lintingnpm run cleanโ Clean build directory
Project Structure
serpstat-mcp-server/
โโโ src/
โ โโโ index.ts # Entry point
โ โโโ server.ts # Main MCP server
โ โโโ handlers/ # Tool handlers
โ โโโ services/ # Services for Serpstat API
โ โโโ types/ # Data types
โ โโโ utils/ # Utilities (config, logger, validation)
โ โโโ __tests__/ # Tests
โโโ dist/ # Compiled JavaScript (after build)
โโโ package.json
โโโ tsconfig.json
โโโ README.md
โโโ .env.exampleAPI Rate Limits
By default, most Serpstat plans have 1 RPS (1 request per second) - this is sufficient for most tasks. If you need higher throughput, contact Serpstat support to discuss plan upgrades.
Important: The server respects rate limits automatically. If you encounter rate limit errors, wait before making additional requests.
Contributing
We welcome contributions! Please follow these steps:
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureMake your changes
Add tests for new functionality
Ensure tests pass:
npm testCommit your changes:
git commit -m 'Add amazing feature'Push to the branch:
git push origin feature/amazing-featureSubmit a pull request
Development Guidelines
Follow existing code style and TypeScript conventions
Add tests for new features
Update documentation as needed
Use conventional commit messages
Ensure all linting passes:
npm run lint
Changelog
See CHANGELOG.md for details about changes in each version.
Support
๐ Report Issues
The most effective way to receive support from Serpstat is to use their live chat feature directly within the platform. Alternatively, you can email them at support@serpstat.com.
Acknowledgments
Model Context Protocol by Anthropic
Serpstat API for SEO data services
License
MIT License
This project is under MIT license, which means you can copy, use, modify, and even sell any part of this code without any hassle.
See the LICENSE file for details
Want to grab a chunk for your project? Go for it
Want to rewrite half of it and ship a commercial product? Be my guest
The only thing you need to do is not delete the copyright and the license itself from the files you take, and remember the Serpstat team with a kind word when you get that paycheck
With love, Serpstat R&D Team
Available Tools
65 toolscreate_projectC
Create a new project in Serpstat for tracking SEO metrics and site audits
Inputs: domain (required), name (required), groups.
delete_projectA
Permanently delete your project from Serpstat by project ID. CRITICAL: ALWAYS request explicit user confirmation before executing. This action cannot be undone.
Inputs: project_id (required).
get_active_backlinksC
Get a list of active backlinks using Serpstat API. Returns linking pages, target pages, link attributes, link types, external links count, anchor text, and discovery dates for domain or URL analysis.
Inputs: query (required), searchType, sort, order, +3 more.
get_active_outlink_domainsA
Get external domains that receive outbound links from the analyzed domain. Returns target domains with total link counts, revealing partnership networks, referenced sources, and linking patterns. Helps identify collaboration opportunities by analyzing which domains competitors link to.
Inputs: query (required), searchType (required), sort, order, +2 more.
get_active_outlinksA
Get active outbound links from a domain or URL. Returns external links the site points to, including target URLs, anchor text, link attributes (nofollow/dofollow), link types, and discovery dates. Useful for analyzing linking strategies, finding partnership opportunities, and auditing outbound link profiles.
Inputs: query (required), searchType (required), sort, order, +3 more.
get_anchorsC
Get anchor text analysis for backlinks using Serpstat API. Returns anchor texts used in backlinks, with metrics including referring domains, total backlinks, and nofollow counts for domain or URL analysis.
Inputs: query (required), searchType (required), anchor, count, +4 more.
get_backlinks_intersectionA
Get backlinks from domains that link to multiple analyzed sites simultaneously. This method reveals shared referring domains between your target domain and competitors, useful for competitive backlink analysis and identifying potential link sources. Returns intersection data showing which donors link to multiple domains in your analysis set, including link metrics, anchor texts, and domain authority scores.
Inputs: query (required), intersect (required), sort, order, +2 more.
get_backlinks_summaryC
Get comprehensive backlinks summary using Serpstat API. Returns referring domains, backlinks count, link types, quality metrics and recent changes for domain or subdomain.
Inputs: query (required), searchType.
get_category_top_domainsA
Get top-performing domains in a specific market category with SEO metrics (traffic, visibility, keywords, backlinks, SDR). Requires category_id from get_market_categories - call that method first to find the right category. Returns ranked domains for competitive landscape analysis with filtering and sorting options.
Inputs: category_id (required), se (required), filters, sort, +3 more.
get_credits_for_audit_statsA
Check available audit credits including one-page audit, JavaScript scanning, and page crawl limits. Use this before running site audits to verify available resources. This method does not consume API credits.
Inputs: no named parameters.
get_credits_statsA
Check available API credits, usage statistics, account information, and browser plugin limits. Perfect for monitoring API usage and planning resource-heavy operations. This method does not consume API credits.
Inputs: no named parameters.
get_domain_competitorsB
Get a list of competitor domains for a given domain, including visibility, traffic, and relevance.
Inputs: domain (required), se (required), size, filters.
get_domain_keywordsC
Get keywords that domain ranks for in Google search results. Includes position, traffic, difficulty analysis with comprehensive SEO insights and performance metrics.
Inputs: domain (required), se (required), withSubdomains, withIntents, +7 more.
get_domain_regions_countA
REQUIRED FIRST STEP ONLY IF DOMAIN ANALYSIS for domain analysis: Determines optimal regional database (se parameter) by analyzing domain keyword presence across all Google regions. This tool identifies which regional database contains the most keyword data for the domain, ensuring subsequent analysis uses the correct market context. Returns: keyword count by country, regional performance comparison, and identifies primary market for the domain.
Inputs: domain (required), sort, order.
get_domains_infoB
Get comprehensive SEO information for multiple domains including visibility, keywords, traffic, and dynamics
Inputs: domains (required), se (required), filters.
get_domain_uniq_keywordsC
Returns unique keywords of two domains for which a third domain does not rank. Equivalent to a Domain vs domain report.
Inputs: se (required), domains (required), minusDomain (required), page, +2 more.
get_domain_urlsA
Get URLs within a domain and keyword count for each URL. Analyze URL structure, performance distribution, and identify top-performing pages. Each URL costs 1 API credit, minimum 1 credit per request.
Inputs: domain (required), se (required), filters, sort, +2 more.
get_keyword_competitorsB
Lists the domains that rank for the given keyword in Google top-20 results. Shows detailed competitor analysis including visibility metrics, traffic data, keyword dynamics, and relevance scores.
Inputs: keyword (required), se (required), filters, sort, +1 more.
get_keyword_full_topC
Shows Google's top-100 search results for the analyzed keyword. Returns detailed information about domains ranking for the keyword including their visibility, organic/PPC keywords count, SDR score, and backlink metrics.
Inputs: keyword (required), se (required), sort, size.
get_keywordsC
Shows organic keywords related to the researched keyword for which domains rank in Google top 100. For each found keyword, displays its search volume, CPC, and competition level.
Inputs: keyword (required), se (required), minusKeywords, withIntents, +4 more.
get_keywords_infoC
Get keyword overview showing volume, CPC, competition level, difficulty, and additional metrics for multiple keywords. Provides comprehensive analysis including search volume, cost per click, competition levels, SERP features, and keyword intents.
Inputs: keywords (required), se (required), withIntents, sort, +1 more.
get_keyword_suggestionsC
Shows search suggestions for the keyword you requested (they are found by the full-text search). Returns keyword suggestions with geographic names information.
Inputs: keyword (required), se (required), filters, page, +1 more.
get_keyword_topB
Shows Google's top-100 search results for the analyzed keyword. Returns position data, URLs, domains, subdomains, and SERP feature types. This method is deprecated but still functional.
Inputs: keyword (required), se (required), filters, size.
get_keyword_top_urlsB
Returns website pages that rank for the largest amount of the analyzed keyword variations and have the highest traffic. Shows URLs with keyword count, estimated traffic, and Facebook shares.
Inputs: keyword (required), se, sort, order, +2 more.
get_lost_backlinksA
Get a list of lost backlinks showing linking pages, target pages, link attributes, and deletion dates for domain or URL analysis, use sort by check desc to get recently lost backlinks
Inputs: query (required), searchType, sort, order, +3 more.
get_market_categoriesA
Get complete list of available market research categories (1000+ categories). Use this method first to find the appropriate category_id for your analysis. Returns hierarchical categories like '/Arts & Entertainment/TV & Video/Online Video' with their IDs (e.g., '.2.13.1.'). The category_id is required for get_category_top_domains method.
Inputs: no named parameters.
get_referring_domainsB
Get a list of referring domains using Serpstat API. Returns referring domains that link to the analyzed site with domain rank metrics, referring pages count, and filtering options for comprehensive backlink analysis.
Inputs: query (required), searchType, sort, order, +2 more.
get_rt_project_keyword_serp_historyA
Get complete Google top-100 SERP history for tracked keywords in a rank tracker project. Returns full competitor analysis with historical positions, URLs, domains, and search volumes for each date. WARNING: This method returns large datasets (full top-100 for each keyword/date combination). Recommended pageSize: 20-50 for most use cases. Use date filters and keyword filters to reduce response size. Supports keyword tagging for grouping and filtering. This method does not consume API credits.
Inputs: projectId (required), projectRegionId (required), page (required), pageSize, +6 more.
get_rt_project_regions_listA
Get the list of regions configured for a rank tracker project, including region ID, status (active/inactive), SERP type (organic/paid), device type (desktop/mobile), search engine, and location details. This method does not consume API credits.
Inputs: projectId (required).
get_rt_projects_listA
Get a list of rank tracker projects including project ID, name, domain, creation date, and tracking status. This method does not consume API credits.
Inputs: page, pageSize.
get_rt_project_statusA
Get the current status of position updates (parsing) for a rank tracker project and region. Use this to check if data is ready before requesting results. This method does not consume API credits.
Inputs: projectId (required), regionId (required).
get_rt_project_url_serp_historyA
Get ranking history showing only YOUR domain's positions across all tracked keywords. Unlike get_rt_project_keyword_serp_history (which shows full top-100), this method returns only positions where your specified domain/URL ranks. Perfect for tracking your own performance over time without competitor noise. Returns historical position data, search volumes, and optional keyword tags. This method does not consume API credits.
Inputs: projectId (required), projectRegionId (required), page (required), pageSize, +7 more.
get_site_audit_bref_infoA
Get quick summary of a single audit for dashboard display. Returns: sdo (0-100 score), highCount/mediumCount/lowCount/informationCount (errors by priority), checkedPageCount (pages scanned), progress (0-100), stoped flag, captchaDetected flag, redirectCount. Lightweight method, does not consume API credits. For detailed analysis use get_site_audit_results_by_categories or get_site_audit_deteailed_report.
Inputs: reportId (required).
get_site_audit_deteailed_reportA
Get COMPLETE error breakdown organized by categories. Main method for detailed audit analysis. Returns categories array, each with errors array containing: key (error identifier like 'no_desc', 'h1_missing'), priority (high/medium/low/information), countAll (total errors), countNew (new vs compareReportId), countFixed (fixed vs compareReportId). Use compareReportId parameter to track changes between audits. Use error.key with get_site_audit_history (track across all audits) or get_site_audit_pages_spec_errors (see affected pages). Does not consume API credits.
Inputs: reportId (required), compareReportId.
get_site_audit_elements_with_issuesA
DRILL-DOWN STEP 2: Shows WHERE a problematic element is used. Use crc from get_site_audit_pages_spec_errors response. ONLY works for hierarchical errors (images, scripts, links). Does NOT work for page-level errors (no_desc, no_title, h1_missing) - returns 'Error don't have sub elements'. Example: Step 1 finds image without alt (imageCrc=12345), Step 2 shows which pages use that image. The crc parameter must match urlCrc/imageCrc from previous method. Does not consume API credits.
Inputs: reportId (required), projectId (required), errorName (required), crc (required), +4 more.
get_site_audit_historyA
Track how a SPECIFIC error type changed over time across all audits in project. Returns array with reportId, date, and count for each audit. Use this to: verify if fixes are working (count should decrease), monitor if errors are growing, track specific problem areas. The errorName must be from the fixed enum list (same as error.key from get_site_audit_deteailed_report). Example: errorName='no_desc' shows trend of pages without meta description. Does not consume API credits.
Inputs: projectId (required), errorName (required), limit, offset.
get_site_audit_pages_spec_errorsA
DRILL-DOWN STEP 1: Get list of elements (pages/images) with specific error. Returns: url (problematic page or image URL), urlCrc/imageCrc (unique numeric ID for drill-down), count (occurrences). The CRC is used with get_site_audit_elements_with_issues for deeper analysis. Mode parameter: 'all' (all errors), 'new' (new vs compareReportId), 'solved' (fixed vs compareReportId). Example flow: get pages with 'image_no_alt' error โ get imageCrc โ use with get_site_audit_elements_with_issues to see which pages use that image. Does not consume API credits.
Inputs: reportId (required), compareReportId (required), projectId (required), errorName (required), +3 more.
get_site_audit_project_default_settingsA
Get DEFAULT TEMPLATE settings for creating new projects (NOT settings of existing project). Returns server-side recommended defaults. Use this to: populate new project form with sensible defaults, avoid hardcoding values, ensure settings stay current if Serpstat changes recommendations. Workflow: 1) Call this method, 2) Modify returned object (set domain, name, adjust limits), 3) Call set_site_audit_settings to save. Key differences from project settings: domain='' (must set), name='' (must set), pagesLimit=5000 (default), scheduleRepeatOption=3 (weekly). Does not consume API credits and does not require projectId.
Inputs: no named parameters.
get_site_audit_results_by_categoriesA
Get AGGREGATED error statistics by category. Returns sum of errors grouped by priority for each category. Each category shows: highCount, mediumCount, lowCount, informationCount. Use this for quick overview to identify problematic categories. Categories are fixed: pages_status, meta_tags, headings, content, multimedia, indexation, redirects, links, server_params, https, hreflang, amp, markup, pagespeed_desktop, pagespeed_mobile. Does not consume API credits. For specific error breakdown use get_site_audit_deteailed_report.
Inputs: reportId (required).
get_site_audit_scanned_urls_listA
Get CONFIGURED URL list for scanning (not actual scan results). ONLY works when scanSetting.type is 2 (URL list) or 3 (sitemap list). Returns error 'Scan url list not found' when type=1 (scan all site) because no specific URLs are configured. This shows INPUT configuration, not OUTPUT of what was scanned. Check get_site_audits_list response for actual scanned page count. Does not consume API credits.
Inputs: projectId (required).
get_site_audit_settingsA
Get current configuration of EXISTING audit project. Returns: mainSettings (domain, name, pagesLimit, scanSpeed, scanDuration, userAgent, robotsTxt, etc), scan filters (keywords to include/exclude), authentication, email notifications, scheduling, error thresholds. Compare with get_site_audit_project_default_settings which returns template for NEW projects. Does not consume API credits.
Inputs: projectId (required).
get_site_audits_listA
STARTING POINT for audit analysis. Returns list of all audit reports for a project. Use reportId from response with other audit methods. Returns: reportId (use with other methods), date, SDO score (0-100), pages scanned/limit, critical/non-critical issue counts, viruses, progress (0-100), completion status, hasDetailData flag (true=full data available, false=in progress/failed). Does not consume API credits. TIP: Sort by date to get most recent audit first.
Inputs: projectId (required), limit, offset.
get_threat_backlinksA
Get malicious backlinks pointing to the analyzed domain. Returns links from sites flagged for threats like social engineering, malware, or unwanted software. Shows referring domain, source URL, target URL, platform type, threat type, and last update date. Essential for identifying and removing harmful backlinks that could damage domain reputation and SEO rankings.
Inputs: query (required), searchType, sort, order, +3 more.
get_top10_anchorsB
Get TOP-10 anchors with the number of backlinks and referring domains for domain analysis, use this method is you need a fast brief way to get info about top 10 anchors
Inputs: query (required), searchType.
get_top_pages_by_backlinksC
Get leading pages by backlinks using Serpstat API. Returns pages with the highest number of referring pages, domains, and IP addresses for comprehensive backlink analysis.
Inputs: query (required), searchType, sort, order, +2 more.
get_url_competitorsA
Returns competitor URLs that rank for the same keywords in Google top-10. The analyzed URL must rank for 10+ keywords in top-10 to have competitor data available. Returns 'Data not found' error for new or low-traffic pages with few ranking keywords, URLs not found in Serpstat database, or pages without sufficient top-10 keyword overlap with competitors. The URL parameter must include protocol https://. Best results for established pages with significant organic traffic. API cost: 1 credit per result row returned.
Inputs: se (required), url (required), sort, page, +1 more.
get_url_keywordsA
Returns a list of keywords for which the specified URL ranks in top-100 Google search results. Provides comprehensive insights including current positions, estimated traffic per keyword, keyword difficulty, search volume, and SERP features. Use filters to narrow down by position range, search volume, difficulty, or keyword patterns. API cost: 1 credit per result row returned.
Inputs: se (required), url (required), withIntents, sort, +3 more.
get_url_missing_keywordsA
Identifies keyword opportunities by finding keywords where your competitors rank in top-20 but your URL does not. The weight metric returned in results indicates how many competitor URLs from top-20 rank for that keyword. Higher weight means more competitors are targeting this keyword, suggesting it is valuable for your niche. Perfect for content gap analysis and finding quick wins. API cost: 1 credit per result row returned.
Inputs: url (required), se (required), sort, filters, +2 more.
get_url_summary_traffA
Returns traffic and keyword statistics for website pages that match a specific URL mask. Shows organic traffic and number of keywords found for URLs matching the given pattern. HIGH-COST METHOD - EXPLICIT CONFIRMATION REQUIRED. Before executing, inform the user:
This operation will cost 1000-2000 credits. API COST: 1000 credits per each of traffic|keywords output parameter
Inputs: se (required), domain (required), urlContains (required), output_data.
list_projectsB
Retrieve a list of projects associated with the account, with pagination support
Inputs: page, size.
page_audit_deleteB
Remove one-page audit project from customer project list. Returns boolean indicating success. Does not consume API credits.
Inputs: pageId (required).
page_audit_get_last_scansA
Get list of all one-page audit projects. Returns page info including: pageId (use with other methods), url, name, status, lastActiveReport (latest scan results with SDO score and issue counts), finishedReportCount, settings. Use this as starting point to find pageId for other operations. Does not consume API credits.
Inputs: limit, offset, teamMemberId.
page_audit_get_report_by_categoriesA
Get audit results by categories for a specific report. Returns categories array with errors grouped by type (meta_tags, headings, content, multimedia, https, etc), page data, and report info. Use compareReportId to see changes between reports (countNew shows errors added since compareReportId, countFixed shows errors resolved since compareReportId). Does not consume API credits.
Inputs: reportId (required), compareReportId.
page_audit_get_reports_for_pageA
Get history of all audit reports for a specific page. Returns array of reports with: id (reportId), auditDate, status, sdo (0-100 score), high/medium/low/information error counts, viruses, progress (0-100). Use this to track scan completion and view historical results. Status values: 1=in progress, 3=finalizing, 4=completed. Sort by auditDate to get most recent first. Does not consume API credits.
Inputs: pageId (required), limit, offset.
page_audit_get_results_reportA
Get detailed audit results for a page. Returns: categories array (errors grouped by category like meta_tags, headings, content, multimedia, https, pagespeed_desktop, pagespeed_mobile, etc), data array (page details), report object (SDO score, error counts, progress). Each category contains errors with: key (error identifier), priority (high/medium/low/information), countAll/countNew/countFixed, hasAdditionRows (true means drill-down available via page_audit_report_drill_down). Use this to analyze specific issues found during scan. Does not consume API credits.
Inputs: pageId (required).
page_audit_get_scan_namesA
Get list of all one-page audit project names. Returns array of pages with: pageId, name, url, finishedReportCount. Use this to discover available audit projects. Does not consume API credits.
Inputs: teamMemberId.
page_audit_report_drill_downA
Get detailed list of problematic elements for specific error types. ONLY works for errors with hasAdditionRows=true from page_audit_get_results_report response. Returns error 'Try get additional rows in rows-less error' for page-level errors where hasAdditionRows=false. Response structure varies by error type: for multimedia errors (image_no_alt, large_image_size, broken_image_url) returns array of image URLs that have the issue; for page-level errors (miss_favicon, etc) returns array with single object containing page URL. Always check hasAdditionRows flag before calling this method. Does not consume API credits.
Inputs: reportId (required), error (required), mode, compareReportId, +2 more.
page_audit_rescanA
Rescan existing one-page audit project. Creates new audit report for the page. Returns reportId for the new scan. API COST: 10 credits per rescan. Use page_audit_get_reports_for_page to track progress.
Inputs: pageId (required), name (required), userAgent (required), httpAuthLogin, +1 more.
page_audit_scan_logsA
Get chronological log of scan events for debugging and progress tracking. Returns array of log items with: message (event name like audit_finish, crawl_start, server_check_robots_pass), type (info/warning/error), params (object with event-specific data, may be empty array if no additional info, e.g., {sdo: 64} or []), created_at (timestamp). Useful for debugging scan issues and understanding scan progress. Supports pagination via page and pageSize parameters. Does not consume API credits.
Inputs: reportId, page, pageSize.
page_audit_start_scanA
Scan a single webpage with JavaScript rendering. Returns pageId and reportId for tracking. Use page_audit_get_reports_for_page to check progress via status and progress fields. API COST: 10 credits per scan. Wait for progress=100 before retrieving results with page_audit_get_results_report.
Inputs: name (required), url (required), userAgent (required), httpAuthLogin, +1 more.
page_audit_stopA
Stop active one-page audit scan. Returns boolean indicating success. Does not consume API credits.
Inputs: pageId (required).
set_site_audit_settingsA
Update or create audit project configuration. Use get_site_audit_project_default_settings to get template, then modify and save with this method. Required fields: mainSettings (domain, name, subdomainsCheck, pagesLimit, scanSpeed, etc), scanSetting (type: 1=all site, 2=URL list, 3=sitemap), scheduleSettings, mailTriggerSettings, baseAuthBlock, keyword filters. Does not consume API credits.
Inputs: projectId (required), mainSettings (required), dontScanKeywordsBlock (required), onlyScanKeywordsBlock (required), +5 more.
start_site_auditA
Launch audit scan for a project. Returns reportId to track progress. Check completion with get_site_audits_list (progress field). API COST: 1 credit per page without JS rendering, 10 credits per page with JS rendering (scanJsPage setting). Wait for progress=100 before analyzing results.
Inputs: projectId (required).
stop_site_auditA
Stop active audit scan for a project. Partial results may be available. Check get_site_audits_list to see if audit was stopped (stoped field).
Inputs: projectId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 65 tools
Most tools have distinct purposes with clear resource-action pairs, but there is significant overlap in some areas, such as multiple backlink analysis tools (get_active_backlinks, get_backlinks_summary, get_lost_backlinks, get_threat_backlinks) and keyword analysis tools (get_keywords, get_keywords_info, get_related_keywords), which could cause confusion. Descriptions help differentiate them, but the sheer number of similar tools increases ambiguity.
Tool names follow a consistent verb_noun pattern with snake_case throughout, such as 'get_domain_keywords' and 'start_site_audit'. Minor deviations exist, like 'page_audit_get_last_scans' using 'get' as a prefix rather than a verb, but overall the naming is predictable and readable.
With 65 tools, the count is excessive for an MCP server, making it overwhelming and difficult for agents to navigate. While Serpstat's domain is broad (SEO, audits, rank tracking), the tool set feels bloated with many specialized or overlapping tools that could be consolidated.
The tool set provides comprehensive coverage for Serpstat's domain, including project management, backlink analysis, keyword research, site audits, and rank tracking. It supports full CRUD operations (e.g., create/delete projects, start/stop audits) and lifecycle management, with no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
Live SEO intelligence, rank tracking, site audits, and backlink analysis for AI agents.
Live SEO data for AI agents: SERP competition, keywords, backlinks, site audits, AI visibility.
Real SEO data for AI assistants: page audits, Keyword Planner volumes, Search Console history.
SEO, GEO & AI Visibility Intelligence directly inside AI assistants. Chat with SEO in plain language: research keywords, analyze SERPs, track competitors, and monitor AI visibility. SeoPerseo's integrated intelligence reveals site issues and how to fix them, create client reports and generate content for your website. Fully integrated with Google Search Console and Google Analytics.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides AI assistants with access to Semrush SEO API functionality including domain analytics, keyword research, backlink analysis, and competitor insights.716MIT
- AlicenseCqualityDmaintenanceConnects AI assistants to SE Ranking's SEO and project management APIs to enable natural language queries for keyword research, backlink analysis, and technical audits. It supports comprehensive tasks including competitive analysis, domain traffic tracking, and AI search visibility monitoring.1001Apache 2.0
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to SEO APIs for backlinks analysis, keyword research, and traffic analysis.124 npm28MIT

Babbar MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceIntegrates with the Babbar.tech SEO API to enable AI assistants to perform advanced SEO analysis, competitor research, backlink auditing, and content gap identification.2MIT