Nuqti — Ahrefs-alternative SEO data

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds material context beyond them: the data source (Nuqti link index) and the exact composition of the result, which matters because there is no output schema. It does not mention data freshness, coverage limits, or auth, keeping it short of a 5.

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

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

Two sentences, both earning their place: the first is a dense but readable inventory of returned metrics, the second gives the usage trigger. Front-loaded with the resource, no padding.

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

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

With no output schema, the description carries the burden of explaining returns and does so by enumerating the metrics, and the one required parameter is fully documented. Missing are notes on freshness/coverage of the index estimate or any caveats about range interpretation.

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

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

Schema coverage is 100% and the single 'domain' parameter is already documented with an example ('example.com'), so the schema does the heavy lifting. The description's phrase 'of a website' only loosely reinforces the param and adds no format rules. Baseline 3 is appropriate.

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

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

States a specific resource (backlink profile of a website) and enumerates exactly what the summary contains: referring domain/link counts, whole-web estimate with range, dofollow/nofollow split, top anchors and TLD mix. It clearly distinguishes itself from a raw list like referring_domains by promising aggregates, though it never names that sibling explicitly.

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

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

Provides an explicit trigger phrasing ('Use for "how many backlinks does X have"'), which is a clear when-to-use signal. It stops short of stating when not to use it or pointing to alternatives such as referring_domains for the actual domain list.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description goes further by disclosing the data window (since 2018), sampling granularity (one point per quarter), and derived fields (gained/lost/net over 12 months plus trend) — substantial behavioral context beyond the annotations, though nothing on freshness/latency.

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

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

Two tight sentences: the first defines the data and its resolution, the second gives the interpretive use. Nothing redundant, and the most decision-relevant facts (metric, coverage, granularity) are front-loaded.

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

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

With no output schema, the description carries the burden of explaining return content, and it does: history depth, point cadence, the headline metric, and the 12-month gained/lost/net summary. For a single-parameter read tool with annotations, nothing needed for correct invocation is missing.

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

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

Only one parameter with 100% schema description coverage (including an 'e.g. example.com' example), so the schema does the heavy lifting. The description adds no format, normalization, or subdomain handling detail, which is the baseline-3 outcome when coverage is high.

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

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

States a specific metric (count of websites linking to a domain) and its temporal shape (multi-year history since 2018, quarterly points), which cleanly distinguishes it from siblings like referring_domains and backlinks_summary that report current snapshots. The verb+resource pair is unambiguous.

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

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

The closing clause 'Use to see if a site is growing or losing authority' gives an implied use case, but there is no explicit when-not guidance and no alternative tool named (e.g., use referring_domains for the current list). Adequate but leaves routing to inference.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds genuinely useful behavior beyond that: 'Free, cached data,' which tells the agent the results may be stale and involve no billing/rate-limit risk, and it names the output payload, which matters since no output schema exists.

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

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

A single front-loaded sentence — resource first, then the payload inventory — with no filler. 'Free, cached data' carries real information, though the enumerated list is dense and one item ('with explanation') is vague enough to add little.

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

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

For a two-parameter, read-only, open-world query tool whose annotations carry the safety profile and whose schema is fully documented, the description covers purpose and output contents adequately. The remaining gap is routing versus the backlink- and keyword-specific siblings, which is minor here.

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

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

Schema description coverage is 100%, so both parameters (domain, country enum with default 'us') are already documented with examples and an enum list. The description adds nothing about the domain format or the country/market parameter, so the baseline 3 applies.

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

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

States a specific resource (SEO snapshot of any website) and enumerates exactly what the snapshot contains: Authority score, organic traffic, ranking keywords, competitors, and backlink summary. This content list implicitly separates it from narrower siblings like backlinks_summary and keyword_overview, though it never names them outright.

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

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

Usage is implied by 'SEO snapshot of any website' — the agent can infer this is the general entry point — but there is no explicit when-to-use, when-not-to-use, or alternative routing (e.g., use domain_history for trends, backlinks_summary for deeper link data). Overlap with backlinks_summary is left for the agent to resolve.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description adds value beyond that by disclosing the return format ('full SEO data as text'), which matters since there is no output schema. It does not cover pagination or error conditions, but for a simple read that is a minor gap.

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

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

A single sentence with no wasted words; the action, the input source, and the return type are all front-loaded. Nothing could be removed without losing information.

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

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

For a one-parameter read tool with full schema coverage and annotations covering the safety profile, the description supplies purpose, input origin, and return format, which is sufficient to invoke it correctly. Only minor details (output shape specifics) are absent, and no output schema exists to carry them.

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

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

Schema description coverage is 100%, and the schema already documents the single 'id' parameter with an example format ('domain:example.com'). The description only echoes that the id comes from search, adding little beyond the schema, so the baseline 3 is appropriate.

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

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

The description states a specific action (open one result) and resource (a search result by id) and clarifies what comes back (full SEO data as text). It ties itself to the sibling 'search' as the source of the id, which meaningfully distinguishes it from the list/search tools, though it doesn't contrast against the other detail-oriented siblings like domain_overview.

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

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

It clearly places the tool in a workflow: use it on an id returned by search to expand a single result. There is no explicit 'when not to use this' or comparison against siblings such as domain_overview, but the prerequisite context is unambiguous.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=true, and the description usefully adds what the results contain (matching terms and questions, estimated volume, difficulty) plus the language support (English or Arabic). For a read-only lookup tool this is solid added context beyond the annotations.

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

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

Two tightly written sentences: capability first, then the follow-up workflow. Nothing is padded and the key result attributes are front-loaded.

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

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

There is no output schema, but the description compensates by naming the returned fields (terms, questions, volume, difficulty) and the language constraint. Enough for an agent to call it correctly, though it could say more about result ordering or limits.

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

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

Schema description coverage is 100%, so the schema already documents limit, country and keyword, setting the baseline at 3. The description adds meaning the schema lacks: the seed keyword may be English or Arabic, which is not encoded anywhere in the input schema.

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

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

The description states a specific resource and scope: keyword ideas for a seed keyword, sourced from real search queries, covering matching terms and questions with volume and difficulty. That is more than a restated title and lets an agent distinguish it from the analytics-style siblings.

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

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

It gives clear context ('use for content planning') and an explicit next step ('then call keyword_overview on the best ones'), which routes the agent through a two-tool workflow. It stops short of stating when NOT to use it over the alternatives, so it is not a full 5.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds some context by naming the data source ('Nuqti SERP') and implying live/current SERP results, but it says nothing about latency, rate limits, quota cost, or behavior for unknown/low-volume keywords — a notable omission for a paid external data lookup.

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

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

A single dense sentence with no filler; every item listed is a real return field. It is front-loaded with the core metric (search volume) though the lack of any sentence break makes the long enumeration slightly harder to scan.

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

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

With no output schema, the description usefully enumerates the return payload, which is genuinely needed. However, for a 2-parameter, multi-market tool it omits the market parameter's effect, prerequisites, and any usage context, so it is adequate but incomplete.

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

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

Schema description coverage is only 50%: country has an enum plus a short description, while keyword has none. The description never mentions the country/market parameter at all, even though keyword metrics are highly locale-dependent, so it fails to compensate for the coverage gap or clarify what 'keyword' should contain (single term vs phrase).

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

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

The description enumerates the metrics returned for a keyword (volume, difficulty, CPC, intent, SERP, PAA), which implies the purpose of fetching keyword research data, but it never states a verb or scope explicitly — it reads as a field list rather than a purpose statement. It also does nothing to distinguish itself from the sibling keyword_ideas tool, so an agent must guess which one to pick for a given research need.

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

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

There is no when-to-use guidance, no when-not-to-use, and no named alternative despite several plausible siblings (keyword_ideas, domain_overview, backlinks_summary, run_seo_tool). The agent gets no signal about whether this is for a single keyword lookup versus bulk discovery.

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

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

Annotations already declare readOnlyHint=true, so the safety profile is covered. The description adds that each entry includes required inputs, which is useful given there is no output schema, but it says nothing about format, size, or whether results are static or dynamic.

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

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

A single front-loaded sentence that names the resource before the enumeration. The long parenthetical catalog is dense but every item earns its place as a description of coverage; the trailing ellipsis is slightly loose.

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

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

For a zero-parameter listing tool with no output schema and only a readOnly annotation, the description covers what is returned (tool names plus required inputs) at an adequate level. Only the exact return structure remains unspecified, which is a minor gap.

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

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

The tool takes zero parameters, which is the baseline-4 case. The description notes that listed tools come 'with the input each one needs,' which is a small bonus but there are no parameters to document.

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

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

States a specific verb (Lists) and resource (Nuqti's free technical tools) and enumerates the tool categories it covers, so an agent knows exactly what it returns. It does not explicitly differentiate itself from siblings like run_seo_tool, though the catalog-vs-execute distinction is implied.

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

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

The phrase 'with the input each one needs' hints that this is a discovery step preceding run_seo_tool, but there is no explicit when-to-use statement or naming of the alternative. Usage is only implied.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds genuine behavioral context beyond that: results are ordered 'strongest first' and each row carries authority, link counts, dofollow counts, and first/last seen dates, which tells the agent what it will receive without an output schema.

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

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

Two sentences, no filler, with the core definition front-loaded and the use case trailing. Slightly dense in the first sentence's field enumeration, but every element earns its place.

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

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

With no output schema, the description usefully enumerates the returned fields and their ordering, which is exactly the gap it needs to fill. It stops short of describing pagination limits or behavior at large result sets, but that is a minor omission for a simple two-parameter read tool.

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

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

Schema coverage is 100% for both parameters, so the schema already documents 'domain' and the 1-100 limit. The description adds no new syntax or constraint detail beyond the ordering hint; baseline 3 is correct when the schema does the heavy lifting.

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

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

States a specific verb and resource ('list of websites that link to a domain') and names the canonical term 'referring domains' in parentheses, so the tool's identity is unambiguous. However, it never distinguishes itself from the highly confusable sibling backlinks_summary, leaving the agent to infer the boundary.

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

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

'Use for link-building research and competitor backlink analysis' gives an implied scenario, but there is no when-not guidance and no alternative named despite backlinks_summary and domain_overview being obvious candidates for the same intent. Usage is suggested rather than routed.

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

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

Annotations already declare readOnlyHint and openWorldHint, so the safety profile is covered. The description adds only that it 'Returns the full JSON result' — no output schema exists, so this is the sole return-value clue, and it is vague about structure, size, or failure modes (e.g. invalid slug, network errors).

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

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

Two sentences, front-loaded with the action and the slug source. The inline slug list is long but functions as useful illustration; it is not wasted space given the 40-value enum.

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

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

For a read-only, open-world dispatcher over 40 tools with no output schema, the definition covers the essential flow (fetch slugs, then run one). The gap is that the single return-value sentence is too thin to set expectations about JSON shape or per-tool differences.

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

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

At 67% schema description coverage the schema already documents q and q2. The description's slug examples hint at what q should be for each tool but never maps them to q vs q2, so it adds only marginal meaning beyond the schema and the enum list.

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

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

States a specific verb and resource ('Run one free Nuqti tool by slug') and names the sibling that provides the needed input ('get slugs from list_seo_tools'). An agent can distinguish this from list_seo_tools/domain_overview/keyword_overview without opening the schema.

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

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

Explicitly tells the agent where to obtain valid slugs and constrains to one tool per call, which is real routing guidance. It does not state when NOT to use it or when a dedicated sibling (e.g. domain_overview) is preferable to the corresponding slug.

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

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description adds genuinely useful behavioral context not in the schema or annotations: the tool returns result *ids* rather than full data, and those ids are meant to be opened with fetch. No permission or rate-limit details, but for a read-only search that is minor.

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

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

Two tight sentences with no filler, front-loading what the tool is and how to use it, then the return-handoff to fetch. Every clause earns its place.

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

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

With no output schema, the description correctly compensates by explaining the return shape (result ids) and the next step (fetch). For a one-parameter read-only search that is close to complete, though it omits any note on result volume or how to refine an ambiguous query.

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

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

Schema coverage is 100%, so the single 'query' parameter is already documented as 'A domain or a keyword'. The description paraphrases this and adds a format example ('example.com'), which is a marginal gain. Baseline 3 is appropriate when the schema does the work.

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

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

States a specific verb and resource ('Search Nuqti's SEO data') and clarifies the two input modes (domain or keyword). It also hints at its place in the sibling workflow by saying it 'returns result ids to open with fetch', but it does not explicitly differentiate itself from domain_overview or keyword_overview.

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

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

Gives clear context for use: supply a domain or a keyword, then hand the returned ids to fetch. This establishes the search-then-fetch workflow. It stops short of any exclusion guidance (e.g., when to prefer the more specific domain_overview or keyword_ideas tools).

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