Manifold MCP

Get a SERP

seo_get_serp

Read-onlyIdempotent

The top organic results and SERP features Google shows for one query.

Use when: "what ranks for X", "who is on page one for X", "is there a featured snippet or AI overview for X". Not for: where one site ranks for a keyword, use seo_get_position (it scans the top 100 for you). Keyword ideas, use seo_search_keywords. The businesses Google Maps ranks for a local search, use maps_search_places. Returns: Record. features[] (featured_snippet, people_also_ask, video, ai_overview and others), results[] (rank, organic_rank, type, url, domain, title, snippet, published_at, rating), related_searches[], ai_overview (text, references[]) or null, results_count, check_url. depth counts organic rows: the default returns 10 organic results whenever Google has them, with the features ranked among them on top. Each People Also Ask question and each forum thread is its own row at its block's rank; for a question, title is the question and snippet the answer, url null when Google's answer is an AI overview. domain is null on a row whose url is still a google.com/goto redirect. location localises the local pack, not the organic rows of a bare service search: put the town in the keyword ("dentist columbus ohio") for local organic results. Paid ads seldom come back, so the page says nothing about who bids on the query; a named rival's search ads are in ads_get_advertiser_ads with platform google. Cost: 1 credit per 10 results, +1 with ai_overview. Default top 10 = 1 credit. Cached 24 hours. Example: {"keyword": "hubspot alternative", "depth": 10, "ai_overview": true}

Input Schema

Name	Required	Description	Default
`depth`	No	How many results to fetch. Default 10, max 100.
`device`	No		desktop
`dry_run`	No	Return only meta with the estimate. Costs nothing.
`keyword`	Yes
`language`	No	ISO 639-1 language code. Default en.	en
`location`	No	Provider location name or code. Default United States.	United States
`ai_overview`	No	Also return Google's AI overview and its cited sources. +1 credit.
`max_credits`	No	Refuse with BudgetExceeded if the estimate is higher.

Output Schema

Name	Required	Description
`meta`	Yes
`error`	No
`hints`	Yes
`device`	No
`keyword`	No
`results`	No
`features`	No	SERP feature types present.
`language`	No
`location`	No
`check_url`	No
`ai_overview`	No
`results_count`	No	Google's total results estimate.
`related_searches`	No	Google's related searches, in page order.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 7, 2026

changedOutput schema / properties / meta / properties / credits_remaining / description

Previous value: -"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."New value: +"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. Leaves out credits held for calls still running, so it can dip during parallel calls and come back; credits_charged is what this call cost."

Changed1 schema field changedNov 1, 2026

addedOutput schema / properties / meta / properties / feedback_request

Added value: +{
+  "additionalProperties": false,
+  "description": "Once per workspace: after the task, ask the user once for feedback and send any answer with submit_feedback.",
+  "properties": {
+    "message": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "message"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 23, 2026

changedOutput schema / properties / meta / properties / credits_notice / description

Previous value: -"A free workspace is low on credits, at most once a day. Tell the user once."New value: +"The workspace is low on credits, at most once a day. Tell the user once."

Changed16 schema fields changedOct 17, 2026

removedInput schema / $schema

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

removedInput schema / properties / max_credits / maximum
```
Removed value: -9007199254740991
```

removedInput schema / properties / provider

Removed value: -{
-  "description": "Provider id. Defaults to the server default for the tool.",
-  "type": "string"
-}

removedOutput schema / $schema

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

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 / 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 / results / items / properties / organic_rank / anyOf

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

removedOutput schema / properties / results / items / properties / rank / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / results / items / properties / rank / minimum
```
Removed value: --9007199254740991
```

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"
+]

Changed6 schema fields changedOct 13, 2026

addedOutput schema / properties / related_searches

Added value: +{
+  "description": "Google's related searches, in page order.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / results / items / properties / published_at

Added value: +{
+  "description": "The date Google shows on the result.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / results / items / properties / rating

Added value: +{
+  "description": "Review stars Google shows on the result, out of 5.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / results / items / properties / snippet / description
```
Added value: +"The text Google shows; for a people_also_ask row, the answer."
```
addedOutput schema / properties / results / items / properties / title / description
```
Added value: +"The page title; for a people_also_ask row, the question."
```

changedOutput schema / properties / results / items / required

Previous value: -[
-  "rank",
-  "organic_rank",
-  "type",
-  "url",
-  "domain",
-  "title",
-  "snippet"
-]New value: +[
+  "rank",
+  "organic_rank",
+  "type",
+  "url",
+  "domain",
+  "title",
+  "snippet",
+  "published_at",
+  "rating"
+]

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.8/5.0

Behavior5/5

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

Annotations only declare the safety profile (readOnly, openWorld, idempotent, non-destructive); the description adds far more: a cost model (1 credit per 10 results, +1 with ai_overview), a 24-hour cache, and the caveat that paid ads rarely return so the page says nothing about bidders. It also discloses non-obvious row semantics (People Also Ask and forum threads occupy their own rows; domain is null on goto-redirect rows) and the important caveat that location localises the local pack, not bare-service organic results.

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, then Use when / Not for, then Returns, then Cost and an example — a predictable order an agent can scan. The dense return-semantics prose is long but each clause carries real information; the only mild redundancy is restating field lists that the output schema likely already enumerates.

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 an 8-parameter, open-world, credit-consuming tool this is more than sufficient: cost guardrails, cache behaviour, the credit-budgeting role of max_credits via its own schema description, null-handling rules for results, and clear routing to sibling tools. Nothing needed to invoke it correctly is missing, and the return discussion serves as an aid rather than a substitute for the output schema.

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

Parameters4/5

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

Schema coverage is 75%, so the schema carries much of the load, but the description adds genuinely non-obvious meaning for the two riskiest parameters: depth counts organic rows and the default 10 returns 10 organic results with features interleaved, and location does not localise organic rows unless the town is placed in the keyword. The worked example anchors depth and ai_overview. Device, language and max_credits are left entirely to the schema, which keeps this short of a 5.

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?

States a specific verb and resource — 'the top organic results and SERP features Google shows for one query' — and immediately frames the scope in terms an agent can match to a request ('what ranks for X'). Explicitly contrasts itself with seo_get_position, seo_search_keywords and maps_search_places, so it is distinguishable from siblings without opening their schemas.

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?

Contains an explicit 'Use when' block with three concrete query phrasings and a 'Not for' block naming three sibling alternatives plus the condition that selects each (per-site ranking, keyword ideas, local pack businesses). This is exactly the when/when-not/alternatives structure that earns top marks.

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?