Skip to main content
Glama

Top Organic Ranking Pages

nexscope_seo_top_pages
Read-only

Top Organic Ranking Pages. 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
marketNoUS
targetYes
languageNoen

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true and destructiveHint=false, so the safety profile is covered. The description does add real value beyond that: data provenance (bounded Google database facts), that traffic is estimated rather than measured, that results are a single fixed POST with no pagination, and that unknown/missing fields are explicit. However, the trailing lines ("Execution and publication remain unapproved," "available in owner call history") are cryptic boilerplate that do not translate into concrete agent-facing behavior.

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

Conciseness3/5

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

The text is short and the purpose line is front-loaded, which is good. But it is a chain of clipped fragments mixing provenance, pagination, null-handling, and compliance caveats without hierarchy, and at least two sentences (publication approval, call-history retention) consume space without helping the agent call the tool.

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?

With no output schema, the description should at least sketch what comes back; it only hints at estimated traffic. For a four-parameter tool with 0% schema coverage and no parameter documentation at all, the definition leaves the agent without the information needed to construct a correct call.

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% across four parameters, so the description carries the full burden and fails entirely: `target`, `limit`, `market`, and `language` are never mentioned, nor is the required-vs-optional split or the 1-20 limit bound. An agent must read the raw schema to learn anything about inputs, and the meaning of `target` remains ambiguous even then.

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 opening sentence, "Top Organic Ranking Pages," simply restates the tool title as a noun phrase with no verb and no statement of what is retrieved or for what input. It never says that `target` is a domain/site whose top organic SERP pages are returned, and it names no sibling such as nexscope_seo_domain_ranked_keywords or nexscope_seo_target_traffic_estimates to distinguish itself.

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 when-to-use guidance, no preconditions, and no named alternative. The only usage-adjacent line, "Seven-day source-freshness rules apply only to dependent requests," is opaque and does not tell an agent which request scenarios it governs or when to pick this tool over its numerous SEO siblings.

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.