Verbind Search Console met elke MCP-client

Het endpoint

De server bevindt zich op /mcp op het app-domein en spreekt Streamable HTTP met protocolversie 2025-06-18. Clients sturen een JSON-RPC POST, sturen een initialize-verzoek en daarna tools/list. Er is niets te installeren en geen lokale proxy in het pad.

• Authorization: Bearer met een key in de vorm apk_live_ plus 32 hexadecimale tekens
• Keys worden eenmalig getoond bij aanmaak en alleen opgeslagen als SHA-256-hash
• Elke aanroep werkt het last-used-tijdstempel en de verzoekteller van de key bij

De tools

Gegroepeerd op functie, met duidelijke namen zodat een model de juiste kiest. Een alleen-lezen sleutel komt nooit bij een tool die schrijft of onderzoekscredits uitgeeft.

• Ontdekking: list_properties, search_analytics
• Prestaties: top_queries, top_pages, top_countries, compare_periods
• Diagnose: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexering: url_inspection, sitemaps
• Tijdlijn: annotations, en create_annotation met een schrijf-key
• Analytics: ga4_overview, ga4_breakdown, ga4_key_events
• Onderzoek: zoekwoorden, SERP's, backlinks, rankingtracking en site-audits, die onderzoekscredits kosten
• Content-engine: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish en de coverttools, om vanuit de wachtrij te schrijven

Datums zijn optioneel

Laat het bereik weg bij een tool en de server gebruikt de laatste 28 afgeronde dagen, rekening houdend met de rapportagevertraging van Search Console, met de vergelijkingsperiode standaard op de vorige periode van dezelfde lengte. De client hoeft nooit de datum van vandaag te kennen om een zinvolle vraag te stellen.

Scopes en ratelimieten

Een key is alleen-lezen of lezen-en-schrijven. Een alleen-lezen key heeft helemaal geen toegang tot een schrijftool, en elke wijziging met een schrijf-key wordt vastgelegd in een audit-log.

• 60 verzoeken per minuut per key, 1.000 per uur per account
• Bij overschrijding van de limiet volgt HTTP 429 met Retry-After in seconden
• Trek een individuele key in zonder de rest van het account te raken

REST, als je dat liever hebt

De Search Console- en GA4-tools zijn ook beschikbaar als GET- en POST-routes onder /v1, met een gegenereerd OpenAPI 3.1-document op /v1/openapi.json, dat tevens dient als function-calling-specificatie. Dezelfde sleutels, dezelfde scopes, dezelfde limieten.