Skip to main content
Glama

Manifold MCP

by com.manifoldmcp
OverviewDiscussionsAdmin

Get keyword metrics

seo_get_keyword_metrics
Read-onlyIdempotent

Volume, difficulty, intent, CPC and 12-month trend for keywords you already have, with AI-engine prompt volume on request.

Use when: the user supplies keywords, or you need numbers for a list from elsewhere. ai_volume true when the question is how often AI engines see the keyword. Not for: discovering keywords, use seo_search_keywords (it already includes these metrics, do not call this after it). AI-engine prompts, use aeo_search_prompts. Checking rankings, use seo_get_position. Returns: List. rows[]: keyword, volume, kd, intent, cpc, competition, bid_low, bid_high (Google Ads top-of-page bid range, USD), trend[12], ai_volume, ai_trend[12]. One row per input keyword in the order given. volume/kd null = provider has no data; 0 = measured zero. With source google_ads, kd and intent are always null and keywords over 80 characters come back all null. ai_volume and ai_trend are null unless ai_volume is true. Cost: 5 + 5 per 100 keywords with source labs; 24 flat with source google_ads; ai_volume adds 4 + 4 per 100 keywords. Default 100 keywords = 10 credits. Cached 7 days. Example: {"keywords": ["crm for startups", "hubspot alternative"], "ai_volume": true}

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sourceNogoogle_ads is Keyword Planner's own volume, slower; no kd or intent.labs
dry_runNoReturn only meta with the estimate. Costs nothing.
keywordsYes
languageNoISO 639-1 language code. Default en.en
locationNoProvider location name or code. Default United States.United States
ai_volumeNoAlso return AI-engine prompt volume.
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. Changed1 schema field changed
    • changedInput schema / properties / source / description
      Previous value: -"google_ads is Keyword Planner's own volume; no kd or intent."New value: +"google_ads is Keyword Planner's own volume, slower; no kd or intent."
  2. Changed17 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 / ai_trend / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "month": {
-          "description": "YYYY-MM",
-          "type": "string"
-        },
-        "volume": {
-          "anyOf": [
-            {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "month",
-        "volume"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "month": {
+          "description": "YYYY-MM",
+          "type": "string"
+        },
+        "volume": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "month",
+        "volume"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / rows / items / properties / ai_volume / anyOf
      Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / rows / items / properties / trend / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "month": {
-          "description": "YYYY-MM",
-          "type": "string"
-        },
-        "volume": {
-          "anyOf": [
-            {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "month",
-        "volume"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "month": {
+          "description": "YYYY-MM",
+          "type": "string"
+        },
+        "volume": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "month",
+        "volume"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / rows / items / properties / volume / anyOf
      Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]
  3. 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"
+]
  4. Changed3 schema fields changed
    • addedOutput schema / properties / rows / items / properties / bid_high
      Added value: +{
+  "description": "USD, the high end of Google Ads' top-of-page bid.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedOutput schema / properties / rows / items / properties / bid_low
      Added value: +{
+  "description": "USD, the low end of Google Ads' top-of-page bid.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • changedOutput schema / properties / rows / items / required
      Previous value: -[
-  "keyword",
-  "volume",
-  "kd",
-  "intent",
-  "cpc",
-  "competition",
-  "trend",
-  "ai_volume",
-  "ai_trend"
-]New value: +[
+  "keyword",
+  "volume",
+  "kd",
+  "intent",
+  "cpc",
+  "competition",
+  "bid_low",
+  "bid_high",
+  "trend",
+  "ai_volume",
+  "ai_trend"
+]
  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": {
-      "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"
+  }
+]
  6. 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"
+  }
+]
  7. 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"
+}
  8. First observed

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive, and the description adds substantially more: credit cost formula per source and per ai_volume, 7-day caching, the null-vs-zero distinction for volume/kd, and source-specific quirks (google_ads forces kd/intent null and nulls out keywords over 80 characters). This is exactly the kind of context annotations cannot convey.

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

Conciseness5/5

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

Front-loaded purpose followed by clearly labeled sections (Use when / Not for / Returns / Cost / Example). Dense but every sentence carries actionable information; nothing is filler.

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 tool with a schema, output schema, and annotations, the description covers purpose, routing, return semantics, null edge cases, cost, and an example. An agent has everything needed to select and invoke 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 86%, so the schema does most of the work. The description still adds semantic value by explaining when ai_volume should be true and by tying source and ai_volume to their cost impact, going modestly beyond the enum and field descriptions.

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?

Opens with a specific verb+resource and enumerates exactly what is returned (volume, difficulty, intent, CPC, 12-month trend, optional AI-engine volume). It explicitly names the siblings it is not (seo_search_keywords, aeo_search_prompts, seo_get_position), so an agent can distinguish it without opening any schema.

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

Usage Guidelines5/5

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

Has a dedicated 'Use when' line (user supplies keywords, or you need numbers for a list) and a 'Not for' line that routes to the correct alternative for each case, including the important warning not to call this after seo_search_keywords since that already returns these metrics. When/when-not/alternatives are all present.

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