Skip to main content
Glama

AIsa SEO & AI Visibility

by one.aisa
OverviewDiscussionsAdmin

SERP API AI Summary

post_dataforseo_serp_ai_summary
Destructive

‌‌ The purpose of the Live SERP API AI Summary endpoint is to provide a summary of the content found on any SERP and generate a response based on the user’s specified prompt. To obtain results, you have to specify task_id, which you can find in the response to the POST request. Learn more in our Help Center.

Usage-based billing; Default request estimate: $0.02 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": [
-      {
-        "fetch_content": true,
-        "include_links": true,
-        "prompt": "explain what DataForSEO is",
-        "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
-      }
-    ],
-    "properties": {
-      "fetch_content": {
-        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "include_links": {
-        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "prompt": {
-        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "support_extra": {
-        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "task_id": {
-        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "fetch_content": {
+        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "include_links": {
+        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "prompt": {
+        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "support_extra": {
+        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "task_id": {
+        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]
  2. Changed2 schema fields changed
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
-  {
-    "example": [
-      {
-        "fetch_content": true,
-        "include_links": true,
-        "prompt": "explain what DataForSEO is",
-        "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
-      }
-    ],
-    "properties": {
-      "fetch_content": {
-        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "include_links": {
-        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "prompt": {
-        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "support_extra": {
-        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "task_id": {
-        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }
-]
    • addedInput schema / properties / body / items / oneOf
      Added value: +[
+  {
+    "example": [
+      {
+        "fetch_content": true,
+        "include_links": true,
+        "prompt": "explain what DataForSEO is",
+        "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
+      }
+    ],
+    "properties": {
+      "fetch_content": {
+        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "include_links": {
+        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "prompt": {
+        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "support_extra": {
+        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "task_id": {
+        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]
  3. Changed7 schema fields changed
    • addedInput schema / properties / body / example
      Added value: +[
+  {
+    "fetch_content": true,
+    "include_links": true,
+    "prompt": "explain what DataForSEO is",
+    "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
+  }
+]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
+  {
+    "example": [
+      {
+        "fetch_content": true,
+        "include_links": true,
+        "prompt": "explain what DataForSEO is",
+        "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
+      }
+    ],
+    "properties": {
+      "fetch_content": {
+        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "include_links": {
+        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "prompt": {
+        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "support_extra": {
+        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "task_id": {
+        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
-  "fetch_content": {
-    "description": "fetch content from pages in SERPs optional field if set to true, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result; default value: false",
-    "type": "boolean"
-  },
-  "include_links": {
-    "description": "include source links in the summary optional field if set to true, the summary field in the API response will contain links to sources of the generated summary; default value: false",
-    "type": "boolean"
-  },
-  "prompt": {
-    "description": "AI prompt optional field additional task for AI summariser; any form of text, question or information that communicates to AI what response you're looking for; max number of symbols or characters you can specify: 2000; note: your prompt has to be relevant to the keyword specified in the POST request to SERP API",
-    "type": "string"
-  },
-  "support_extra": {
-    "description": "support extra SERP features optional field if set to true, the AI model will consider the following extra SERP features, in addition to organic results: answer_box, knowledge_graph, featured_snippet; default value: true",
-    "type": "boolean"
-  },
-  "task_id": {
-    "description": "task identifier required field unique identifier of the associated task in the UUID format you will be able to use it within 30 days to request the results of the task at any time",
-    "type": "string"
-  }
-}
    • removedInput schema / properties / body / items / required
      Removed value: -[
-  "task_id"
-]
    • 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: -[
-  {
-    "fetch_content": true,
-    "include_links": true,
-    "prompt": "explain what DataForSEO is",
-    "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
-  }
-]
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
-  {
-    "example": [
-      {
-        "fetch_content": true,
-        "include_links": true,
-        "prompt": "explain what DataForSEO is",
-        "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
-      }
-    ],
-    "properties": {
-      "fetch_content": {
-        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "include_links": {
-        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "prompt": {
-        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "support_extra": {
-        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "task_id": {
-        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }
-]
    • addedInput schema / properties / body / items / properties
      Added value: +{
+  "fetch_content": {
+    "description": "fetch content from pages in SERPs optional field if set to true, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result; default value: false",
+    "type": "boolean"
+  },
+  "include_links": {
+    "description": "include source links in the summary optional field if set to true, the summary field in the API response will contain links to sources of the generated summary; default value: false",
+    "type": "boolean"
+  },
+  "prompt": {
+    "description": "AI prompt optional field additional task for AI summariser; any form of text, question or information that communicates to AI what response you're looking for; max number of symbols or characters you can specify: 2000; note: your prompt has to be relevant to the keyword specified in the POST request to SERP API",
+    "type": "string"
+  },
+  "support_extra": {
+    "description": "support extra SERP features optional field if set to true, the AI model will consider the following extra SERP features, in addition to organic results: answer_box, knowledge_graph, featured_snippet; default value: true",
+    "type": "boolean"
+  },
+  "task_id": {
+    "description": "task identifier required field unique identifier of the associated task in the UUID format you will be able to use it within 30 days to request the results of the task at any time",
+    "type": "string"
+  }
+}
    • addedInput schema / properties / body / items / required
      Added value: +[
+  "task_id"
+]
    • 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: +[
+  {
+    "fetch_content": true,
+    "include_links": true,
+    "prompt": "explain what DataForSEO is",
+    "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
+  }
+]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
+  {
+    "example": [
+      {
+        "fetch_content": true,
+        "include_links": true,
+        "prompt": "explain what DataForSEO is",
+        "task_id": "07031739-1535-0139-0000-9d1e639a5b7d"
+      }
+    ],
+    "properties": {
+      "fetch_content": {
+        "description": "<em>fetch content from pages in SERPs</em><br>optional field<br>if set to <code>true</code>, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "include_links": {
+        "description": "<em>include source links in the summary</em><br>optional field<br>if set to <code>true</code>, the <code>summary</code> field in the API response will contain links to sources of the generated summary;<br>default value: <code>false</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "prompt": {
+        "description": "<em>AI prompt</em><br>optional field<br>additional task for AI summariser;<br>any form of text, question or information that communicates to AI what response you're looking for;<br>max number of symbols or characters you can specify: <code>2000</code>;<br><strong>note:</strong> your prompt has to be relevant to the keyword specified in the POST request to SERP API",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "support_extra": {
+        "description": "<em>support extra SERP features</em><br>optional field<br>if set to <code>true</code>, the AI model will consider the following extra SERP features, in addition to <code>organic</code> results: <code>answer_box</code>, <code>knowledge_graph</code>, <code>featured_snippet</code>;<br>default value: <code>true</code>",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "task_id": {
+        "description": "<em>task identifier</em><br><strong>required field</strong><br>unique identifier of the associated task in the <a href=\"https://en.wikipedia.org/wiki/Universally_unique_identifier\">UUID</a> format<br>you will be able to use it within <strong>30 days</strong> to request the results of the task at any time",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  }
+]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
-  "fetch_content": {
-    "description": "fetch content from pages in SERPs optional field if set to true, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result; default value: false",
-    "type": "boolean"
-  },
-  "include_links": {
-    "description": "include source links in the summary optional field if set to true, the summary field in the API response will contain links to sources of the generated summary; default value: false",
-    "type": "boolean"
-  },
-  "prompt": {
-    "description": "AI prompt optional field additional task for AI summariser; any form of text, question or information that communicates to AI what response you're looking for; max number of symbols or characters you can specify: 2000; note: your prompt has to be relevant to the keyword specified in the POST request to SERP API",
-    "type": "string"
-  },
-  "support_extra": {
-    "description": "support extra SERP features optional field if set to true, the AI model will consider the following extra SERP features, in addition to organic results: answer_box, knowledge_graph, featured_snippet; default value: true",
-    "type": "boolean"
-  },
-  "task_id": {
-    "description": "task identifier required field unique identifier of the associated task in the UUID format you will be able to use it within 30 days to request the results of the task at any time",
-    "type": "string"
-  }
-}
    • removedInput schema / properties / body / items / required
      Removed value: -[
-  "task_id"
-]
    • 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. Changed5 schema fields changed
    • changedInput schema / properties / body / items / properties / fetch_content / description
      Previous value: -"Whether to fetch content from pages in SERPs; default false"New value: +"fetch content from pages in SERPs optional field if set to true, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result; default value: false"
    • changedInput schema / properties / body / items / properties / include_links / description
      Previous value: -"Whether to include source links in the summary; default false"New value: +"include source links in the summary optional field if set to true, the summary field in the API response will contain links to sources of the generated summary; default value: false"
    • changedInput schema / properties / body / items / properties / prompt / description
      Previous value: -"Additional AI prompt; maximum 2000 characters"New value: +"AI prompt optional field additional task for AI summariser; any form of text, question or information that communicates to AI what response you're looking for; max number of symbols or characters you can specify: 2000; note: your prompt has to be relevant to the keyword specified in the POST request to SERP API"
    • changedInput schema / properties / body / items / properties / support_extra / description
      Previous value: -"Whether to consider extra SERP features such as answer_box, knowledge_graph, and featured_snippet; default true"New value: +"support extra SERP features optional field if set to true, the AI model will consider the following extra SERP features, in addition to organic results: answer_box, knowledge_graph, featured_snippet; default value: true"
    • changedInput schema / properties / body / items / properties / task_id / description
      Previous value: -"Unique identifier of the associated task in UUID format; can be used within 30 days"New value: +"task identifier required field unique identifier of the associated task in the UUID format you will be able to use it within 30 days to request the results of the task at any time"
  7. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare openWorldHint, non-idempotency and destructiveHint, so the safety bar is lower. The description adds genuinely useful context beyond them: usage-based billing with a ~$0.02 request estimate, the fact that results depend on a prior POST, and the 30-day task_id validity window. It does not explain why a summarization call is flagged destructive or what resources are consumed, which is a notable omission given that surprising annotation.

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?

Two core sentences are front-loaded and free of filler, with pricing isolated in a clearly marked block. Minor noise remains: a leading zero-width character, raw HTML comment markers, and a 'Learn more in our Help Center' pointer with no actual link.

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

Completeness3/5

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

An output schema exists, so return values need not be explained, and cost plus the task_id prerequisite are covered. However, the body is an array of task objects, implying multiple tasks can be submitted in one call, and the description speaks only of a singular task_id; it also omits the optional toggles that materially change the summary, leaving the agent under-informed about how to call it fully.

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?

Top-level schema description coverage is 0% (the only top-level property is the undescribed 'body' array), so the description should compensate, but it only restates the task_id requirement already documented in the nested schema and says nothing about prompt, fetch_content, include_links, or support_extra. It also asserts task_id is mandatory while the schema marks no required fields, leaving an unresolved ambiguity.

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?

States a specific verb and resource: it summarizes SERP content and generates a response driven by a user prompt, which is clearly distinguishable from raw SERP retrieval tools like post_dataforseo_serp_google_organic_live. It does not, however, differentiate itself from the closest siblings (post_dataforseo_content_summary_live, post_dataforseo_serp_google_ai_mode_live), so an agent must still guess which summarizer applies.

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

Usage Guidelines3/5

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

Gives one real prerequisite: a task_id must be taken from a prior POST response before this endpoint can return anything. It offers no when-to-use vs. when-not guidance and never names an alternative sibling summarizer or SERP endpoint, so routing between the many SERP tools is left to inference.

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

All AIsa SEO & AI Visibility 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