Loading ToolBench

Reading the current corpus…

dataseo-mcp MCP server · C · ToolBench

dataseo-mcp

DataSEO MCP provides SEO research tools for backlinks, keywords, traffic, SERP difficulty, competitor analysis, and AI search query planning.

<=2025-11-25STDIO9 tools

60/100

Definition Quality77

Protocol Readiness47

Supportability40

Spec posture

Inferred effective spec <=2025-11-25·current baseline 2026-07-28

Static source inference · medium confidence · detected: Logging

Deprecated protocol patterns detected

Summary

Server has 9 tools with consistent naming (verb_noun pattern) and complete input schemas. All tools have descriptions (10-100 chars, mostly adequate). However, descriptions are terse and lack context for LLM selection. Parameter descriptions are minimal or absent. Output schemas are not documented. No error handling guidance visible. No tool annotations (readOnlyHint, etc.). Composition is sound, each tool has one responsibility. Missing: pagination guidance, output field documentation, recovery hints.

Tools (9)

ai_search_queriesread onlyauthsource verified77/100

Generate AI-powered search queries categorized by intent.

backlink_opportunitiesread onlyauthsource verified78/100

Find competitor backlink sources not present in the target sample.

compare_domainsread onlyauthsource verified78/100

Compare 2-5 domains using backlink and traffic summaries.

domain_overviewread onlyauthsource verified77/100

Get backlink and traffic summary for one domain.

get_backlinks_listread onlyauthsource verified77/100

Get backlink overview and top backlinks for a domain.

get_trafficread onlyauthsource verified78/100

Check estimated search traffic for a domain or URL.

keyword_difficultyread onlyauthsource verified

Issues (5)

HIGHtool ↗

Output schemas not documented. LLMs cannot infer what fields to expect from responses, forcing them to guess at downstream tool chaining and data extraction.

get_backlinks_listkeyword_generatorget_traffickeyword_difficultyai_search_queriesdomain_overviewcompare_domainsbacklink_opportunitiesseo_content_brief

HIGHtool-description ↗

Parameter descriptions are minimal or missing. E.g., 'country' param lacks format guidance (is it 'us' or 'US'? ISO 3166-1 alpha-2?). 'mode' enum is present but not explained in description.

keyword_generatorget_traffickeyword_difficultydomain_overviewcompare_domainsseo_content_brief

HIGHrecovery-guide ↗

No error handling guidance. Code shows error returns (e.g., 'error' field in ai.py response_data) but no recovery hints. LLMs cannot determine if errors are retryable or require user intervention.

Recommendations

Document output schemas for all tools. Example: 'Returns {"backlinks": [{"url": string, "domain": string, "anchor_text": string}], "total_count": integer, "overview": {"referring_domains": integer}}'.
Expand parameter descriptions with format and constraint details. E.g., 'country: ISO 3166-1 alpha-2 code (e.g., us, uk, de). Default: us.'
Add error handling guidance to ai_search_queries and seo_content_brief. E.g., 'If OpenRouter API key is missing, error.error field contains guidance. This is user-fixable, ask user to set OPENROUTER_API_KEY.'
Add tool annotations via fastmcp. Mark all tools with readOnlyHint=true (all are read-only per Risk field). Example: @mcp.tool(readOnlyHint=True).
Add pagination support to keyword_generator and compare_domains. Accept optional 'limit' (default 10, max 50) and 'offset' (default 0) parameters. Return 'total_count' and 'has_more' in response.

Spec posture evidence

Inferred effective spec: <=2025-11-25.

Relies on Logging (deprecated) - log to stderr or use OpenTelemetry

Score history

Overall score trend

First recorded score · v2 rubric

60/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	C	60	<=2025-11-25	v2