grain-seo-mcp
Integrates with Google Analytics 4 (GA4) for analytics and SEO analysis, including tools for topic cluster performance and content recommendations.
Provides tools for SEO analysis using Google Search Console data, such as detecting content decay, diagnosing traffic drops, benchmarking CTR, and verifying claims.
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., "@grain-seo-mcp analyze content decay for my top pages"
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.
grain-seo-mcp
SEO analysis MCP server — Google Search Console, Bing Webmaster Tools, GA4 analytics, with custom Grain Analysis Tools.
English | 简体中文
Grain Analysis Tools (new)
Tool | What it does |
| Detect pages with 3 consecutive 30-day traffic decline |
| Diagnose WHY traffic dropped: ranking loss / CTR collapse / demand decline |
| Compare CTR vs industry benchmarks by position |
| Anti-hallucination: re-query GSC to verify numeric claims (±5% tolerance) |
| Aggregate performance for URL path patterns (e.g. /blog/) |
| Prioritized SEO actions: update / create / consolidate |
Related MCP server: mcp-seo-audit
Platform Tools
Google Search Console, Bing Webmaster Tools, Google Analytics 4 tools. See tools_list.md for full list.
Setup
Google Cloud Credentials
Go to Google Cloud Console
Create project, enable Search Console API
Create OAuth credentials (Desktop app) or Service Account
Download JSON
Claude Code Configuration
Add to ~/.claude/settings.json:
{
"mcpServers": {
"grain-seo": {
"command": "node",
"args": ["/Users/bobby/Projects/Github/zhangluka/grain-seo-mcp/dist/index.js"],
"env": {
"GSC_OAUTH_SECRETS_FILE": "/path/to/client_secrets.json"
}
}
}
}First use opens browser for Google sign-in. Token cached after that.
License
MIT
Available Tools
104 toolsaccounts_add_siteC
Authorize a specific site or domain for an account (Account Boundary)
Inputs: accountId (required), site (required).
accounts_listA
List all authorized Google and Bing accounts
Inputs: no named parameters.
accounts_removeC
Remove an authorized account
Inputs: accountId (required).
analytics_anomaliesB
Identify unusual daily spikes or drops in traffic.
Inputs: siteUrl (required), days, threshold.
analytics_audience_segmentsB
Get audience segmentation (New vs Returning, Age, OS) in a single batch
Inputs: propertyId (required), startDate (required), endDate (required), accountId.
analytics_by_countryB
Get performance breakdown by country for the last N days.
Inputs: siteUrl (required), days, limit, sortBy.
analytics_compare_periodsA
Compare performance metrics between two date periods. Useful for week-over-week or month-over-month analysis.
Inputs: siteUrl (required), period1Start (required), period1End (required), period2Start (required), +1 more.
analytics_content_performanceB
Analyze content performance by Content Group in GA4 (Requires Content Groups to be configured in GA4 Admin)
Inputs: propertyId (required), startDate (required), endDate (required), accountId, +2 more.
analytics_conversion_funnelC
Analyze top converting pages and events
Inputs: propertyId (required), startDate (required), endDate (required), accountId, +1 more.
analytics_drop_attributionA
Analyze a significant traffic drop to identify if it was caused by specific devices (mobile/desktop) or coincides with known Google algorithm updates.
Inputs: siteUrl (required), days, threshold.
analytics_ecommerceB
Get ecommerce performance (products, revenue) from GA4
Inputs: propertyId (required), startDate (required), endDate (required), accountId, +2 more.
analytics_organic_landing_pagesC
Get performance of organic landing pages in GA4 (matches GSC data)
Inputs: propertyId (required), startDate (required), endDate (required), accountId, +2 more.
analytics_page_performanceB
Get detailed page performance metrics from GA4 (sessions, views, engagement)
Inputs: propertyId (required), startDate (required), endDate (required), accountId, +4 more.
analytics_pagespeed_correlationB
Correlate GA4 engagement metrics with PageSpeed Insights scores for top organic pages
Inputs: propertyId (required), domain (required), startDate (required), endDate (required), +3 more.
analytics_performance_summaryA
Get the aggregate performance metrics (clicks, impressions, CTR, position) for the last N days.
Inputs: siteUrl (required), days, engine.
analytics_queryC
Query search analytics data with optional pagination
Inputs: siteUrl (required), startDate (required), endDate (required), dimensions, +7 more.
analytics_realtimeA
Get realtime active users broken down by page, country, and device
Inputs: propertyId (required), accountId.
analytics_search_appearanceA
Get performance breakdown by search appearance type for the last N days.
Inputs: siteUrl (required), days, limit, sortBy.
analytics_time_seriesA
Get advanced time series data including rolling averages, seasonality strength, and trend forecasting. Supports multi-dimensional analysis, metrics selection, and custom granularities.
Inputs: siteUrl (required), days, startDate, endDate, +6 more.
analytics_top_pagesC
Get top performing pages by clicks or impressions for the last N days.
Inputs: siteUrl (required), days, limit, sortBy.
analytics_top_queriesB
Get top search queries by clicks or impressions for the last N days.
Inputs: siteUrl (required), days, limit, sortBy.
analytics_traffic_sourcesC
Analyze traffic sources (Channel, Source, Medium) in GA4
Inputs: propertyId (required), startDate (required), endDate (required), accountId, +3 more.
analytics_trendsC
Detect traffic trends (rising/declining) for queries or pages.
Inputs: siteUrl (required), dimension, days, threshold, +2 more.
analytics_user_behaviorB
Get user behavior breakdown (Device, Country, Engagement) in a single batch
Inputs: propertyId (required), startDate (required), endDate (required), accountId.
bing_analytics_compare_periodsB
Compare performance between two date ranges in Bing
Inputs: siteUrl (required), startDate1 (required), endDate1 (required), startDate2 (required), +1 more.
bing_analytics_detect_anomaliesC
Detect performance anomalies in Bing traffic
Inputs: siteUrl (required), days, threshold.
bing_analytics_drop_attributionC
Identify the likely cause of a Bing traffic drop
Inputs: siteUrl (required), days, threshold.
bing_analytics_pageC
Get page performance stats from Bing Webmaster Tools (Top Pages)
Inputs: siteUrl (required), startDate, endDate.
bing_analytics_page_queryB
Get query performance stats for a specific page from Bing Webmaster Tools
Inputs: siteUrl (required), pageUrl (required), startDate, endDate.
bing_analytics_queryB
Get query performance stats from Bing Webmaster Tools (Top Queries)
Inputs: siteUrl (required), startDate, endDate, limit, +1 more.
bing_analytics_query_pageC
Get combined query and page performance stats for a site
Inputs: siteUrl (required), startDate, endDate.
bing_analytics_time_seriesC
Advanced time series analysis for Bing performance data
Inputs: siteUrl (required), days, granularity, metrics.
bing_analytics_trendsC
Detect rising or declining trends in Bing query performance
Inputs: siteUrl (required), days, threshold, minClicks.
bing_brand_analysisC
Analyze Brand vs Non-Brand performance on Bing.
Inputs: siteUrl (required), brandRegex (required), days.
bing_crawl_issuesC
Get crawl issues for a site from Bing Webmaster Tools
Inputs: siteUrl (required).
bing_crawl_statsA
Get crawl statistics (indexed, crawled, errors) for a site
Inputs: siteUrl (required).
bing_get_top_pagesC
Alias for bing_analytics_page. Get top pages for a site.
Inputs: siteUrl (required).
bing_get_top_queriesC
Alias for bing_analytics_query. Get top queries for a site.
Inputs: siteUrl (required), startDate, endDate.
bing_index_nowC
Submit URLs via IndexNow API (Bing, Yandex, etc.)
Inputs: host (required), key (required), urlList (required), keyLocation.
bing_keywords_statsB
Get historical stats for a keyword in Bing
Inputs: q (required), country, language.
bing_link_countsB
Get inbound link counts for a site from Bing
Inputs: siteUrl (required).
bing_low_ctr_opportunitiesB
Identify high-ranking Bing queries with lower than expected CTR
Inputs: siteUrl (required), minImpressions.
bing_opportunity_finderC
Find high-potential 'low-hanging fruit' keywords in Bing
Inputs: siteUrl (required), minImpressions.
bing_rank_traffic_statsB
Get historical rank and traffic statistics for a site
Inputs: siteUrl (required).
bing_seo_cannibalizationB
Detect pages competing for the same query in Bing.
Inputs: siteUrl (required), minImpressions.
bing_seo_lost_queriesC
Identify queries that lost significant traffic on Bing compared to the previous period.
Inputs: siteUrl (required), days.
bing_seo_recommendationsB
Generate prioritized SEO recommendations for a Bing site
Inputs: siteUrl (required).
bing_sitemaps_deleteC
Remove a sitemap from Bing Webmaster Tools
Inputs: siteUrl (required), sitemapUrl (required).
bing_sitemaps_listC
List sitemaps for a Bing site
Inputs: siteUrl (required).
bing_sitemaps_submitC
Submit a sitemap to Bing Webmaster Tools
Inputs: siteUrl (required), sitemapUrl (required).
bing_sites_addB
Add a new site to Bing Webmaster Tools
Inputs: siteUrl (required).
bing_sites_deleteB
Remove a site from Bing Webmaster Tools
Inputs: siteUrl (required).
bing_sites_healthA
Run a comprehensive health check on one or all verified Bing sites
Inputs: siteUrl.
bing_sites_listB
List all sites verified in Bing Webmaster Tools
Inputs: no named parameters.
bing_striking_distanceA
Find keywords ranking positions 8-15 on Bing (near page 1)
Inputs: siteUrl (required).
bing_url_infoB
Get detailed indexing and crawl information for a URL in Bing
Inputs: siteUrl (required), url (required).
bing_url_submission_quotaB
Get remaining URL submission quota for Bing
Inputs: siteUrl (required).
bing_url_submitB
Submit a single URL to Bing for indexing
Inputs: siteUrl (required), url (required).
bing_url_submit_batchA
Submit multiple URLs to Bing for indexing in a single batch
Inputs: siteUrl (required), urlList (required).
brand_analysisB
Analyze Brand vs Non-Brand performance across GSC, Bing, and GA4
Inputs: brandTerms (required), gscSiteUrl (required), bingSiteUrl (required), ga4PropertyId (required), +5 more.
compare_enginesB
Compare performance data between Google and Bing for a specific dimension (query, page, etc).
Inputs: siteUrl (required), dimension (required), startDate (required), endDate (required), +4 more.
diagnosticsA
Run connectivity diagnostics for all connected accounts. Use this to troubleshoot '0 results' or authentication issues.
Inputs: no named parameters.
get_startedA
Start here. Returns a complete map of this server's capabilities, active platforms, and recommended workflows. Call this once at the beginning of any session.
Inputs: no named parameters.
grain_content_decayA
Detect pages with consistent traffic decline across 3 consecutive 30-day windows. Only flags pages with strict monotonic decline (oldest > middle > newest).
Inputs: siteUrl (required), minClicks, limit.
grain_content_recommendationsB
Generate prioritized SEO recommendations by cross-referencing quick wins, content gaps, and cannibalization. Returns update/create/consolidate actions.
Inputs: siteUrl (required), days, maxRecommendations.
grain_ctr_benchmarkA
Compare actual CTR per page against industry benchmarks by position. Classifies as Above/At/Below/Significantly below benchmark.
Inputs: siteUrl (required), days, minImpressions, limit.
grain_topic_clusterA
Aggregate performance for all pages matching a URL path pattern (e.g. /blog/, /guides/). Returns top pages and queries.
Inputs: siteUrl (required), pathPattern (required), days.
grain_traffic_dropsA
Diagnose WHY traffic dropped: ranking loss, CTR collapse, search demand decline, or page disappeared. Compares current vs prior period.
Inputs: siteUrl (required), days, limit.
grain_verify_claimB
Anti-hallucination: re-query GSC to verify a specific numeric claim. Tolerance: position ±0.5, other metrics ±5%.
Inputs: siteUrl (required), claim (required), metric (required), expectedValue (required), +3 more.
indexing_batch_submitA
Submit multiple URLs for indexing in batch. Google: max 200 (daily quota), Bing: max 500.
Inputs: siteUrl (required), urls (required), engine.
indexing_remove_urlA
Notify Google that a URL has been removed (e.g., expired job posting). Google only.
Inputs: siteUrl (required), url (required).
indexing_statusA
Check the notification status for a URL previously submitted to the Google Indexing API
Inputs: siteUrl (required), url (required).
indexing_submit_urlA
Submit a URL for indexing (notify Google or Bing that a page was updated). Google Indexing API is officially for JobPosting/BroadcastEvent pages.
Inputs: siteUrl (required), url (required), engine.
inspection_batchB
Inspect multiple URLs for a site in batch
Inputs: siteUrl (required), inspectionUrls (required), languageCode, engine.
inspection_inspectB
Inspect a URL to check its indexing status, crawl info, and health
Inputs: siteUrl (required), inspectionUrl (required), languageCode, engine.
opportunity_matrixC
Prioritize SEO tasks by combining signals from GSC, GA4, and Bing
Inputs: gscSiteUrl (required), bingSiteUrl (required), ga4PropertyId (required), startDate (required), +5 more.
page_analysisC
Compare GSC ranking data with GA4 behavior data for top pages to find opportunities
Inputs: gscSiteUrl (required), ga4PropertyId (required), startDate (required), endDate (required), +3 more.
pagespeed_analyzeB
Run PageSpeed Insights analysis on a URL to get performance, accessibility, best practices, and SEO scores
Inputs: url (required), strategy.
pagespeed_core_web_vitalsB
Get Core Web Vitals for both mobile and desktop including LCP, FID, CLS, FCP, TTI, and TBT
Inputs: url (required).
schema_validateA
Validate Schema.org structured data (JSON-LD) from a URL, HTML snippet, or JSON object.
Inputs: type (required), data (required).
seo_brand_vs_nonbrandC
Analyze performance split between Brand and Non-Brand queries using a regex.
Inputs: siteUrl (required), brandRegex (required), days, engine.
seo_cannibalizationC
Detect keyword cannibalization - multiple pages competing for the same query
Inputs: siteUrl (required), days, minImpressions, limit, +1 more.
seo_lost_queriesB
Identify queries that lost all traffic (or dropped >80%) compared to the previous period.
Inputs: siteUrl (required), days, limit, engine.
seo_low_ctr_opportunitiesA
Find queries with low CTR relative to their ranking position. Great for title tag optimization.
Inputs: siteUrl (required), days, minImpressions, limit, +1 more.
seo_low_hanging_fruitB
Find keywords with high impressions but low rankings that have potential for growth
Inputs: siteUrl (required), days, minImpressions, limit, +1 more.
seo_primitive_is_brandC
primitive: Check if a query is a brand query based on a regex pattern.
Inputs: query (required), brandRegex (required), engine.
seo_primitive_is_cannibalizedC
primitive: Check if two pages are competing for the same query based on their metrics.
Inputs: query (required), pageA_position (required), pageA_impressions (required), pageA_clicks (required), +4 more.
seo_primitive_ranking_bucketB
primitive: Get the ranking bucket for a specific position (e.g. Top 3, Page 1).
Inputs: position (required), engine.
seo_primitive_traffic_deltaB
primitive: Calculate the delta between two traffic metrics (absolute and percentage).
Inputs: current (required), previous (required), engine.
seo_quick_winsA
Find pages with queries ranking on page 2 (positions 11-20) that could be pushed to page 1
Inputs: siteUrl (required), days, minImpressions, limit, +1 more.
seo_recommendationsC
Generate SEO recommendations based on site performance data
Inputs: siteUrl (required), days, engine.
seo_striking_distanceA
Find keywords ranking in positions 8-15. These are high-priority targets to push to Page 1.
Inputs: siteUrl (required), days, limit, engine.
sitemaps_deleteB
Delete a sitemap from Search Console or Bing Webmaster Tools
Inputs: siteUrl (required), feedpath (required), engine.
sitemaps_getB
Get details about a specific sitemap
Inputs: siteUrl (required), feedpath (required).
sitemaps_listB
List sitemaps for a site
Inputs: siteUrl (required), engine.
sitemaps_submitB
Submit a sitemap to Search Console or Bing Webmaster Tools
Inputs: siteUrl (required), feedpath (required), engine.
sites_addB
Add a new site to Search Console or Bing Webmaster Tools
Inputs: siteUrl (required), engine.
sites_deleteA
Remove a site from Search Console or Bing Webmaster Tools
Inputs: siteUrl (required), engine.
sites_getA
Get information about a specific site
Inputs: siteUrl (required).
sites_health_checkB
Run a health check on one or all verified sites. Checks performance trends and status.
Inputs: siteUrl, engine.
sites_listA
List all verified sites or properties across all authorized accounts
Inputs: engine.
traffic_health_checkB
Diagnose tracking issues by comparing GSC clicks vs GA4 organic sessions
Inputs: gscSiteUrl (required), ga4PropertyId (required), startDate (required), endDate (required), +2 more.
util_star_repoA
Star the GitHub repository to support the project. Uses GitHub CLI if available, or opens a browser.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 104 tools
Several tools are explicitly aliases of each other (bing_get_top_queries for bing_analytics_query, bing_get_top_pages for bing_analytics_page), and many bing_* tools mirror seo_* tools with only an engine difference (cannibalization, lost queries, striking distance, low CTR). The overlapping brand analysis tools and multiple URL submission tools further blur boundaries, making reliable tool selection very difficult.
Naming is inconsistent across the set: some tools use noun_verb (sites_list, sitemaps_submit, analytics_query), some use verb_noun (compare_engines, get_started), and many use noun phrases with no verb at all (seo_cannibalization, grain_content_decay, diagnostics, opportunity_matrix). The aliases also break expectation, such as bing_get_top_queries vs bing_analytics_query.
With 104 tools, this is an extreme count that far exceeds the well-scoped 3-15 range. The count is inflated by engine-specific duplicates, aliases, and many overlapping analytical variants rather than genuinely distinct capabilities.
The tool surface is broadly comprehensive, covering Google Search Console, Bing Webmaster Tools, GA4, PageSpeed, schema validation, indexing, and diagnostics. Minor gaps exist such as missing Google-side link or keyword research equivalents, but the core SEO workflow is well represented.
Maintenance
Related MCP Connectors
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
SEO MCP: Search Console, GA4, SERP and domain data, rank tracking, AI citations and site fixes.
Free Search Console & GA4 MCP, plus SERP, keywords, rank charts, GEO, AEO and AI visibility.
Related MCP Servers
- FlicenseBqualityDmaintenanceAn MCP server that integrates Google Search Console and Google Analytics 4 to provide unified SEO and web traffic analysis. It allows users to fetch search performance data, merge page metrics, and generate automated trend reports or actionable insights through tool calls.161-
- AlicenseBqualityBmaintenanceSEO audit and Google Search Console MCP server with 23 tools. Search analytics, URL inspection, Indexing API, Core Web Vitals (CrUX), striking distance keywords, keyword cannibalization detection, branded query analysis, and automated site audits.433MIT
- AlicenseAqualityDmaintenanceMCP server for advanced Google Search Console analysis — keyword cannibalization detection, page-level query deep dive, and rank change tracking.3MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that connects AI assistants to SEO platforms like Google Search Console, GA4, Bing Webmaster Tools, and Adobe Analytics, enabling natural language queries about SEO performance.1,377 npmMIT