Manifold MCP

Get AI readiness of a site

aeo_get_site_readiness

Read-onlyIdempotent

Whether a site is set up for AI answer engines, from about seventeen live fetches of its origin, free. Checks what the engines document as gating their answers: robots.txt access for every known AI crawler (search, user fetch, training), CDN or WAF rules that turn away the answer crawlers' user agents before robots.txt is read, content present in the raw HTML without JavaScript on the homepage and on one page sampled from the sitemap, noindex and snippet directives, then freshness signals, redirect chains, sitemap, title and description, structured data, and llms.txt.

Use when: "is our site ready for AI search", "do we block GPTBot", "are we blocking ChatGPT at Cloudflare", "do we have an llms.txt", before an AI visibility push. Not for: what the engines answer, use aeo_run_ai_answers. A full technical audit, use seo_run_technical_crawl. One page's on-page tags, use seo_get_page. Returns: Record. checks[] (check, ok, tier, detail, source), failing checks first. tier says how much a check is worth: blocks_citations is documented by an engine, evidence_backed is measured, hygiene is standard practice, policy is a legitimate choice that never fails, unproven is reported but never fails on absence (llms.txt, schema presence). Plus the findings behind them: robots_txt (ai_bots[], sitemaps, content_signal), edge (probes[] per answer crawler user agent), homepage and sample_page (status, word_count and js_shell from the raw HTML, canonical, robots and schema tags, dates; sample_page is the first content URL in the sitemap, null when there is none), markdown (whether the origin answers Accept: text/markdown, which passes the JavaScript check), redirects[], sitemap, llms_txt and llms_full_txt. No crawl, no LLM call. Cost: 0 credits, rate limited. Cached 1 hour. Example: {"target": "example.com"}

Input Schema

TableJSON Schema

Name	Required	Description	Default
`target`	Yes	A domain or URL. Every fetch goes to its origin.

Output Schema

TableJSON Schema

Name	Required	Description
`edge`	No
`meta`	Yes
`error`	No
`hints`	Yes
`checks`	No	Readiness checks, failing ones first.
`origin`	No	The origin the fetches were made against.
`target`	No
`sitemap`	No
`homepage`	No
`llms_txt`	No
`markdown`	No	The homepage fetched a second time with Accept: text/markdown.
`redirects`	No	Redirect chains from the http and the www or bare variants of the origin.
`robots_txt`	No
`sample_page`	No	The first content URL in the sitemap, fetched so rendering and freshness are not judged on the homepage alone. Null when the sitemap names no other page.
`llms_full_txt`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 17, 2026

changedInput schema / properties / target / description

Previous value: -"Domain or URL. example.com covers all subdomains, www.example.com is that host only, a full URL is that page only."New value: +"A domain or URL. Every fetch goes to its origin."

Changed31 schema fields changedOct 17, 2026

removedInput schema / $schema

Removed value: -"https://json-schema.org/draft/2020-12/schema"

removedInput schema / properties / dry_run

Removed value: -{
-  "default": false,
-  "description": "Return only meta with the estimate. Costs nothing.",
-  "type": "boolean"
-}

removedInput schema / properties / max_credits

Removed value: -{
-  "description": "Refuse with BudgetExceeded if the estimate is higher.",
-  "maximum": 9007199254740991,
-  "minimum": 0,
-  "type": "integer"
-}

removedOutput schema / $schema

Removed value: -"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / properties / edge / properties / browser_status / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / edge / properties / probes / items / properties / status / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / error / additionalProperties
```
Added value: +{}
```

removedOutput schema / properties / error / oneOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "BudgetExceeded",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "max_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "max_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "billing_url": {
-        "type": "string"
-      },
-      "error": {
-        "const": "InsufficientCredits",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "upgrade_url": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "NoData",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidTarget",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "target": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "target",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidProvider",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "valid_providers": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "valid_providers",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ProviderUnavailable",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ConcurrencyLimit",
-        "type": "string"
-      },
-      "limit": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "limit",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "error": {
-        "const": "SpendCapReached",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "period": {
-        "enum": [
-          "day",
-          "month"
-        ],
-        "type": "string"
-      },
-      "resets_at": {
-        "type": "string"
-      },
-      "spent": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "period",
-      "cap",
-      "spent",
-      "est_credits",
-      "resets_at",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskFailed",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskPending",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll_after_s": {
-        "type": "number"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "poll_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "connect_url": {
-        "type": "string"
-      },
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "NotConnected",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "connect_url",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "EngineMisconfigured",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "message"
-    ],
-    "type": "object"
-  }
-]

addedOutput schema / properties / error / properties

Added value: +{
+  "error": {
+    "enum": [
+      "BudgetExceeded",
+      "InsufficientCredits",
+      "NoData",
+      "InvalidTarget",
+      "InvalidProvider",
+      "ProviderUnavailable",
+      "ConcurrencyLimit",
+      "SpendCapReached",
+      "TaskFailed",
+      "TaskPending",
+      "NotConnected",
+      "EngineMisconfigured"
+    ],
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  }
+}

addedOutput schema / properties / error / required
```
Added value: +[
+  "error",
+  "message"
+]
```
addedOutput schema / properties / error / type
```
Added value: +"object"
```

removedOutput schema / properties / errors

Removed value: -{
-  "description": "Per-input failures of a batch call.",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "BudgetExceeded",
-                "type": "string"
-              },
-              "est_credits": {
-                "type": "number"
-              },
-              "max_credits": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "est_credits",
-              "max_credits",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "billing_url": {
-                "type": "string"
-              },
-              "error": {
-                "const": "InsufficientCredits",
-                "type": "string"
-              },
-              "est_credits": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              },
-              "upgrade_url": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "est_credits",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "NoData",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "InvalidTarget",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "target": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "target",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "InvalidProvider",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "provider": {
-                "type": "string"
-              },
-              "valid_providers": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "error",
-              "provider",
-              "valid_providers",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "ProviderUnavailable",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "provider": {
-                "type": "string"
-              },
-              "retry_after_s": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "error",
-              "provider",
-              "retry_after_s",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "ConcurrencyLimit",
-                "type": "string"
-              },
-              "limit": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              },
-              "retry_after_s": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "error",
-              "limit",
-              "retry_after_s",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "cap": {
-                "type": "number"
-              },
-              "error": {
-                "const": "SpendCapReached",
-                "type": "string"
-              },
-              "est_credits": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              },
-              "period": {
-                "enum": [
-                  "day",
-                  "month"
-                ],
-                "type": "string"
-              },
-              "resets_at": {
-                "type": "string"
-              },
-              "spent": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "error",
-              "period",
-              "cap",
-              "spent",
-              "est_credits",
-              "resets_at",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "TaskFailed",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "task_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "task_id",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "TaskPending",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "poll_after_s": {
-                "type": "number"
-              },
-              "task_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "task_id",
-              "poll_after_s",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "connect_url": {
-                "type": "string"
-              },
-              "engine": {
-                "type": "string"
-              },
-              "error": {
-                "const": "NotConnected",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "engine",
-              "connect_url",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "engine": {
-                "type": "string"
-              },
-              "error": {
-                "const": "EngineMisconfigured",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "engine",
-              "message"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "input": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "input",
-      "error"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

changedOutput schema / properties / homepage / properties / headings / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / homepage / properties / html_bytes / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / homepage / properties / paragraphs / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / homepage / properties / response_ms / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / homepage / properties / schema_errors / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / homepage / properties / status / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / homepage / properties / word_count / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / llms_txt / properties / bytes / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / llms_txt / properties / links / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / markdown / properties / word_count / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / meta / properties / rows_available / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / meta / properties / rows_returned / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / meta / properties / rows_returned / minimum
```
Removed value: --9007199254740991
```

changedOutput schema / properties / redirects / items / properties / final_status / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / redirects / items / properties / hops / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / redirects / items / properties / hops / minimum
```
Removed value: --9007199254740991
```

changedOutput schema / properties / sample_page / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "date_modified": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "final_url": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "headings": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "js_shell": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "last_modified_header": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "paragraphs": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "status": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "url": {
-        "type": "string"
-      },
-      "word_count": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "url",
-      "status",
-      "final_url",
-      "word_count",
-      "paragraphs",
-      "headings",
-      "js_shell",
-      "date_modified",
-      "last_modified_header"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "date_modified": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "final_url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "headings": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "js_shell": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "last_modified_header": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "paragraphs": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "status": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "url": {
+        "type": "string"
+      },
+      "word_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "url",
+      "status",
+      "final_url",
+      "word_count",
+      "paragraphs",
+      "headings",
+      "js_shell",
+      "date_modified",
+      "last_modified_header"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / sitemap / properties / entries / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / sitemap / properties / with_lastmod / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

Changed3 schema fields changedOct 17, 2026

addedOutput schema / properties / meta / properties / credits_notice

Added value: +{
+  "additionalProperties": false,
+  "description": "A free workspace is low on credits, at most once a day. Tell the user once.",
+  "properties": {
+    "message": {
+      "type": "string"
+    },
+    "resets_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "upgrade_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "upgrade_url",
+    "resets_at",
+    "message"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / meta / properties / credits_remaining

Added value: +{
+  "description": "The workspace's credits left after this call. null when the call did not check the balance (free tools, cache hits, dry runs, tasks) or the balance has no limit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changedOutput schema / properties / meta / required

Previous value: -[
-  "provider",
-  "credits_charged",
-  "est_credits",
-  "cached",
-  "data_as_of",
-  "rows_returned",
-  "rows_available",
-  "cursor",
-  "request_id"
-]New value: +[
+  "provider",
+  "credits_charged",
+  "est_credits",
+  "cached",
+  "data_as_of",
+  "rows_returned",
+  "rows_available",
+  "cursor",
+  "request_id",
+  "credits_remaining"
+]

Changed2 schema fields changedOct 8, 2026

changedOutput schema / properties / error / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "BudgetExceeded",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "max_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "max_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "billing_url": {
-        "type": "string"
-      },
-      "error": {
-        "const": "InsufficientCredits",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "upgrade_url": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "NoData",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidTarget",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "target": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "target",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ProviderUnavailable",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ConcurrencyLimit",
-        "type": "string"
-      },
-      "limit": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "limit",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "error": {
-        "const": "SpendCapReached",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "period": {
-        "enum": [
-          "day",
-          "month"
-        ],
-        "type": "string"
-      },
-      "resets_at": {
-        "type": "string"
-      },
-      "spent": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "period",
-      "cap",
-      "spent",
-      "est_credits",
-      "resets_at",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskFailed",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskPending",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll_after_s": {
-        "type": "number"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "poll_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "connect_url": {
-        "type": "string"
-      },
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "NotConnected",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "connect_url",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "EngineMisconfigured",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "message"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "BudgetExceeded",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "max_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "max_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "billing_url": {
+        "type": "string"
+      },
+      "error": {
+        "const": "InsufficientCredits",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "upgrade_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "NoData",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "InvalidTarget",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "target": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "target",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "InvalidProvider",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "valid_providers": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "error",
+      "provider",
+      "valid_providers",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ProviderUnavailable",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "provider",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ConcurrencyLimit",
+        "type": "string"
+      },
+      "limit": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "limit",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cap": {
+        "type": "number"
+      },
+      "error": {
+        "const": "SpendCapReached",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "period": {
+        "enum": [
+          "day",
+          "month"
+        ],
+        "type": "string"
+      },
+      "resets_at": {
+        "type": "string"
+      },
+      "spent": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "period",
+      "cap",
+      "spent",
+      "est_credits",
+      "resets_at",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskFailed",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskPending",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll_after_s": {
+        "type": "number"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "poll_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "connect_url": {
+        "type": "string"
+      },
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "NotConnected",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "connect_url",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "EngineMisconfigured",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "message"
+    ],
+    "type": "object"
+  }
+]

changedOutput schema / properties / errors / items / properties / error / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "BudgetExceeded",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "max_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "max_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "billing_url": {
-        "type": "string"
-      },
-      "error": {
-        "const": "InsufficientCredits",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "upgrade_url": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "NoData",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidTarget",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "target": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "target",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ProviderUnavailable",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ConcurrencyLimit",
-        "type": "string"
-      },
-      "limit": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "limit",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "error": {
-        "const": "SpendCapReached",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "period": {
-        "enum": [
-          "day",
-          "month"
-        ],
-        "type": "string"
-      },
-      "resets_at": {
-        "type": "string"
-      },
-      "spent": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "period",
-      "cap",
-      "spent",
-      "est_credits",
-      "resets_at",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskFailed",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskPending",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll_after_s": {
-        "type": "number"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "poll_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "connect_url": {
-        "type": "string"
-      },
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "NotConnected",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "connect_url",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "EngineMisconfigured",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "message"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "BudgetExceeded",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "max_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "max_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "billing_url": {
+        "type": "string"
+      },
+      "error": {
+        "const": "InsufficientCredits",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "upgrade_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "NoData",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "InvalidTarget",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "target": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "target",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "InvalidProvider",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "valid_providers": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "error",
+      "provider",
+      "valid_providers",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ProviderUnavailable",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "provider",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ConcurrencyLimit",
+        "type": "string"
+      },
+      "limit": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "limit",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cap": {
+        "type": "number"
+      },
+      "error": {
+        "const": "SpendCapReached",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "period": {
+        "enum": [
+          "day",
+          "month"
+        ],
+        "type": "string"
+      },
+      "resets_at": {
+        "type": "string"
+      },
+      "spent": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "period",
+      "cap",
+      "spent",
+      "est_credits",
+      "resets_at",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskFailed",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskPending",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll_after_s": {
+        "type": "number"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "poll_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "connect_url": {
+        "type": "string"
+      },
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "NotConnected",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "connect_url",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "EngineMisconfigured",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "message"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedOct 6, 2026

changedOutput schema / properties / error / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "BudgetExceeded",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "max_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "max_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InsufficientCredits",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "NoData",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidTarget",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "target": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "target",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ProviderUnavailable",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ConcurrencyLimit",
-        "type": "string"
-      },
-      "limit": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "limit",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "error": {
-        "const": "SpendCapReached",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "period": {
-        "enum": [
-          "day",
-          "month"
-        ],
-        "type": "string"
-      },
-      "resets_at": {
-        "type": "string"
-      },
-      "spent": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "period",
-      "cap",
-      "spent",
-      "est_credits",
-      "resets_at",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskFailed",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskPending",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll_after_s": {
-        "type": "number"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "poll_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "connect_url": {
-        "type": "string"
-      },
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "NotConnected",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "connect_url",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "EngineMisconfigured",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "message"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "BudgetExceeded",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "max_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "max_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "billing_url": {
+        "type": "string"
+      },
+      "error": {
+        "const": "InsufficientCredits",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "upgrade_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "NoData",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "InvalidTarget",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "target": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "target",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ProviderUnavailable",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "provider",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ConcurrencyLimit",
+        "type": "string"
+      },
+      "limit": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "limit",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cap": {
+        "type": "number"
+      },
+      "error": {
+        "const": "SpendCapReached",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "period": {
+        "enum": [
+          "day",
+          "month"
+        ],
+        "type": "string"
+      },
+      "resets_at": {
+        "type": "string"
+      },
+      "spent": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "period",
+      "cap",
+      "spent",
+      "est_credits",
+      "resets_at",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskFailed",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskPending",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll_after_s": {
+        "type": "number"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "poll_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "connect_url": {
+        "type": "string"
+      },
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "NotConnected",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "connect_url",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "EngineMisconfigured",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "message"
+    ],
+    "type": "object"
+  }
+]

changedOutput schema / properties / errors / items / properties / error / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "BudgetExceeded",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "max_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "max_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InsufficientCredits",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "NoData",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidTarget",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "target": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "target",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ProviderUnavailable",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ConcurrencyLimit",
-        "type": "string"
-      },
-      "limit": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "limit",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "error": {
-        "const": "SpendCapReached",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "period": {
-        "enum": [
-          "day",
-          "month"
-        ],
-        "type": "string"
-      },
-      "resets_at": {
-        "type": "string"
-      },
-      "spent": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "period",
-      "cap",
-      "spent",
-      "est_credits",
-      "resets_at",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskFailed",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskPending",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll_after_s": {
-        "type": "number"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "poll_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "connect_url": {
-        "type": "string"
-      },
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "NotConnected",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "connect_url",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "EngineMisconfigured",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "message"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "BudgetExceeded",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "max_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "max_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "billing_url": {
+        "type": "string"
+      },
+      "error": {
+        "const": "InsufficientCredits",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "upgrade_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "est_credits",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "NoData",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "InvalidTarget",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "target": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "target",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ProviderUnavailable",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "provider",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "ConcurrencyLimit",
+        "type": "string"
+      },
+      "limit": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "retry_after_s": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "limit",
+      "retry_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cap": {
+        "type": "number"
+      },
+      "error": {
+        "const": "SpendCapReached",
+        "type": "string"
+      },
+      "est_credits": {
+        "type": "number"
+      },
+      "message": {
+        "type": "string"
+      },
+      "period": {
+        "enum": [
+          "day",
+          "month"
+        ],
+        "type": "string"
+      },
+      "resets_at": {
+        "type": "string"
+      },
+      "spent": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "error",
+      "period",
+      "cap",
+      "spent",
+      "est_credits",
+      "resets_at",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskFailed",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "const": "TaskPending",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "poll_after_s": {
+        "type": "number"
+      },
+      "task_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "task_id",
+      "poll_after_s",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "connect_url": {
+        "type": "string"
+      },
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "NotConnected",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "connect_url",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "engine": {
+        "type": "string"
+      },
+      "error": {
+        "const": "EngineMisconfigured",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error",
+      "engine",
+      "message"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 6, 2026

addedOutput schema / properties / meta / properties / providers_tried

Added value: +{
+  "description": "leads_get_email only: every source asked, in order.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

First observedOct 2, 2026

TDQS

A4.6/5.0

Behavior5/5

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

Annotations already declare readOnly/openWorld/idempotent/non-destructive, and the description layers substantial extra context on top: cost (0 credits), rate limiting, 1-hour caching, the ~17-fetch mechanism, and explicitly 'No crawl, no LLM call'. This is well beyond what the annotations convey.

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?

Well front-loaded: purpose first, then use/not-for routing, then returns. However, the lengthy 'Returns:' block is partly redundant since an output schema exists, making the definition larger than strictly necessary.

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

Completeness5/5

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

For a complex multi-fetch tool, the description covers mechanism, cost, caching, failure semantics (tier meanings, checks that never fail on absence) and boundaries. Combined with the existing output schema, an agent has everything needed to call it correctly.

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?

Schema coverage is 100% for the single 'target' parameter, and the schema already explains 'A domain or URL. Every fetch goes to its origin.' The description's example ({"target": "example.com"}) adds only marginal clarification, so the baseline of 3 applies.

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

Purpose5/5

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

The description states a specific verb+resource ('whether a site is set up for AI answer engines') and enumerates exactly what it examines (robots.txt per AI crawler, WAF/CDN blocks, raw-HTML content, noindex, llms.txt, etc.). It clearly separates itself from siblings by naming aeo_run_ai_answers, seo_run_technical_crawl and seo_get_page. An agent can identify this tool without opening the schema.

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

Usage Guidelines5/5

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

Explicit 'Use when:' triggers are given ('do we block GPTBot', 'are we blocking ChatGPT at Cloudflare', before an AI visibility push) and an explicit 'Not for:' list routes to the correct alternatives (aeo_run_ai_answers, seo_run_technical_crawl, seo_get_page). Both when-to-use and when-not-to-use are covered.

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

All Manifold MCP tools Inspect

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

Need Help?