Serpstat MCP Server

What it is

A Java MCP server over the Serpstat API. It covers the standard SEO research loop: understand a domain, find the keywords it ranks for, find who competes with it, and expand a seed keyword into related terms — with a tool that reports remaining API credits, because most of the others consume them.

What you get

• get_domains_info — visibility, keyword count, estimated traffic, dynamics and PPC data for several domains at once
• domain_regions_count — keyword count by country across every Google regional database — the recommended first step on any complex domain analysis
• domain_keywords — the keywords a domain ranks for, with position, traffic and difficulty
• get_domain_competitors — the top 20 competitors from search results with traffic, visibility and relevance scores
• get_backlinks_summary — referring domains, backlink counts, link types, quality metrics and recent changes for a domain or subdomain
• get_keywords — related keyword research with volume, cost per click, difficulty and SERP features; costs 1 API credit per keyword returned
• keyword_competitors — the top-20 domains competing for one keyword, with a graded competition assessment and filtering by domain list, traffic range, visibility and relevance; each competitor costs 1 credit, with a minimum of 1 credit per request even when the result is empty
• get_related_keywords — semantically related terms with connection strength, intent distribution and SERP feature presence, filterable by volume, difficulty and pattern; priced the same way
• api_stats — remaining credits and usage percentage, and projects_list for your Serpstat projects, which does not consume credits

Requirements

A Serpstat API token from a Team or higher subscription with API access, supplied as SERPSTAT_API_TOKEN. Java 17 or newer and Maven 3.6 or newer; build with mvn clean package and point the client at the jar with java -jar. Set LANG and LC_ALL to a UTF-8 locale — on Windows the documented config also passes -Dfile.encoding=UTF-8 — or non-ASCII results come back mangled. This is labelled an alpha release, v0.0.2. Logs are written to logs/serpstat-mcp-server.log and rotated.

Setup effort

Follow the published steps — sudo apt-get install openjdk-17-jre

Tools you get

10 tools named in the project's documentation. This is an alpha release (v0.0.2) with tools still being added, so builds from newer commits may expose more.

Requires

• Java 17+
• Maven 3.6+
• SERPSTAT_API_TOKEN in your environment

Where it runs

Both documented setups run the server on your machine.