Google's Search Console API Fails Silently, So I Built an MCP Server That Doesn't
An open-source, local, read-only MCP server that checks your request before Google quietly hands back nothing Ask the Google Search Console API for clicks filtered by country us and you get zero rows. No error, no warning, just nothing. It's not the only one.
This article discusses the challenges of using the Google Search Console API, which often returns empty results without errors, and presents an open-source solution to address these issues.
What happened
The article highlights the limitations of the Google Search Console API, which often returns empty results without any error messages for malformed requests. The author developed a local, read-only MCP server that validates requests before sending them to the API, ensuring that errors are caught and communicated clearly.
Why it matters
This matters to AI developers and SEO professionals because it provides a reliable way to debug and analyze Search Console data, which is crucial for understanding user behavior and optimizing search performance.
- The Google Search Console API can return empty results without errors for malformed requests.
- A local MCP server can validate requests and provide clear error messages.
- The tool is open-source and can be used by developers and SEO professionals.
- It supports multiple search surfaces and provides structured data for analysis.
- The solution helps in debugging and optimizing search performance.
The bigger picture
The tool improves the accuracy and reliability of Search Console data analysis, helping users identify and fix issues that might otherwise go unnoticed due to silent API responses.
The article presents a practical solution to the limitations of the Google Search Console API by providing a local MCP server that validates requests and improves the accuracy of data analysis.
Technical details
- The MCP server connects to the Search Console API using Model Context Protocol.
- It validates requests against the live API using a probe script.
- It handles combinations of invalid dimensions and returns a 400 error with explanations.
- The server stores login credentials and audit progress in an SQLite file.
- It supports multiple search surfaces like Discover, Images, and News.
FAQ
Why does the Google Search Console API return empty results?
The API often returns empty results without errors for malformed requests, making it difficult to identify the issue.
What is the MCP server?
It is a local, read-only server that connects to the Search Console API and validates requests before sending them.
How does the server handle invalid requests?
The server checks for common issues like invalid regex, incorrect country codes, and unsupported dimensions, and provides clear error messages.
Is the tool open-source?
Yes, the tool is open-source and available under the MIT license on PyPI and GitHub.
What are the benefits of using this tool?
It improves the accuracy and reliability of Search Console data analysis, helping users identify and fix issues that might otherwise go unnoticed.
This summary and analysis were generated with AI from the original article and may contain errors. Read the original for the full story.
Read the full story
Originally published by Dev.to AI on Oct 15, 2026.
Comments
Sign in to join the discussion.