ai_overviews_impact
Discover generic Web search appearances; AI exposure remains unverified.
Parameters and source contract
ai_overviews_impact(site: str, days: int = 28, limit: int = 100) -> strv1.5.0 · 96 tools
Tool catalogue
Search Console MCP tools by family, with parameters and links to server contracts.
This catalogue covers the full registry. Your server may expose fewer tools depending on enabled families. Sources require their own access; GA4 and CrUX are optional. Configure families →
analytics
Search performance
Google metrics, equal-period contributions and same-weekday references.
analytics_anomalies
Detect days with statistically abnormal click volumes using z-score analysis.
Parameters and source contract
analytics_anomalies(site: str, days: int = 90, threshold: float = 2.5) -> strcompare_search_periods
Compare two consecutive equal-length windows and report delta in clicks and impressions.
Parameters and source contract
compare_search_periods(site: str, days: int = 28) -> strdiscover_performance
Get Discover performance: top pages by impressions (Discover does not support query dimension).
Parameters and source contract
discover_performance(site: str, days: int = 28, limit: int = 50) -> strget_advanced_search_analytics
Fetch GSC search analytics with full control over search_type, data_state, dimensions, and row limit.
Parameters and source contract
get_advanced_search_analytics(site: str, dimensions: list[str] | None = None, date_range_days: int = 28, row_limit: int = 1000, search_type: str = 'web', data_state: str | None = None) -> strget_performance_overview
Summarise total clicks, impressions, average CTR and average position for a site.
Parameters and source contract
get_performance_overview(site: str, days: int = 28) -> strget_search_analytics
Fetch GSC search analytics (clicks, impressions, CTR, position) for a site.
Parameters and source contract
get_search_analytics(site: str, days: int = 28, dimensions: list[str] | None = None, row_limit: int = 1000) -> strget_search_by_page_query
Fetch GSC data grouped by both page and query simultaneously.
Parameters and source contract
get_search_by_page_query(site: str, days: int = 28, row_limit: int = 1000) -> strnews_performance
Get Google News performance: top pages by impressions (News does not support query dimension).
Parameters and source contract
news_performance(site: str, days: int = 28, limit: int = 50) -> strsearch_change_breakdown
Compare equal explicit Google windows using independent bounded segment views.
Parameters and source contract
search_change_breakdown(site: 'str', baseline_start: 'str', baseline_end: 'str', comparison_start: 'str', comparison_end: 'str', dimensions: 'list[str] | None' = None, filters: 'Optional[list[dict]]' = None, search_type: 'str' = 'web', data_state: 'str' = 'final', aggregation_type: 'str' = 'auto', row_limit: 'int' = 1000, max_requests: 'int' = 20, limit: 'int' = 50, output_max_bytes: 'int | None' = None) -> 'str'search_type_breakdown
Aggregate clicks and impressions broken down by search type for a site or specific URL.
Parameters and source contract
search_type_breakdown(site: str, url: str | None = None, days: int = 28) -> strsearch_weekday_reference
Describe eligible traffic against weekday, annual or robust daily references.
Parameters and source contract
search_weekday_reference(site: 'str', days: 'int' = 28, end_date: 'str | None' = None, dimensions: 'list[str] | None' = None, filters: 'list[dict] | None' = None, search_type: 'str' = 'web', aggregation_type: 'str' = 'auto', row_limit: 'int' = 1000, max_requests: 'int' = 20, limit: 'int' = 50, reference_strategy: 'str' = 'weekday', history_days: 'int' = 56, min_support: 'int' = 6, context_json: 'str | None' = None) -> 'str'technical
Technical checks
Schema, crawler rules, PageSpeed and caller-supplied crawl previews, each with its own inputs.
ai_visibility_audit
Check robots.txt AI crawler access and llms.txt presence for a URL's origin.
crawl_diff
Compare two site-owned local inventories without inferring deletion/indexing.
Parameters and source contract
crawl_diff(site: 'str', baseline_id: 'str', comparison_id: 'str', limit: 'int' = 50, policy_fields: 'list[str] | None' = None) -> 'str'crawl_import_preview
Preview a caller-supplied SiteOne JSON string in memory, within fixed size/row limits.
Parameters and source contract
crawl_import_preview(report_json: str, producer: str = 'siteone') -> strcrawl_log_audit
Stream one explicitly selected common/combined local log file with hard caps.
Parameters and source contract
crawl_log_audit(log_path: 'str', site: 'str', profile: 'str' = 'combined', max_bytes: 'int' = 2097152, max_lines: 'int' = 20000, max_paths: 'int' = 1000, limit: 'int' = 50, include_paths: 'bool' = False, verify_googlebot: 'bool' = False) -> 'str'crawl_snapshot_delete
Delete one local site-owned imported snapshot only with explicit confirm=True.
Parameters and source contract
crawl_snapshot_delete(site: 'str', snapshot_id: 'str', confirm: 'bool' = False) -> 'str'crawl_snapshot_import
Validate a site-owned versioned inventory; persist=True explicitly stores it locally.
Parameters and source contract
crawl_snapshot_import(report_json: 'str', site: 'str', producer: 'str' = 'siteone', persist: 'bool' = False) -> 'str'crawl_snapshot_join
Reconcile one local inventory page with bounded caller-supplied MCP reports.
Parameters and source contract
crawl_snapshot_join(site: 'str', snapshot_id: 'str', search_report_json: 'str | None' = None, link_report_json: 'str | None' = None, offset: 'int' = 0, limit: 'int' = 50) -> 'str'crawl_snapshot_read
Read a bounded page of an immutable local inventory owned by the exact site.
Parameters and source contract
crawl_snapshot_read(site: 'str', snapshot_id: 'str', offset: 'int' = 0, limit: 'int' = 50) -> 'str'gbp_deprecation_lint
Scan a page for deprecated Google Business Profile (GBP) features.
pagespeed_audit
Run a PageSpeed Insights audit via Google's PSI API v5.
Parameters and source contract
pagespeed_audit(url: str, strategy: str = 'mobile') -> strschema_generate
Generate a Schema.org JSON-LD block for one of four high-leverage types.
Parameters and source contract
schema_generate(schema_type: str, provider: Optional[str] = None, start_time: Optional[str] = None, end_time: Optional[str] = None, party_size: Optional[int] = None, reservation_id: Optional[str] = None, reservation_for_name: Optional[str] = None, customer_name: Optional[str] = None, customer_email: Optional[str] = None, reservation_kind: str = 'FoodEstablishmentReservation', merchant: Optional[str] = None, order_url: Optional[str] = None, order_name: str = 'Order online', delivery_method: Optional[list[str]] = None, headline: Optional[str] = None, author: Optional[str] = None, url: Optional[str] = None, date_published: Optional[str] = None, text: Optional[str] = None, date_modified: Optional[str] = None, comment_count: Optional[int] = None, name: Optional[str] = None, profile_url: Optional[str] = None, description: Optional[str] = None, same_as: Optional[list[str]] = None, knows_about: Optional[list[str]] = None, works_for: Optional[str] = None, image: Optional[str] = None, job_title: Optional[str] = None) -> strschema_validate
Fetch a URL and validate its JSON-LD structured data schemas.
inspection
Google indexing
Google URL Inspection on a bounded sample. Search traffic alone does not prove indexing state.
batch_url_inspection
Inspect up to 10 URLs at once in GSC. Returns the same fields as inspect_url for each URL.
Parameters and source contract
batch_url_inspection(urls: list[str], site: str) -> strcheck_indexing_issues
Inspect up to 10 URLs and return only those with indexing problems, plus a summary count by category.
Parameters and source contract
check_indexing_issues(urls: list[str], site: str) -> strindexing_evidence_matrix
Reconcile an explicit URL sample with bounded supplied reports and a local snapshot.
Parameters and source contract
indexing_evidence_matrix(site: 'str', urls: 'list[str]', reports_json: 'str' = '[]', snapshot_id: 'str | None' = None, max_reports: 'int' = 20) -> 'str'inspect_url
Inspect a single URL in GSC to get its indexing status, last crawl time, and canonical URL.
bing
Bing Webmaster
Verified sites, query/page performance, crawl signals and guarded submissions.
bing_crawl_issues
Decode Bing crawl issue flags using the synthetic-fixture contract.
Parameters and source contract
bing_crawl_issues(site: 'str', limit: 'int' = 1000) -> 'str'bing_crawl_settings_get
Return only Bing's observed crawl-rate value from the partial contract.
Parameters and source contract
bing_crawl_settings_get(site: 'str') -> 'str'bing_crawl_stats
Return dated Bing crawl counts inside the requested local window.
Parameters and source contract
bing_crawl_stats(site: 'str', days: 'int' = 30) -> 'str'bing_feed_details
Return every Bing feed-detail row from the observed list response.
Parameters and source contract
bing_feed_details(site: 'str', feed_url: 'str') -> 'str'bing_feed_remove
External write: explicit target and confirmation required.
Remove a registered same-origin feed only after explicit confirmation.
Parameters and source contract
bing_feed_remove(site: 'str', feed_url: 'str', confirm: 'bool' = False) -> 'str'bing_feed_submit
External write: explicit target and confirmation required.
Submit one same-origin feed to Bing without claiming indexation.
Parameters and source contract
bing_feed_submit(site: 'str', feed_url: 'str') -> 'str'bing_feeds_list
Return Bing feeds with only the observed, non-indexation fields.
bing_link_counts
Return one Bing page of backlink counts from a synthetic shape.
Parameters and source contract
bing_link_counts(site: 'str', page: 'int' = 0) -> 'str'bing_page_query_stats
Return Bing query performance for one requested page.
Parameters and source contract
bing_page_query_stats(site: 'str', page: 'str', days: 'int' = 30, limit: 'int' = 1000) -> 'str'bing_page_stats
Return Bing page performance, normalizing Bing's Query field to page.
Parameters and source contract
bing_page_stats(site: 'str', days: 'int' = 30, limit: 'int' = 1000) -> 'str'bing_query_stats
Aggregate dated Bing rows by query within the requested local window.
Parameters and source contract
bing_query_stats(site: 'str', days: 'int' = 30, limit: 'int' = 1000, daily: 'bool' = False) -> 'str'bing_rank_traffic_stats
Return Bing daily clicks and impressions without inventing rank fields.
Parameters and source contract
bing_rank_traffic_stats(site: 'str', days: 'int' = 30) -> 'str'bing_sites_list
Return verified-state summaries for sites visible to the Bing account.
bing_url_info
Return only fields observed from Bing URL info, without indexation claims.
Parameters and source contract
bing_url_info(site: 'str', url: 'str') -> 'str'bing_url_links
Return one Bing page of backlinks for the requested target URL.
Parameters and source contract
bing_url_links(site: 'str', url: 'str', page: 'int' = 0) -> 'str'bing_url_submission_quota
Return Bing quota integers without claiming total or remaining semantics.
Parameters and source contract
bing_url_submission_quota(site: 'str') -> 'str'bing_url_submit
External write: explicit target and confirmation required.
Submit one same-origin URL to Bing without claiming indexation.
Parameters and source contract
bing_url_submit(site: 'str', url: 'str') -> 'str'bing_url_traffic
Return observed URL traffic and derived CTR without rank fields.
Parameters and source contract
bing_url_traffic(site: 'str', url: 'str') -> 'str'bing_urls_submit_batch
External write: explicit target and confirmation required.
Preflight a Bing URL batch and refuse while quota semantics are unknown.
Parameters and source contract
bing_urls_submit_batch(site: 'str', urls: 'list[str]') -> 'str'seo
Opportunities and changes
Opportunity candidates, traffic drops and declared-change follow-up. Heuristic diagnoses need review.
check_alerts
Scan for structural SEO risks: traffic concentration and high-impression low-rank pages.
Parameters and source contract
check_alerts(site: str, days: int = 28, engine: str = 'google') -> strparasite_risk
Scan URL paths for parasite SEO patterns matching Google's 2024-11-19 site-reputation policy.
Parameters and source contract
parasite_risk(site: str, urls: list[str]) -> strprune_candidates
Classify pages by measured traffic before any pruning decision is taken.
Parameters and source contract
prune_candidates(site: str, days: int = 180, max_pages: int = 500, engine: str = 'google') -> strquick_wins
Identify pages ranking between positions 4-15 whose CTR is below the industry benchmark for their rank.
Parameters and source contract
quick_wins(site: str, days: int = 28, min_impressions: int = 10, engine: str = 'google') -> strseo_cannibalization
Detect queries where multiple pages compete for the same ranking slot.
Parameters and source contract
seo_cannibalization(site: str, days: int = 28, min_impressions: int = 50, engine: str = 'google', include_search_operators: bool = False) -> strseo_change_impact
Associate a caller event with equal explicit GSC before/after windows.
Parameters and source contract
seo_change_impact(event: 'dict', baseline_start: 'str', baseline_end: 'str', comparison_start: 'str', comparison_end: 'str', filters: 'list[dict] | None' = None, search_type: 'str' = 'web', align_weekdays: 'bool' = False, page_mapping: 'dict | None' = None, concurrent_changes: 'list[str] | None' = None, row_limit: 'int' = 1000, max_requests: 'int' = 20, limit: 'int' = 50) -> 'str'seo_lost_queries
Find queries that had significant clicks previously but now have 80%+ fewer clicks.
Parameters and source contract
seo_lost_queries(site: str, days: int = 28, engine: str = 'google') -> strseo_striking_distance
List queries ranking between positions 8-15, sorted by impressions descending.
Parameters and source contract
seo_striking_distance(site: str, days: int = 28, min_impressions: int = 0, engine: str = 'google') -> strtraffic_drops
Find queries whose clicks dropped compared to the previous equally-sized period.
Parameters and source contract
traffic_drops(site: str, days: int = 28, engine: str = 'google') -> strcross
Source comparisons
GSC and GA4 reports or Google and Bing comparisons, with source and window guards.
compare_search_engines
Compare Google and Bing query or page metrics without inferring causality.
Parameters and source contract
compare_search_engines(google_site: 'str', bing_site: 'str', days: 'int' = 28, dimension: 'str' = 'query', limit: 'int' = 100) -> 'str'content_brief
Gather SEO content intelligence for a single page: top queries, question queries, and GA4 engagement.
Parameters and source contract
content_brief(site: str, page_url: str, days: int = 90, property_id: str | None = None) -> strpage_analysis
Join GSC and GA4 data at the page level and rank by opportunity score.
Parameters and source contract
page_analysis(site: str, days: int = 28, limit: int = 100, property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strpage_health_score
Compute a 0-100 health score for a single page by combining GSC, GA4, CrUX, and schema data.
Parameters and source contract
page_health_score(site: str, url: str, property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strtraffic_health_check
Compare Google clicks and GA4 organic sessions over matching calendar dates.
Parameters and source contract
traffic_health_check(site: str, days: int = 28, property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strcontent
Page content
Headings, metadata, canonical, hreflang and preload checks on fetched public HTML.
content_quality
Analyse page content quality against Google QRG signals (E-E-A-T heuristics).
Parameters and source contract
content_quality(url: 'str', extractor: 'str' = 'visible') -> 'str'heading_audit
Audit the heading structure of a page: H1 uniqueness, hierarchy, and title overlap.
hreflang_audit
Fetch a URL and validate its hreflang implementation.
page_technical_audit
Audit on-page technical SEO: meta tags, canonical, robots.txt, security headers.
Parameters and source contract
page_technical_audit(url: 'str') -> 'str'preload_audit
Audit Speculation Rules, bfcache eligibility, and LCP preload signals for a URL.
crux
Field performance
CrUX Core Web Vitals where sufficient field data exists; separate API key required.
crux_history
Fetch 40 weeks of Core Web Vitals history for a URL from the CrUX History API.
Parameters and source contract
crux_history(url: str, form_factor: str = 'ALL_FORM_FACTORS', metric: str = 'largest_contentful_paint') -> strcrux_lcp_subparts
Decompose LCP into its four subparts via the CrUX API for actionable performance diagnosis.
Parameters and source contract
crux_lcp_subparts(url: str, form_factor: str = 'PHONE') -> strcrux_page_vitals
Fetch current Core Web Vitals (LCP, INP, CLS, FCP, TTFB) for a URL from the CrUX API.
Parameters and source contract
crux_page_vitals(url: str, form_factor: str = 'ALL_FORM_FACTORS') -> strdrift
Page changes
Capture and compare locally stored page baselines. Persistence is explicit.
drift_baseline
Capture an SEO baseline snapshot for a URL.
Parameters and source contract
drift_baseline(url: 'str', skip_cwv: 'bool' = False) -> 'str'drift_compare
Compare current page state to a stored baseline and report SEO drift.
Parameters and source contract
drift_compare(url: 'str', baseline_id: 'Optional[int]' = None, skip_cwv: 'bool' = False) -> 'str'drift_history
Return recent drift comparisons for a URL.
Parameters and source contract
drift_history(url: 'str', limit: 'int' = 10) -> 'str'editorial
Drafts and rewrites
FR/EN review warnings and protected-literal comparisons. No authorship or semantic certification.
editorial_audit
Review narrow FR/EN editorial house rules, preserving quoted examples/code.
Parameters and source contract
editorial_audit(url: str | None = None, language: str = 'auto', genre: str = 'general', *, text: str | None = None, format: str = 'plain') -> strrewrite_fidelity_check
Compare protected literals/qualifiers in supplied text; semantics unassessed.
Parameters and source contract
rewrite_fidelity_check(original: str, revised: str, language: str = 'en', format: str = 'plain') -> strga4
GA4 behavior
Sessions, engagement, events and AI referrers, when the GA4 property is configured.
ga4_ai_referrals
Report observed GA4 visits attributed to exact documented assistant sources.
Parameters and source contract
ga4_ai_referrals(start_date: str, end_date: str, property_id: str | None = None, hostname: str | None = None) -> strga4_conversion_funnel
Fetch GA4 conversion data: pages that generated conversions, and event counts.
Parameters and source contract
ga4_conversion_funnel(start_date: str = '28daysAgo', end_date: str = 'today', event_name: str | None = None, property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strga4_funnel
Run a GA4 funnel report using the v1alpha RunFunnelReport API.
Parameters and source contract
ga4_funnel(steps: list[dict], start_date: str, end_date: str, property_id: str | None = None) -> strga4_organic_landing_pages
Fetch GA4 landing page performance filtered to organic traffic only.
Parameters and source contract
ga4_organic_landing_pages(start_date: str = '28daysAgo', end_date: str = 'today', limit: int = 50, property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strga4_page_performance
Fetch GA4 page-level metrics: views, active users, session duration, engagement and bounce rates, conversions, and revenue.
Parameters and source contract
ga4_page_performance(start_date: str = '28daysAgo', end_date: str = 'today', page_path: str | None = None, property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strga4_realtime
Fetch active users in the last 30 minutes from the GA4 Realtime API.
Parameters and source contract
ga4_realtime(property_id: str | None = None, hostname: str | None = None) -> strga4_traffic_sources
Fetch GA4 sessions grouped by channel group, source, and medium.
Parameters and source contract
ga4_traffic_sources(start_date: str = '28daysAgo', end_date: str = 'today', property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strga4_user_behavior
Fetch GA4 sessions and engagement rate broken down by device, country, and user type.
Parameters and source contract
ga4_user_behavior(start_date: str = '28daysAgo', end_date: str = 'today', property_id: str | None = None, hostname: str | None = None, country: str | None = None) -> strcore
Access and discovery
Discover tools and source properties.
get_capabilities
List configured MCP tools and declared search-engine credentials.
get_site_details
Get the permission level for a specific GSC property URL.
list_properties
List all GSC properties the authenticated account can access, with their permission levels.
indexing
URL submissions
Eligible Google Indexing API and IndexNow submissions. Acceptance proves neither crawling nor indexing.
indexnow_submit
External write: explicit target and confirmation required.
Submit URLs to IndexNow, notifying Bing, Yandex, Seznam, and Naver simultaneously.
Parameters and source contract
indexnow_submit(site: str, key: str, urls: list[str]) -> strsubmit_batch
External write: explicit target and confirmation required.
Submit multiple URLs to the Google Indexing API in HTTP batches of 100.
Parameters and source contract
submit_batch(urls: list[str], url_type: str = 'URL_UPDATED') -> strsubmit_url
External write: explicit target and confirmation required.
Submit a single URL to the Google Indexing API for crawl notification.
Parameters and source contract
submit_url(url: str, url_type: str = 'URL_UPDATED') -> strlinks
Internal links
Link zones, sampled graphs and bounded HTTP destination checks; no site-wide orphan proof.
internal_links_audit
Audit the internal linking of a single page, weighted by where each link sits.
Parameters and source contract
internal_links_audit(url: 'str') -> 'str'link_equity_map
Map internal link flow across a site's most-visible pages and cross it with GSC.
Parameters and source contract
link_equity_map(site: 'str', days: 'int' = 90, max_pages: 'int' = 25, delay_seconds: 'float' = 0.2) -> 'str'link_targets_audit
Check one page's internal HTTP(S) link targets, retaining every anchor.
Parameters and source contract
link_targets_audit(url: 'str', max_targets: 'int' = 30, max_requests: 'int' = 60) -> 'str'sitemaps
Sitemaps
Submitted sitemap status and declared URLs compared with search visibility.
list_sitemaps
List all sitemaps submitted to a GSC property, with submission dates, status, and error counts.
sitemap_audit
Fetch a sitemap and compare its URLs with pages visible in Search Analytics.
Parameters and source contract
sitemap_audit(site: str, sitemap_url: str) -> strsitemaps_delete
External write: explicit target and confirmation required.
Delete a submitted sitemap from a GSC property.
Parameters and source contract
sitemaps_delete(site: str, sitemap_url: str) -> strsitemaps_get
Get details for a specific sitemap already submitted to a GSC property.
Parameters and source contract
sitemaps_get(site: str, sitemap_url: str) -> strsubmit_sitemap
External write: explicit target and confirmation required.
Submit a new sitemap URL to a GSC property. If already submitted, GSC updates the existing entry.
Parameters and source contract
submit_sitemap(site: str, sitemap_url: str) -> str