Skip to main content
Glama

Historical Organic SERP Snapshots

nexscope_seo_historical_serps
Read-only

Historical Organic SERP Snapshots. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.

Input Schema

NameRequiredDescriptionDefault
limitNo
dateToYes
marketNoUS
keywordYes
dateFromYes
languageNoen

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, openWorldHint=true, and destructiveHint=false. The description adds useful behavioral context beyond those annotations: one fixed Live POST, no pagination, explicit unknown/missing values, availability in owner call history, and seven-day freshness rules. The clause about execution and publication being unapproved is ambiguous, but overall the added context is substantial.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The opening sentence repeats the title, and several clauses such as 'Execution and publication remain unapproved' and 'Seven-day source-freshness rules apply only to dependent requests' are cryptic rather than actionable. The core purpose and required inputs are not front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a six-parameter historical SERP query with no output schema and no schema descriptions, the definition never explains what is returned or how keyword/date/market inputs drive the lookup. The behavioral caveats add some value, but the missing parameter guidance leaves the definition materially incomplete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description names none of the six parameters: keyword, dateFrom, dateTo, limit, market, or language. It provides no explanation of date-range semantics, result limits, or the fixed market/language constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description largely restates the title, 'Historical Organic SERP Snapshots,' without adding a specific verb or scope. 'Bounded Google database facts' hints at data provenance but never clearly states that this retrieves historical organic SERP results for a keyword and date range, and it names no sibling tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool instead of alternatives such as nexscope_seo_serp or other SEO tools. The seven-day freshness sentence is a constraint, not a usage recommendation, and no exclusions or prerequisites are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.