Skip to main content
Glama

Manifold MCP

by com.manifoldmcp
OverviewDiscussionsAdmin

Search an ad library

ads_search_ads
Read-onlyIdempotent

Ads running on a platform's public library, by keyword or brand.

Use when: "what ads is this category running", finding the angles and offers competitors are paying for. Not for: one advertiser's whole set, use ads_get_advertiser_ads. Google, whose library is keyed by advertiser: use ads_search_advertisers first. Organic posts, use the platform's own search tool. Returns: List. rows[]: one ad each: advertiser, headline, body, format, first_shown, last_shown, active, versions (near-identical copies Meta groups, a sign the advertiser scaled it), impressions, spend, countries, placements, targeting[], cta, destination_url, media_url. Impressions and spend are the ranges the library publishes, so they are text. Cost: 1 credit per page. Cached 24 hours. Example: {"platform": "facebook", "query": "creatine gummies", "active_only": true}

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
queryYesA keyword, a product or a brand name.
cursorNoFrom meta.cursor of the previous page.
countryNoTwo-letter country code. Default every country the library holds.
dry_runNoReturn only meta with the estimate. Costs nothing.
platformYesWhich library to search. Google is keyed by advertiser: use ads_search_advertisers.
active_onlyNoOnly ads the library still marks as running.
max_creditsNoRefuse with BudgetExceeded if the estimate is higher.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
metaYes
rowsNo
errorNo
hintsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changed
    • 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 / rows / items / properties / advertiser_followers / anyOf
      Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / rows / items / properties / versions / anyOf
      Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
  2. Changed3 schema fields changed
    • 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"
+]
  3. Changed8 schema fields changed
    • addedOutput schema / properties / rows / items / properties / advertiser_followers
      Added value: +{
+  "anyOf": [
+    {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Likes on the advertiser's Facebook page. null elsewhere."
+}
    • addedOutput schema / properties / rows / items / properties / categories
      Added value: +{
+  "description": "The advertiser's business or industry as the library labels it. Empty when not said.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
    • changedOutput schema / properties / rows / items / properties / countries / description
      Previous value: -"Empty when the platform does not say."New value: +"Two-letter codes, most impressions first where the library ranks them. Empty when the platform does not say."
    • addedOutput schema / properties / rows / items / properties / description
      Added value: +{
+  "description": "The line under the headline, where the format has one.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / rows / items / properties / objective
      Added value: +{
+  "description": "The campaign goal the advertiser chose, on TikTok.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / rows / items / properties / targeting
      Added value: +{
+  "description": "Who the ad was aimed at. Empty when the library does not say.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "excluded": {
+        "description": "True when the ad is kept away from this rather than shown to it.",
+        "type": "boolean"
+      },
+      "type": {
+        "description": "location, language, age, gender, audience, company and other library words.",
+        "type": "string"
+      },
+      "value": {
+        "description": "What is targeted, as the library words it.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "value",
+      "excluded"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}
    • addedOutput schema / properties / rows / items / properties / versions
      Added value: +{
+  "anyOf": [
+    {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "How many near-identical copies Meta groups under this ad. A high count means a creative the advertiser scaled."
+}
    • changedOutput schema / properties / rows / items / required
      Previous value: -[
-  "platform",
-  "id",
-  "url",
-  "advertiser",
-  "advertiser_id",
-  "headline",
-  "body",
-  "format",
-  "first_shown",
-  "last_shown",
-  "active",
-  "impressions",
-  "spend",
-  "countries",
-  "placements",
-  "cta",
-  "destination_url",
-  "media_url"
-]New value: +[
+  "platform",
+  "id",
+  "url",
+  "advertiser",
+  "advertiser_id",
+  "advertiser_followers",
+  "categories",
+  "headline",
+  "body",
+  "description",
+  "format",
+  "first_shown",
+  "last_shown",
+  "active",
+  "versions",
+  "impressions",
+  "spend",
+  "countries",
+  "placements",
+  "objective",
+  "targeting",
+  "cta",
+  "destination_url",
+  "media_url"
+]
  4. Changed2 schema fields changed
    • 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"
+  }
+]
  5. Changed2 schema fields changed
    • 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"
+  }
+]
  6. Changed1 schema field changed
    • addedOutput schema / properties / meta / properties / providers_tried
      Added value: +{
+  "description": "leads_get_email only: every source asked, in order.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
  7. First observed

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, non-destructive, idempotent, openWorld), and the description goes further with credit cost per page, 24-hour caching, and the caveat that impressions/spend are published text ranges rather than numbers. The Returns enumeration largely restates what the output schema already carries, which slightly dilutes the added value.

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 with labeled sections (Use when / Not for / Returns / Cost / Example) and no wasted prose. The Returns block enumerates fields already present in the output schema, so it is slightly longer than 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 7-parameter, open-world search tool with an output schema, the description covers routing, cost, caching, and data-format quirks, leaving no gap an agent needs to call it correctly.

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 description coverage is 100%, so the baseline is 3. The description adds a concrete usage example and reinforces what 'query' accepts (keyword, product or brand), giving marginal but real semantic help beyond the schema.

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 ('Ads running on a platform's public library, by keyword or brand') and immediately distinguishes itself from ads_get_advertiser_ads and ads_search_advertisers. An agent can tell exactly what this returns versus its siblings.

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' scenarios ('what ads is this category running', competitor angles/offers) and 'Not for' exclusions naming the correct alternatives, including the Google-specific routing via ads_search_advertisers and organic posts via the platform's own search. Nothing is left to inference.

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

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources