serpstat -java

The Serpstat MCP Server is a Java-based integration that exposes Serpstat API capabilities through the MCP (Model Context Protocol). It provides a set of tools to analyze domains, keywords, and backlinks by connecting Claude or other MCP-enabled clients to Serpstat's API. Tools available include: get_domains_info for overall domain visibility and traffic metrics; domain_regions_count to compare keyword presence across Google regional databases; domain_keywords to fetch keywords a domain ranks for with metrics like position and difficulty; get_domain_competitors to pull top domain competitors; get_backlinks_summary for backlinks insights; api_stats to monitor API usage and credits; projects_list to enumerate user projects; get_keywords and keyword_competitors for keyword research and competitive analysis; get_related_keywords for semantically related terms. Running the server with a valid SERPSTAT_API_TOKEN allows client applications to request these capabilities via the MCP interface, returning structured SEO data for analysis and reporting.

Prerequisites:

• Java 17 or newer
• Maven 3.6+ (for building the server JAR)
• A valid Serpstat API token

Installation steps:

1. Install Java (if needed):

   sudo apt-get update
   sudo apt-get install openjdk-17-jre
   

2. Install Maven (if needed):

   sudo apt-get update
   sudo apt-get install maven
   

3. Clone or create the project directory:

   mkdir serpstat-mcp-server
   cd serpstat-mcp-server
   

4. Build the MCP server JAR:

   mvn clean package
   

5. Prepare a test invocation script (example from documentation):

   cp inspect.sh.example inspect.sh
   chmod +x inspect.sh
   # edit file and set token
   vi inspect.sh
   ./inspect.sh
   

6. Run the server via the MCP integration configuration (example command):

   # Ensure the jar path is correct and token is set in env
   java -jar serpstat-mcp-server-java-0.0.2.jar
   

Tips and caveats:

• Ensure your SERPSTAT_API_TOKEN is kept secret and not committed to public repos.
• The integration expects the jar at the path specified in the mcp_config. Update the path accordingly for your environment.
• You may need to set locale environment variables (LANG/LC_ALL) to avoid encoding issues, as shown in the example config.
• If Claude Desktop or similar clients require a different config, you can adapt the JSON example provided in the README for Windows or other OSes.
• Logs are typically written to logs/serpstat-mcp-server.log; monitor for errors or rate-limit messages from Serpstat.
• When testing, start with api_stats to confirm tokens and credits are available before performing heavy requests.