MCP server for AgentSEO API providing SEO analysis, content gap analysis, SERP analysis, local audits, and web mentions discovery
AgentSEO MCP server defines 11 SEO-focused tools with consistent naming (verb_noun pattern: agentseo_*) and complete input schemas. All tools have descriptions (avg ~80 chars) and typed parameters with enums where appropriate. However, output schemas are entirely undocumented, no response structure is visible in the source. Parameter descriptions are minimal (often single phrases like 'The search query') and lack actionable constraints. Error handling is absent from tool definitions. The server follows basic MCP patterns but lacks production-grade polish: no guidance on when to use similar tools (e.g., agentseo_social_listen vs agentseo_web_mentions are identical), no recovery hints, and no documentation of API dependencies or rate limits.
Extract AI Overview insights for a target keyword.
Deep analysis of Search Engine Results Page (SERP) features and competitors.
Run content gap analysis for a URL and keyword.
Extract content from a URL and convert to Markdown.
Track brand mentions across LLM/search-style results.
Run a local SEO audit for a domain and location.
Output schemas completely undocumented. No response structure, field types, or pagination guidance visible. LLMs cannot plan downstream tool calls or extract required data.
Duplicate tools with identical signatures: agentseo_social_listen and agentseo_web_mentions have identical input schemas and descriptions. LLMs cannot distinguish when to use each. Merge or document the difference.
Parameter descriptions are minimal (avg 15-20 chars) and lack actionable constraints. E.g., 'The search query' does not explain length limits, special characters, or expected format. 'Geographic location' does not clarify if it accepts country names, city names, or location codes.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Queue up to 10 local audits in one request.
Track local visibility for a domain across keywords and locations.
Perform a Google search with optional domain filters.
Find web mentions for a query (web-wide discovery; not platform-native monitoring).
Find web mentions for a query (web-wide discovery; not platform-native monitoring).
No error handling guidance. Tool definitions do not indicate which errors are retryable, what to do if a domain/keyword is not found, or how to recover from API failures. Agents cannot self-correct.
Tool descriptions do not explain when to use each tool or dependencies between them. E.g., agentseo_analyze_serp vs agentseo_search, when should an LLM choose one over the other? What does each return that the other does not?