ahrefs
Server Details
Ahrefs: Ahrefs API: SEO powerhouse featuring keyword research, backlink analysis, and SERP tracking.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 2.6/5 across 11 of 11 tools scored. Lowest: 1.1/5.
Each tool targets a distinct SEO function: backlinks, broken links, keyword difficulty, keyword generation per platform, rank checking, SERP analysis, and website metrics. The platform-specific keyword generators (Amazon, Bing, Google, YouTube) are clearly differentiated. No two tools overlap in purpose.
All tools follow a uniform 'get_v1_' prefix followed by a descriptive noun phrase, creating a predictable and coherent pattern. The consistent use of snake_case and the same verb prefix makes the toolset easy to scan and understand.
With 11 tools, the set is well-scoped for an SEO data provider. Each tool represents a meaningful API endpoint without unnecessary duplication or bloat. The count falls comfortably within the ideal range for a focused server.
The toolset covers core SEO workflows: link analysis (backlinks, broken links, authority), keyword research (difficulty, generators, rank), and SERP/traffic metrics. Minor gaps exist, such as missing site audit or content explorer tools, but the provided surface handles typical use cases effectively.
Available Tools
11 toolsget_v1_backlink_checkerBacklink CheckerAInspect
See the top 20 backlinks to any website or webpage. Group: Link Building. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| mode | No | One of the following: - exact: Only specified URL example.com/path/ - subdomains: Domain including subdomains *.example.com/* |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions the limit 'top 20' and the cost '1 Credits', which adds transparency. However, it does not disclose potential side effects, authentication requirements, rate limits, or error behaviors. Since there are no annotations, the description carries the full burden, but it is not fully transparent.
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?
The description is concise and well-structured. It includes essential information (function, limit, billing) without unnecessary fluff. Each sentence adds value, making it efficient and to the point.
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?
The description covers the main functionality, the limit, and billing, but it does not specify the output format or any prerequisites. Since there is no output schema, the description should provide more detail about what the user can expect, but the tool is simple enough that this is not critical.
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 'mode' parameter has a clear description with options, but 'url' only has a title and example. The example 'ahrefs.com' makes it clear that it is the target URL, but the lack of explicit description for 'url' is a minor gap. Overall, parameter meaning is adequately conveyed.
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 clearly states the tool's function: 'See the top 20 backlinks to any website or webpage.' It is specific (returns top 20 backlinks) and includes additional context like group and billing, but the core purpose 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?
While the description implies usage when backlinks are needed, it lacks explicit guidance on when to use this tool versus alternatives. No mention of when not to use or specific use cases beyond the general 'backlink checker' function.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_broken_link_checkerBroken Link CheckerCInspect
Broken Link Checker Group: Link Building. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| mode | No | One of the following: - exact: Only specified URL example.com/path/ - subdomains: Domain including subdomains *.example.com/* |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure, and it offers only one behavioral trait: the cost of 1 credit per call. This is genuinely useful for an agent deciding whether to invoke the tool, but it is the only disclosure—no information about limits, failure modes, rate constraints, or what happens on execution exists anywhere in the description.
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?
The description is undeniably brief and front-loaded, and technically every word does some work—the billing information is presented efficiently with no fluff. However, this is under-specification masquerading as conciseness; there simply isn't enough content to evaluate meaningful structural choices. It earns the middle score because what little is present is packed efficiently.
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 simple 2-parameter tool with no output schema and no annotations, the description needed to fill substantial gaps but instead only adds cost visibility. It doesn't explain what the tool returns, what 'exact' versus 'subdomains' mode means for results, or how this differs from the sibling SEO checkers. The one complete element is billing transparency, which prevents a score of 1, but the rest of the operational context is absent.
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?
With only 50% schema description coverage, the description needed to compensate for the undocumented 'url' parameter, but it adds nothing about parameters at all. While the 'mode' parameter is well-documented within the schema itself, 'url' is left as merely a title with an example, and the description could have explained URL format expectations, protocol handling, or how it interacts with the mode parameter.
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 'Broken Link Checker Group: Link Building' essentially restates the title with a category label, providing no verb or explanation of actual function. The only additional context is 'Link Building' which vaguely hints at the marketing domain, but the agent must infer the tool's behavior purely from its name. This is borderline tautological, with only a marginal nod to domain context.
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 zero guidance on when to use this tool versus any of the ten sibling SEO tools. The only contextual note is 'Billing per call: 1 Credits,' which communicates cost but says nothing about appropriate use cases, prerequisites, or alternatives. An agent would have no way to distinguish when to reach for the broken link checker versus the backlink checker or website traffic checker.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_keyword_difficulty_checkerKeyword Difficulty CheckerBInspect
Find out how hard it'll be to rank in the top 10 for any keyword. Group: Keyword Research. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden for behavioral disclosure. However, it only states the tool's purpose and billing details. It does not mention required inputs, error handling, rate limits, or what kind of result is returned (e.g., a numeric score). The agent has no insight into side effects or constraints beyond the obvious read-only nature of a difficulty checker.
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?
The description is concise, with the purpose front-loaded in the first sentence. The second sentence includes group and billing info, which is somewhat redundant but not verbatim from metadata (since annotations are absent). It is efficiently structured and contains no fluff.
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?
Given the tool's simplicity (2 parameters, no output schema), the description still fails to explain what the output will look like or how to interpret the difficulty result. It does not mention any limits, examples of output, or how the scoring works. The agent is left without key information to confidently use and interpret the tool's response.
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 0%, and the description does not elaborate on the parameters 'country' and 'keyword'. While the parameter names are somewhat self-explanatory, the description adds no additional context about acceptable formats, default values, or optionality. With no schema descriptions, the burden falls on the description, which fails to compensate.
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 clearly states the tool's function: finding how hard it will be to rank in the top 10 for a keyword. This is a specific verb+resource with a clear outcome, and it naturally distinguishes from sibling tools like backlink checkers or rank checkers by focusing on difficulty.
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 description implies usage for keyword research ('Group: Keyword Research') but provides no explicit guidance on when to choose this tool over alternatives, nor any exclusions or prerequisites. It lacks a clear 'use this when...' statement, so agents must infer applicability.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_keyword_generator_amazonAmazon Keyword GeneratorBInspect
Find what people are searching for on Amazon, and align your product listings with those terms. Group: Keyword Research. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions billing (1 Credit) and grouping but does not describe output format, data source behavior, limitations, or required inputs. This is a significant gap for a tool with no 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?
The description is three short sentences, front-loaded with the core purpose and followed by compact metadata. There is no filler or redundant wording.
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 and no annotations, the description should clarify return values and parameter behavior, but it does not. The tool is simple, so the description is partially adequate, but it omits important operational context.
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 0%, and the description does not explain the 'country' or 'keyword' parameters beyond what their names and schema examples already convey. It fails to compensate for the lack of schema descriptions.
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 uses a specific verb ('Find') and resource ('what people are searching for on Amazon'), clearly identifying the tool's function. The explicit mention of Amazon distinguishes it from sibling keyword generators for Bing, Google, and YouTube.
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 'align your product listings with those terms' implies an Amazon listing optimization use case, but there is no explicit guidance on when to prefer this tool over alternatives or when not to use it. No exclusions or sibling comparisons are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_keyword_generator_bingBing Keyword GeneratorBInspect
Discover the keywords people search for on Bing. Analyze their SEO potential. Group: Keyword Research. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the transparency burden. It adds context about grouping and billing ('Group: Keyword Research. Billing per call: 1 Credits') and indicates a read-style analysis behavior, but it does not disclose limitations, required inputs, or output format.
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?
The description is brief, front-loaded with the core purpose, and each sentence adds distinct information: what it does, the SEO angle, group, and billing. No wasted words.
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 annotations, no output schema, and minimal parameter descriptions, the tool description leaves significant gaps. It does not explain what the response contains, how results are ranked, or what 'SEO potential' means, making it incomplete for reliable tool selection and invocation.
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 0% and the description does not mention the 'country' or 'keyword' parameters at all. The schema only provides titles and examples, and the description adds no additional meaning about how these parameters affect results.
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 clearly states the tool discovers Bing search keywords and analyzes their SEO potential, with a specific verb-resource pairing. The mention of 'Bing' distinguishes it from sibling keyword generator tools for Google, Amazon, and YouTube.
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?
No guidance is provided about when to use this tool versus alternatives, such as the Google or Amazon keyword generators. The tool name and 'Bing' mention imply context, but the description does not state conditions, exclusions, or alternative recommendations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_keyword_generator_googleGoogle Keyword GeneratorDInspect
Find thousands of relevant keyword ideas in seconds. Group: Keyword Research. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose any behavioral traits such as output format, rate limits, or side effects. It only mentions billing per call, which is a cost detail, not a behavioral disclosure. This is a significant gap for a tool that makes external calls.
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?
The description is minimal (one sentence plus metadata) and could be considered concise, but it is under-specified rather than appropriately sized. The Group and Billing information is extra but not harmful. However, the brevity undermines usefulness.
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?
Given the lack of output schema, parameter descriptions, and usage guidance, the description is far from complete. The tool performs a specific type of keyword research, but the description fails to convey essential context like the data source (Google), return structure, or limitations.
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 input schema has 2 parameters with no descriptions and 0% schema coverage. The description does not mention 'country' or 'keyword', nor does it explain their format, defaults, or optionality. The agent has no guidance on how to fill these fields effectively.
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 'Find thousands of relevant keyword ideas' which is a clear verb+resource, but it does not explicitly mention Google or differentiate from sibling tools like Amazon, Bing, or YouTube keyword generators. The Group and Billing notes add operational context but not purpose specificity.
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 guidance on when to use this tool versus the other keyword generator variants. No context, prerequisites, or exclusions are provided, so an agent would not know if this is the right tool for a Google-specific search.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_keyword_generator_youtubeYouTube Keyword GeneratorAInspect
YouTube Keyword Generator Group: Keyword Research. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses billing costs (1 credit per call), but does not mention other behavioral aspects like data returned, rate limits, or side effects. This is a partial disclosure.
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?
The description is brief and to the point, consisting of two sentences. It includes extra details (group, billing) without being verbose, and structure is clean.
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 simple tool with two parameters, the description is sufficient for basic understanding. It lacks advanced context but is not incomplete for the tool's simplicity.
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 schema provides titles and examples for parameters (country, keyword), but the description adds no additional explanation about their meaning or format. Coverage is adequate but not enhanced.
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 clearly states the tool's function as a YouTube keyword generator, and the title reinforces this. It distinguishes from sibling tools that target other platforms.
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?
While not explicit, the tool name and sibling list imply it is for YouTube keyword research. No explicit when-not-to-use guidance is given, but the context is clear enough.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_keyword_rank_checkerKeyword Rank CheckerCInspect
Keyword Rank Checker Group: SERP & Ranking. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | No | ||
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It only mentions billing per call (1 credit), which is a minor behavioral detail. It does not disclose what the tool returns, whether it is read-only, or any side effects. The description is too sparse to provide meaningful transparency.
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?
The description is extremely short, which is concise, but it is under-specified rather than efficiently structured. It has two sentences, but the first is a group label and the second is billing info. It is not front-loaded with useful information. It earns a 3 because it is not verbose, but it lacks substance.
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?
Given the tool's complexity (3 parameters, no output schema, no annotations), the description is inadequate. It does not explain the purpose, the parameters, or the expected output. The sibling tools are similar, so more context is needed to differentiate. The description is far from complete.
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 0%, and the description does not explain any parameters. The schema provides titles and examples (domain, country, keyword), but the description adds no additional meaning. For a tool with 3 parameters and no coverage, the description should compensate, but it does not.
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 is minimal and vague: 'Keyword Rank Checker Group: SERP & Ranking. Billing per call: 1 Credits.' It does not state what the tool does with a specific verb and resource. It mentions 'SERP & Ranking' but does not clarify that it checks keyword rankings for a domain. It is not a tautology, but it is too vague to distinguish from siblings like get_v1_serp_checker.
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?
No guidance on when to use this tool versus alternatives. The sibling list includes get_v1_serp_checker and get_v1_keyword_difficulty_checker, but the description does not explain the difference or provide context for selection. The only hint is 'SERP & Ranking' which is implicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_serp_checkerSERP CheckerDInspect
SERP Checker Group: SERP & Ranking. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| keyword | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of disclosing behavioral traits. However, it says nothing about side effects (e.g., whether it is read-only, whether it mutates data, rate limits, or billing implications). The only mention of billing is 'Billing per call: 1 Credits,' which is a cost hint but not a behavioral trait. Without any operational or safety information, the agent cannot anticipate consequences of invocation.
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?
The description is extremely brief (one line), but it is under-specified rather than concise. It includes irrelevant billing information that belongs in pricing metadata, not the description. Real conciseness would convey the purpose in as few words as possible, but here the brevity comes at the cost of any utility. Therefore, the low word count is not an asset; it is a deficiency.
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?
The tool is likely a SERP ranking checker, but the description provides no information about its function, acceptable inputs, output format (no output schema), or edge cases. With no annotations and no output schema, the description is the only source of context, and it fails to provide any operational detail. The tool has only two simple parameters, but even so, the description is incomplete; it does not even name the parameters.
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 0%, and the description does not explain any parameters. The parameters are country and keyword, but neither the schema nor the description provides semantics: no explanation that country might default to 'us' if omitted, or that keyword is essential for a SERP check. With zero coverage, the description should compensate, but it does not. Baseline for 0 params is 4, but here there are 2 parameters and no extra info, making the score 1.
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 says 'SERP Checker Group: SERP & Ranking. Billing per call: 1 Credits.' This does not state what the tool actually does (e.g., check search engine results page rankings for a keyword). It is almost entirely billing and group information, leaving the agent with no clear action of 'SERP Checker' from the title and sibling tools, so purpose is ambiguous at best. The tool name itself is technical and unhelpful. This is a severe gap: the purpose is not clarified beyond the name and title, which provide no actionable description.
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 description provides zero guidance on when to use this tool versus alternatives. It does not mention that it is for SERP tracking or ranking checks, nor does it differentiate from siblings like get_v1_keyword_rank_checker or get_v1_website_traffic_checker. There is no context on appropriate scenarios, prerequisites, or exclusions. The agent is left to guess based only on the name, which is insufficient.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_website_authority_checkerWebsite Authority CheckerDInspect
Website Authority Checker Group: Link Building. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations and the description provides no behavioral disclosure. It does not mention what authority metric is returned, whether this is a read-only operation, or any limits/requirements, leaving the agent with no information about runtime behavior.
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?
The description is short but under-specified rather than concise. The first phrase is redundant with the title, and the remaining billing/category note does not compensate for the missing functional explanation.
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?
Although this is a simple one-parameter tool, there is no output schema, annotations, or behavioral context to clarify what 'website authority' means or what the caller receives. The billing note is useful but insufficient for tool selection and invocation.
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 description does not mention the url parameter at all. The input schema provides a title 'Target URL' and an example, but the description adds no semantic value beyond that, despite the low schema description coverage.
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 opens with the exact title 'Website Authority Checker' and adds only a category and billing note. It does not state what the tool does in verb+resource terms, so it largely restates the name/title without conveying functional purpose.
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?
No guidance is given about when to use this tool versus sibling checkers like get_v1_website_traffic_checker or get_v1_backlink_checker. 'Link Building' is a broad category, not an explicit usage criterion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_v1_website_traffic_checkerWebsite Traffic CheckerDInspect
Website Traffic Checker Group: SERP & Ranking. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| mode | No | One of the following: - exact: Only specified URL example.com/path/ - subdomains: Domain including subdomains *.example.com/* |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must carry the burden of explaining behavioral traits. It does disclose the per-call credit cost, which is a useful operational detail, but it says nothing about whether the operation is a read-only lookup, how results are returned, what 'traffic checker' actually does, or any side effects or constraints. This leaves critical behavioral uncertainty unresolved.
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?
The description is short, but the sentences are not informative. The first sentence duplicates the title, and the second is only a billing note. While it is not verbose, it is under-specified rather than appropriately concise, and the phrase 'Billing per call: 1 Credits' could have been represented as structured metadata.
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?
This is a simple 2-parameter tool with no annotations and no output schema, so the description is the only source of operational context. It fails to explain the tool's actual purpose, when to use it, how the parameters work, or what type of data is returned. The description is far too incomplete to enable reliable selection and invocation.
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 input schema documents the 'mode' parameter but the 'url' parameter only has an example. The description adds no additional meaning over the schema, failing to clarify URL format, required format, or interaction between URL and mode. With only 50% schema description coverage, the description should compensate but does not.
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 merely repeats the title ('Website Traffic Checker') and adds a categorization ('Group: SERP & Ranking') along with billing information. It does not state a specific verb or resource, leaving unclear what exactly the tool does (e.g., estimate traffic, rank pages, or return metrics). It does not distinguish this from sibling tools like get_v1_serp_checker or get_v1_website_authority_checker.
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 guidance on when to use this tool versus the many similar sibling tools. The description only mentions a category and billing cost, so an agent cannot determine if this is the appropriate tool for a traffic or ranking query. No exclusions or alternative tool suggestions are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Servers
- Alicense-qualityBmaintenanceEnables SEO data retrieval including backlinks, keyword research, keyword difficulty, and traffic estimation using Ahrefs free tools.0MIT
- AlicenseBqualityDmaintenanceGet access to real-time SEO data, including: keyword insights, backlink data, traffic estimates and more. Allow AI tools and Large Language Models (LLMs) to tap into the real-time SEO Review Tools API with natural language commands.856MIT
- Alicense-qualityCmaintenanceEnables SEO analysis via Ahrefs API v3, providing tools for domain rating, backlinks stats, top organic keywords, and top pages with SQLite caching and Lite plan budget tracking.MIT
- AlicenseBqualityCmaintenanceEnables AI coding assistants to perform SEO research tasks including backlink analysis, keyword research, traffic estimation, and keyword difficulty analysis using Ahrefs data directly within IDEs.4188MIT