seo-webmaster-mcp
Summary: A single MCP server that gives AI assistants organic search analytics, URL indexing diagnostics, sitemap health checks, and instant indexing across Google Search Console, Bing Webmaster Tools, and IndexNow.
Check provider health (
engine_status) — verify configuration/connection status for all integrated search engines, with setup guidance.List properties (
list_sites) — enumerate verified sites across Google and Bing with permission levels.Query search analytics (
search_analytics) — pull clicks, impressions, CTR, and average position grouped by query, page, country, device, searchAppearance, or date, with row limits/pagination, filters (text, exact, regex), search verticals (web, image, video, news, discover, googleNews), and data-freshness control.Inspect URLs (
inspect_url) — check live index status, crawl info, canonical URLs, mobile usability, and rich-results/schema validation (Google live; Bing returns coarse stats marked UNKNOWN).Monitor sitemaps (
list_sitemaps,get_sitemap) — list submitted sitemaps with errors, last download dates, and indexed URL counts, or pull deep metrics for one feed.Instant indexing (
submit_urls_indexnow) — push added/updated/deleted URLs to Bing, Yandex, Seznam, and other IndexNow engines (up to 10,000), optionally passing key/keyLocation.Note: the README also documents
submit_urls_google(Google Indexing API, 200 URLs/day), but that tool is not present in the server schema.
Provides tools for querying search performance data (clicks, impressions, CTR, position) from Google Search Console, inspecting URL indexing status, and managing sitemaps.
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., "@seo-webmaster-mcp What were my top 10 Google queries last week for example.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.
seo-webmaster-mcp
A unified Model Context Protocol (MCP) server providing AI assistants (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Zed, etc.) with comprehensive organic search analytics, URL inspection, sitemap health monitoring, and instant search engine indexing across Google Search Console, Google Indexing API, Bing Webmaster Tools, and IndexNow.
🚀 Quickstart (Running in 2 Minutes)
You do not need to configure all engines. All engines are completely optional!
If you only have Google Search Console, only configure Google.
If you only have Bing Webmaster Tools, only configure Bing.
If you want instant indexing without API keys, you can use IndexNow.
If you configure nothing, start the server and ask your AI: "Check engine status" to see step-by-step setup guides!
Option A: Run via npx (Recommended)
No cloning required. Your MCP client will download and run the latest version automatically.
1. Claude Desktop
Add to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"seo-webmaster": {
"command": "npx",
"args": ["-y", "@itsaakashpatel/seo-webmaster-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/gsc-key.json",
"BING_WEBMASTER_API_KEY": "your_bing_api_key",
"INDEXNOW_KEY": "your_indexnow_key"
}
}
}
}2. Cursor
Add to .cursor/mcp.json (project-level) or Cursor Settings → Features → MCP Servers:
{
"mcpServers": {
"seo-webmaster": {
"command": "npx",
"args": ["-y", "@itsaakashpatel/seo-webmaster-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/gsc-key.json",
"BING_WEBMASTER_API_KEY": "your_bing_api_key",
"INDEXNOW_KEY": "your_indexnow_key"
}
}
}
}3. Claude Code CLI
Add to ~/.claude.json:
{
"mcpServers": {
"seo-webmaster": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@itsaakashpatel/seo-webmaster-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/gsc-key.json",
"BING_WEBMASTER_API_KEY": "your_bing_api_key",
"INDEXNOW_KEY": "your_indexnow_key"
}
}
}
}Related MCP server: search-console-mcp
🛠️ Step-by-Step Setup Guide
1. Google Search Console & Google Indexing API
Both Search Console and Indexing API use theexact same service account credentials.
Create a Cloud Project: Go to Google Cloud Console and create a project (e.g.
my-seo-tools).Enable APIs:
In APIs & Services → Library, search for Google Search Console API and click Enable.
(Optional for instant Google push) Search for Indexing API (
indexing.googleapis.com) and click Enable.
Create Service Account:
Go to APIs & Services → Credentials → Create Credentials → Service Account.
Name it (e.g.
gsc-reader), click Create and Continue, then Done.
Generate JSON Key File:
Click on the created service account email.
Go to the Keys tab → Add Key → Create new key → JSON.
Save the downloaded file somewhere safe on your computer (e.g.,
~/.config/gcloud/gsc-key.json).
Grant Property Access in Search Console:
Copy the service account's email address (e.g.
gsc-reader@my-seo-tools.iam.gserviceaccount.com).Open Google Search Console.
Select your property → Settings (bottom left) → Users and permissions → Add user.
Paste the service account email:
For read-only search analytics: select Restricted or Full.
If using Google Indexing API: select Owner (required by Google to publish indexing requests).
Set Environment Variable:
Set
GOOGLE_APPLICATION_CREDENTIALSto the absolute path of your downloaded JSON file.Alternatively, you can paste the raw JSON string or base64 into
GOOGLE_SERVICE_ACCOUNT_KEY.
2. Bing Webmaster Tools
Sign in to Bing Webmaster Tools and ensure your site is verified.
Click the Settings gear icon (top right) → API Access → API Key.
Generate an API Key and copy it.
Set the
BING_WEBMASTER_API_KEYenvironment variable in your MCP configuration.
3. IndexNow (Instant Indexing to Bing, Yandex, Seznam, Naver)
IndexNow allows search engines to instantly discover updated, new, or deleted URLs without waiting for crawlers.
Generate a Key: Create a random 32-character hexadecimal key (or use Bing's Key Generator).
Host the Verification File:
Place a text file named
<your-key>.txtcontaining only the key at your website root:https://example.com/<your-key>.txtConfirm it opens in your browser and displays only the key string.
Set Environment Variable:
Set
INDEXNOW_KEYto your key string.(Optional) If your key file is hosted in a subfolder or custom URL, set
INDEXNOW_KEY_LOCATIONto the full URL (e.g.https://example.com/assets/my-key.txt).
🧰 Available MCP Tools
Tool | Engine | Description |
All | Check connection and configuration health across all 4 search engine providers with setup tips. | |
Google & Bing | List all verified website properties with user permissions/roles. | |
Google & Bing | Query clicks, impressions, CTR, and average position grouped by query, page, country, device, and date. | |
Google & Bing | Inspect live URL index status, crawl dates, canonical tags, mobile usability, and rich results schema. | |
Google & Bing | List submitted sitemaps, error/warning counts, crawl timestamps, and indexed URL breakdown. | |
Google & Bing | Retrieve deep indexing statistics for a specific sitemap feed. | |
IndexNow | Instantly notify Bing, Yandex, and partner engines about up to 10,000 published/updated/deleted URLs. | |
Google Indexing | Push up to 200 URLs/day to Google via the Indexing API ( |
1. engine_status
No parameters required.
2. list_sites
Parameter | Type | Required | Description |
| string | No | Filter by engine: |
3. search_analytics
Parameter | Type | Required | Description |
| string | Yes | Site URL as verified in Search Console (e.g. |
| string | Yes | Start date in |
| string | Yes | End date in |
| string | No | Provider: |
| string | No | Comma-separated: |
| number | No | Max rows to return (default: |
| string | No | Vertical: |
| string | No |
|
| string | No | Filter queries: |
| string | No | Filter page URLs: same syntax as |
| string | No | ISO 3166-1 alpha-3 code (e.g. |
| string | No |
|
| number | No | Pagination row offset (default: |
4. inspect_url
Parameter | Type | Required | Description |
| string | Yes | Site URL as verified in Search Console |
| string | Yes | Fully qualified URL to inspect |
| string | No |
|
| string | No | Language code for localized messages (default: |
5. list_sitemaps
Parameter | Type | Required | Description |
| string | Yes | Site URL as verified in Search Console |
| string | No |
|
6. get_sitemap
Parameter | Type | Required | Description |
| string | Yes | Site URL as verified in Search Console |
| string | Yes | Full URL or path to the sitemap feed |
| string | No |
|
7. submit_urls_indexnow
Parameter | Type | Required | Description |
| string | Yes | Domain name without protocol (e.g. |
| string | Yes | Comma/newline-separated list of full URLs (or JSON array) |
| string | No | IndexNow key (optional if |
| string | No | Full URL to key file if hosted in custom location |
8. submit_urls_google
Parameter | Type | Required | Description |
| string | Yes | Comma/newline-separated full https URLs (or JSON array). Max 200 per call |
| string | No |
|
Google Indexing API note: Only pages containing
JobPostingorBroadcastEvent(inVideoObject) structured data are supported by Google. Default daily quota is 200 requests.
💬 Example AI Assistant Prompts
Once configured in Claude or Cursor, you can interact with your search data in plain English:
"Check search engine provider status to see what is connected."
"List all my verified websites across Google and Bing."
"Show me the top 20 queries for my site on Google over the last 28 days."
"Find pages that get high impressions but low click-through rates (CTR < 2%)."
"Inspect https://example.com/blog/latest-post and tell me if it has any schema errors or mobile usability issues."
"Check all submitted sitemaps for my site and report indexing health."
"I just published 5 new blog posts: [URL list]. Submit them to IndexNow immediately."
"Notify Google that these 2 job postings were updated via the Indexing API."
❓ Troubleshooting & FAQs
1. Permission error (403): User does not have sufficient permission
Cause: The service account has not been added as a user to your property in Google Search Console.
Fix: In Google Search Console, go to Settings → Users and permissions → Add user and paste the exact email of your service account.
2. Site URL not found
Cause: Search Console differentiates between domain properties (
sc-domain:example.com) and URL prefix properties (https://example.com/).Fix: Run the
list_sitestool first to view the exact property string format for your website.
3. Bing Webmaster API authentication failed (401)
Cause: Missing or invalid
BING_WEBMASTER_API_KEY.Fix: Re-generate your API key in Bing Webmaster Tools (Settings → API Access → API Key) and ensure there are no leading/trailing spaces in your config.
4. Bing URL inspection returns UNKNOWN
Explanation: Unlike Google, the Bing Webmaster Tools API does not offer URL-level live inspection. The server returns coarse crawl stats if available, and transparently marks inspection verdict as
UNKNOWNrather than fabricating data.
💻 Local Development & Contributing
Contributions are welcome! Please ensure all pull requests follow the project standards.
# Clone the repository
git clone https://github.com/itsaakashpatel/seo-webmaster-mcp.git
cd seo-webmaster-mcp
# Install dependencies
npm install
# Compile TypeScript
npm run build
# Run unit tests
npm test
# Run linter (oxlint)
npm run lint
# Check code formatting (oxfmt)
npm run format:checkPull Requests
When opening a pull request, please use the template located at .github/pull_request_template.md and adhere to the guidelines in AGENTS.md.
📄 License
MIT © Aakash Patel
Available Tools
7 toolsengine_statusA
Check the configuration and connection status of all integrated search engine providers (Google Search Console, Bing Webmaster Tools, IndexNow).
Inputs: no named parameters.
get_sitemapB
Retrieve deep indexing and error metrics for a specific sitemap feed.
Inputs: siteUrl (required), feedpath (required), engine.
inspect_urlA
Inspect a URL in Google Search Console or Bing Webmaster Tools to check live indexing status, crawl info, canonical URLs, mobile usability, and rich results (schema validation).
Inputs: siteUrl (required), inspectionUrl (required), engine, languageCode.
list_sitemapsA
List all submitted sitemaps and their current status, last download date, error counts, and indexed URL counts.
Inputs: siteUrl (required), engine.
list_sitesA
List all verified sites (properties) across Google Search Console and Bing Webmaster Tools, along with permission levels.
Inputs: engine.
search_analyticsA
Query search performance and analytics data (clicks, impressions, CTR, average position) across Google Search Console or Bing Webmaster Tools.
Inputs: endDate (required), siteUrl (required), startDate (required), engine, +9 more.
submit_urls_indexnowA
Instantly notify Bing, Yandex, Seznam, and other IndexNow search engines about added, updated, or deleted URLs on your website.
Inputs: host (required), urls (required), key, keyLocation.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct function: status, site listing, URL inspection, analytics, sitemap listing, sitemap details, and URL submission. The only slight overlap is list_sitemaps vs get_sitemap, but the descriptions clearly separate listing all sitemaps from retrieving deep metrics for one specific sitemap.
Tool names mostly follow a consistent verb_noun pattern: engine_status, list_sites, inspect_url, search_analytics, list_sitemaps, get_sitemap, submit_urls_indexnow. Minor inconsistency: engine_status and search_analytics use noun-ish names rather than a verb, but the pattern is still readable and predictable.
Seven tools is well-scoped for an SEO/webmaster server covering multiple search engines. Each tool covers a distinct core workflow: status, site management, URL inspection, analytics, sitemaps, and IndexNow submission.
The surface covers the main SEO webmaster workflows: verification status, site listing, URL inspection, analytics, sitemap management, and IndexNow submission. Minor gaps include lack of tools for adding/removing sites, submitting sitemaps, or managing crawl settings, but agents can still accomplish core monitoring and diagnostics.
Maintenance
Related MCP Connectors
Google Search Console, Bing, Yandex and IndexNow for AI assistants, with live SEO analyses.
Google Search Console for AI assistants: traffic, rankings, indexing and page checks. Read-only.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Read-only Google Search Console, Bing, Google Analytics and privacy-friendly analytics for your AI.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to query and manage Google Search Console data, including search analytics, URL indexing status, and sitemap management, for SEO and LLMO analysis directly from a conversation.15MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access Google Search Console search performance and index health data, including clicks, impressions, rankings, URL inspection, and sitemap management.22 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to analyze Google Search Console SEO data through natural language, including search analytics, URL inspection, sitemap management, and property management.21MIT
- AlicenseAqualityBmaintenanceEnables AI agents to query and analyze Google Search Console data, including search analytics, URL inspection, sitemaps, and property verification, and to perform actions like submitting sitemaps and adding properties through natural language.1924 npm1MIT