MCP server wrapping Google Search Console API with built-in SEO analysis tools
GSC MCP server has 14 tools with consistent naming (verb_noun pattern) and complete input schemas. Descriptions are present but generic (avg ~80 chars, below 194-char baseline). Parameter descriptions exist but lack actionable constraints (ranges, enums, formats). Output schemas are not documented in source. Error handling is minimal, no recovery guidance or categorization. Tool composition is sound (single responsibility), but missing idempotency hints and confirmation patterns for destructive operations (delete_group). No tool annotations (readOnlyHint, destructiveHint) visible in code.
Analyze all distinct queries in cached data and create query groups based on detected themes, intent modifiers, and n-gram frequency
Analyze all distinct page URLs in cached data and create URL segment groups based on structural patterns discovered in the URL paths
Create a new query or URL group with regex-based rules
Delete a group
Detect keyword cannibalization where multiple URLs compete for the same query
Discover semantic query groups using similarity analysis and clustering
Find low-hanging fruit opportunities - queries with high impressions but low CTR and mid-range positions
Output schemas not documented. LLMs cannot plan downstream tool calls or extract required fields (e.g., group_id from create_group response). Baseline: 100% of A+ tools document return types.
Destructive tool (delete_group) lacks confirmation/dry-run pattern. No error guidance for recovery. Agents can delete groups without safeguards.
Parameter descriptions lack actionable constraints. E.g., 'minQueries' has no min/max bounds; 'threshold' (0 - 1?) is ambiguous; 'dimension' should be enum (page|query). Baseline: 100% of A+ tools specify ranges and enums.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | <=2025-11-25 | v2 |
Get details of a specific group including its rules
Get performance metrics for query and URL groups
List all query or URL groups for a site
Convert a semantic cluster into a permanent query group
Sync search analytics data from Google Search Console for a given date range
Test a group's rules against actual data to see matching and non-matching items
Update a group's description and/or rules
Tool descriptions are generic and under 100 chars (baseline 194 chars). Missing WHEN to use, prerequisites, and dependencies. E.g., 'Analyze all distinct queries' does not explain when to call it vs auto_group_queries.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) in code. LLMs cannot infer which tools are safe to retry or have side effects.