Skip to main content
Glama

AIsa Backlinks

by one.aisa
OverviewDiscussionsAdmin

Bulk Ranks

post_dataforseo_backlinks_bulk_ranks_live
Destructive

‌ This endpoint will provide you with rank scores of the domains, subdomains, and pages specified in the targets array. The score is based on the number of referring domains pointing to the specified domains, subdomains, or pages. The rank values represent real-time data for the date of the request and range from 0 (no backlinks detected) to 1,000 (highest rank). A similar scoring system is used in Google’s Page Rank algorithm. You can learn more about rank scores in this help center article

Usage-based billing; Default request estimate: $0.025 USD (not a fixed price). Account-specific pricing and final settlement may differ.

Input Schema

NameRequiredDescriptionDefault
bodyNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / body / items / oneOf
      Previous value: -[
-  {
-    "example": [
-      {
-        "targets": [
-          "forbes.com",
-          "cnn.com",
-          "bbc.com",
-          "yelp.com",
-          "https://www.apple.com/iphone/",
-          "https://ahrefs.com/blog/",
-          "ibm.com",
-          "https://variety.com/",
-          "https://stackoverflow.com/",
-          "www.trustpilot.com"
-        ]
-      }
-    ],
-    "properties": {
-      "rank_scale": {
-        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "tag": {
-        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "targets": {
-        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "rank_scale": {
+        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "tag": {
+        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]
  2. Changed2 schema fields changed
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
-  {
-    "example": [
-      {
-        "targets": [
-          "forbes.com",
-          "cnn.com",
-          "bbc.com",
-          "yelp.com",
-          "https://www.apple.com/iphone/",
-          "https://ahrefs.com/blog/",
-          "ibm.com",
-          "https://variety.com/",
-          "https://stackoverflow.com/",
-          "www.trustpilot.com"
-        ]
-      }
-    ],
-    "properties": {
-      "rank_scale": {
-        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "tag": {
-        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "targets": {
-        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  }
-]
    • addedInput schema / properties / body / items / oneOf
      Added value: +[
+  {
+    "example": [
+      {
+        "targets": [
+          "forbes.com",
+          "cnn.com",
+          "bbc.com",
+          "yelp.com",
+          "https://www.apple.com/iphone/",
+          "https://ahrefs.com/blog/",
+          "ibm.com",
+          "https://variety.com/",
+          "https://stackoverflow.com/",
+          "www.trustpilot.com"
+        ]
+      }
+    ],
+    "properties": {
+      "rank_scale": {
+        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "tag": {
+        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]
  3. Changed7 schema fields changed
    • addedInput schema / properties / body / example
      Added value: +[
+  {
+    "targets": [
+      "forbes.com",
+      "cnn.com",
+      "bbc.com",
+      "yelp.com",
+      "https://www.apple.com/iphone/",
+      "https://ahrefs.com/blog/",
+      "ibm.com",
+      "https://variety.com/",
+      "https://stackoverflow.com/",
+      "www.trustpilot.com"
+    ]
+  }
+]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
+  {
+    "example": [
+      {
+        "targets": [
+          "forbes.com",
+          "cnn.com",
+          "bbc.com",
+          "yelp.com",
+          "https://www.apple.com/iphone/",
+          "https://ahrefs.com/blog/",
+          "ibm.com",
+          "https://variety.com/",
+          "https://stackoverflow.com/",
+          "www.trustpilot.com"
+        ]
+      }
+    ],
+    "properties": {
+      "rank_scale": {
+        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "tag": {
+        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
-  "rank_scale": {
-    "description": "defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values optional field you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: one_hundred — rank values are displayed on a 0–100 scale one_thousand — rank values are displayed on a 0–1000 scale default value: one_thousand learn more about how this parameter works and how ranking metrics are calculated in this Help Center article",
-    "type": "string"
-  },
-  "tag": {
-    "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
-    "type": "string"
-  },
-  "targets": {
-    "description": "domains, subdomains or webpages to get rank for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: \"targets\": [ \"forbes.com\", \"cnn.com\", \"bbc.com\", \"yelp.com\", \"https://www.apple.com/iphone/\", \"https://ahrefs.com/blog/\", \"ibm.com\", \"https://variety.com/\", \"https://stackoverflow.com/\", \"www.trustpilot.com\" ]",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  }
-}
    • removedInput schema / properties / body / items / required
      Removed value: -[
-  "targets"
-]
    • changedInput schema / properties / body / items / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / required
      Previous value: -[
-  "body"
-]New value: +[]
    • addedOutput schema / x-fastmcp-wrap-result
      Added value: +true
  4. Changed7 schema fields changed
    • removedInput schema / properties / body / example
      Removed value: -[
-  {
-    "targets": [
-      "forbes.com",
-      "cnn.com",
-      "bbc.com",
-      "yelp.com",
-      "https://www.apple.com/iphone/",
-      "https://ahrefs.com/blog/",
-      "ibm.com",
-      "https://variety.com/",
-      "https://stackoverflow.com/",
-      "www.trustpilot.com"
-    ]
-  }
-]
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
-  {
-    "example": [
-      {
-        "targets": [
-          "forbes.com",
-          "cnn.com",
-          "bbc.com",
-          "yelp.com",
-          "https://www.apple.com/iphone/",
-          "https://ahrefs.com/blog/",
-          "ibm.com",
-          "https://variety.com/",
-          "https://stackoverflow.com/",
-          "www.trustpilot.com"
-        ]
-      }
-    ],
-    "properties": {
-      "rank_scale": {
-        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "tag": {
-        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "targets": {
-        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  }
-]
    • addedInput schema / properties / body / items / properties
      Added value: +{
+  "rank_scale": {
+    "description": "defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values optional field you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: one_hundred — rank values are displayed on a 0–100 scale one_thousand — rank values are displayed on a 0–1000 scale default value: one_thousand learn more about how this parameter works and how ranking metrics are calculated in this Help Center article",
+    "type": "string"
+  },
+  "tag": {
+    "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
+    "type": "string"
+  },
+  "targets": {
+    "description": "domains, subdomains or webpages to get rank for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: \"targets\": [ \"forbes.com\", \"cnn.com\", \"bbc.com\", \"yelp.com\", \"https://www.apple.com/iphone/\", \"https://ahrefs.com/blog/\", \"ibm.com\", \"https://variety.com/\", \"https://stackoverflow.com/\", \"www.trustpilot.com\" ]",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  }
+}
    • addedInput schema / properties / body / items / required
      Added value: +[
+  "targets"
+]
    • changedInput schema / properties / body / items / type
      Previous value: -[
-  "object",
-  "null"
-]New value: +"object"
    • changedInput schema / required
      Previous value: -[]New value: +[
+  "body"
+]
    • removedOutput schema / x-fastmcp-wrap-result
      Removed value: -true
  5. Changed7 schema fields changed
    • addedInput schema / properties / body / example
      Added value: +[
+  {
+    "targets": [
+      "forbes.com",
+      "cnn.com",
+      "bbc.com",
+      "yelp.com",
+      "https://www.apple.com/iphone/",
+      "https://ahrefs.com/blog/",
+      "ibm.com",
+      "https://variety.com/",
+      "https://stackoverflow.com/",
+      "www.trustpilot.com"
+    ]
+  }
+]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
+  {
+    "example": [
+      {
+        "targets": [
+          "forbes.com",
+          "cnn.com",
+          "bbc.com",
+          "yelp.com",
+          "https://www.apple.com/iphone/",
+          "https://ahrefs.com/blog/",
+          "ibm.com",
+          "https://variety.com/",
+          "https://stackoverflow.com/",
+          "www.trustpilot.com"
+        ]
+      }
+    ],
+    "properties": {
+      "rank_scale": {
+        "description": "<em>defines the scale used for calculating and displaying the <code>rank</code>, <code>domain_from_rank</code>, and <code>page_from_rank</code> values</em><br>optional field<p>you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale<p>possible values:<br><code>one_hundred</code> — rank values are displayed on a 0–100 scale<br><code>one_thousand</code> — rank values are displayed on a 0–1000 scale<p>default value: <code>one_thousand</code><p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article</a>",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "tag": {
+        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get <code>rank</code> for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without <code>https://</code> and <code>www.</code><br>the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br>`\"targets\": [<br>  \"forbes.com\",<br>  \"cnn.com\",<br>  \"bbc.com\",<br>  \"yelp.com\",<br>  \"https://www.apple.com/iphone/\",<br>  \"https://ahrefs.com/blog/\",<br>  \"ibm.com\",<br>  \"https://variety.com/\",<br>  \"https://stackoverflow.com/\",<br>  \"www.trustpilot.com\"<br>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
-  "rank_scale": {
-    "description": "defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values optional field you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: one_hundred — rank values are displayed on a 0–100 scale one_thousand — rank values are displayed on a 0–1000 scale default value: one_thousand learn more about how this parameter works and how ranking metrics are calculated in this Help Center article",
-    "type": "string"
-  },
-  "tag": {
-    "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
-    "type": "string"
-  },
-  "targets": {
-    "description": "domains, subdomains or webpages to get rank for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: \"targets\": [ \"forbes.com\", \"cnn.com\", \"bbc.com\", \"yelp.com\", \"https://www.apple.com/iphone/\", \"https://ahrefs.com/blog/\", \"ibm.com\", \"https://variety.com/\", \"https://stackoverflow.com/\", \"www.trustpilot.com\" ]",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  }
-}
    • removedInput schema / properties / body / items / required
      Removed value: -[
-  "targets"
-]
    • changedInput schema / properties / body / items / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / required
      Previous value: -[
-  "body"
-]New value: +[]
    • addedOutput schema / x-fastmcp-wrap-result
      Added value: +true
  6. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true, readOnlyHint=false, idempotentHint=false, and openWorldHint=true, so the safety profile is covered structurally. The description adds useful behavioral context — real-time data for the request date and a usage-based cost estimate ($0.025) — but does not explain why a data-retrieval endpoint carries a destructive hint (credit consumption) or address rate limits.

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

Conciseness4/5

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

The core paragraph is front-loaded and efficient, defining the output and its meaning in a few sentences. The appended pricing block is boilerplate but compact and clearly delimited, so it does not obscure the main content.

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

Completeness4/5

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

With an output schema present, return values need not be described, and the description adequately covers the operation, the rank scale, and its real-time nature for a simple single-parameter tool. The main omission is routing guidance relative to the numerous sibling backlinks endpoints.

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

Parameters3/5

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

Reported schema description coverage is 0% for the single top-level 'body' parameter, so the description carries extra weight; it references the 'targets array' and the rank range (0–1000). However, it does not explain the 'rank_scale' toggle or the 'tag' identifier beyond what the nested schema already documents, so it does not fully compensate for the coverage gap.

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

Purpose4/5

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

The description states a specific verb and resource: it returns rank scores for the domains, subdomains, and pages passed in the targets array, and explains the scoring basis (number of referring domains). This clearly separates it from siblings like bulk_backlinks or bulk_referring_domains. It stops short of explicitly naming which sibling to prefer, but the resource is unambiguous.

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 endpoint versus the many sibling backlinks endpoints (e.g., bulk_spam_score, bulk_pages_summary), and no mention of prerequisites or exclusions. The description explains the concept of a rank score but never says in what situation an agent should choose this tool.

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

All AIsa Backlinks toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources