DrissionPage MCP Server

Overview Schema Source Related Servers Discussions Admin

Wait Until

wait_until

Read-onlyIdempotent

Pause until the page reaches a specific state—element present, visible, clickable, or text/URL content matches—before continuing automation.

Instructions

Wait for observable page state: element present/visible/hidden/detached/clickable/stable, text contains/matches, or URL contains/matches.

Input Schema

TableJSON Schema

Name	Required	Description
`name`	No	Attribute or property name for attribute/property conditions
`value`	No	Expected value or substring/regular expression, depending on condition
`tab_id`	No	Optional MCP or native DrissionPage tab id. When omitted, the current tab is captured at call start.
`timeout`	No	Timeout in seconds
`interval`	No	Polling interval in seconds
`selector`	No	CSS/XPath/DrissionPage locator for element or text conditions
`condition`	Yes	Condition to wait for
`stable_ms`	No	Element stability window for the stable condition

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedv0.8.8Sep 13, 2026

addedInput schema / properties / tab_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 128,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional MCP or native DrissionPage tab id. When omitted, the current tab is captured at call start.",
+  "title": "Tab Id"
+}

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "condition": {
-            "title": "Condition",
-            "type": "string"
-          },
-          "elapsed_ms": {
-            "title": "Elapsed Ms",
-            "type": "integer"
-          },
-          "matched": {
-            "const": true,
-            "title": "Matched",
-            "type": "boolean"
-          },
-          "name": {
-            "title": "Name",
-            "type": "string"
-          },
-          "selector": {
-            "title": "Selector",
-            "type": "string"
-          },
-          "state": {
-            "additionalProperties": true,
-            "title": "State",
-            "type": "object"
-          },
-          "timeout": {
-            "title": "Timeout",
-            "type": "number"
-          },
-          "value": {
-            "title": "Value",
-            "type": "string"
-          }
-        },
-        "required": [
-          "condition",
-          "selector",
-          "value",
-          "name",
-          "matched",
-          "timeout",
-          "elapsed_ms",
-          "state"
-        ],
-        "title": "WaitUntilData",
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": true
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": true,
-        "type": "object"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "details": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "message": {
-        "type": "string"
-      },
-      "ok": {
-        "const": false
-      }
-    },
-    "required": [
-      "ok",
-      "message",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "condition": {
+            "title": "Condition",
+            "type": "string"
+          },
+          "elapsed_ms": {
+            "title": "Elapsed Ms",
+            "type": "integer"
+          },
+          "matched": {
+            "const": true,
+            "title": "Matched",
+            "type": "boolean"
+          },
+          "name": {
+            "title": "Name",
+            "type": "string"
+          },
+          "selector": {
+            "title": "Selector",
+            "type": "string"
+          },
+          "state": {
+            "additionalProperties": true,
+            "title": "State",
+            "type": "object"
+          },
+          "tab_id": {
+            "description": "MCP tab id captured for this operation.",
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "timeout": {
+            "title": "Timeout",
+            "type": "number"
+          },
+          "value": {
+            "title": "Value",
+            "type": "string"
+          }
+        },
+        "required": [
+          "condition",
+          "selector",
+          "value",
+          "name",
+          "matched",
+          "timeout",
+          "elapsed_ms",
+          "state",
+          "tab_id"
+        ],
+        "title": "WaitUntilData",
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": true
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "details": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "message": {
+        "type": "string"
+      },
+      "ok": {
+        "const": false
+      }
+    },
+    "required": [
+      "ok",
+      "message",
+      "error"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedv0.8.0Aug 3, 2026

addedInput schema / $defs

Added value: +{
+  "AccessibilityTargetInput": {
+    "additionalProperties": false,
+    "description": "A unique accessibility role/name target within an optional DOM scope.",
+    "properties": {
+      "exact": {
+        "default": true,
+        "title": "Exact",
+        "type": "boolean"
+      },
+      "frame_selectors": {
+        "description": "Ordered outer-to-inner frame selectors resolved by DrissionPage.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 4,
+        "title": "Frame Selectors",
+        "type": "array"
+      },
+      "kind": {
+        "const": "accessibility",
+        "title": "Kind",
+        "type": "string"
+      },
+      "name": {
+        "anyOf": [
+          {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Name"
+      },
+      "role": {
+        "maxLength": 500,
+        "minLength": 1,
+        "title": "Role",
+        "type": "string"
+      },
+      "shadow_hosts": {
+        "description": "Ordered outer-to-inner shadow host selectors resolved by DrissionPage.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "title": "Shadow Hosts",
+        "type": "array"
+      }
+    },
+    "required": [
+      "kind",
+      "role"
+    ],
+    "title": "AccessibilityTargetInput",
+    "type": "object"
+  },
+  "SelectorTargetInput": {
+    "additionalProperties": false,
+    "description": "A selector target with optional frame and shadow-root scope.",
+    "properties": {
+      "frame_selectors": {
+        "description": "Ordered outer-to-inner frame selectors resolved by DrissionPage.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 4,
+        "title": "Frame Selectors",
+        "type": "array"
+      },
+      "kind": {
+        "const": "selector",
+        "title": "Kind",
+        "type": "string"
+      },
+      "selector": {
+        "maxLength": 500,
+        "minLength": 1,
+        "title": "Selector",
+        "type": "string"
+      },
+      "shadow_hosts": {
+        "description": "Ordered outer-to-inner shadow host selectors resolved by DrissionPage.",
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "title": "Shadow Hosts",
+        "type": "array"
+      }
+    },
+    "required": [
+      "kind",
+      "selector"
+    ],
+    "title": "SelectorTargetInput",
+    "type": "object"
+  }
+}

addedInput schema / properties / selector / anyOf

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "maxLength": 500,
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "discriminator": {
+      "mapping": {
+        "accessibility": "#/$defs/AccessibilityTargetInput",
+        "selector": "#/$defs/SelectorTargetInput"
+      },
+      "propertyName": "kind"
+    },
+    "oneOf": [
+      {
+        "$ref": "#/$defs/SelectorTargetInput"
+      },
+      {
+        "$ref": "#/$defs/AccessibilityTargetInput"
+      }
+    ]
+  }
+]

removedInput schema / properties / selector / type
```
Removed value: -"string"
```

Addedv0.7.2Jul 22, 2026
Removedv0.7.2Jul 22, 2026
Addedv0.5.1Jul 6, 2026

TDQS

B3.2/5.0

Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, non-destructive, and open-world, so the safety and idempotency profile is covered. The description adds the set of observable states but does not disclose key behavioral traits such as what happens on timeout (error vs. false), or how polling/interval interacts with the wait, leaving a gap for a timing-sensitive tool.

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?

A single front-loaded sentence that enumerates the condition categories without waste. It is tight, though the enumeration is incomplete relative to the schema's enum, slightly reducing its utility.

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

Completeness3/5

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

An output schema exists so return values need not be explained, and annotations cover the safety profile. However, for a tool that overlaps three sibling wait tools, the description omits the routing guidance and failure semantics needed to call it confidently, leaving it only adequate.

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

Parameters3/5

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

Schema description coverage is 100% and the parameters (timeout, interval, stable_ms, selector, condition) carry their own descriptions, so the schema does the heavy lifting. The description adds no semantics beyond the schema and notably omits the attribute_equals/attribute_nonempty/property_equals/property_nonempty conditions present in the enum, so a baseline 3 is appropriate.

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

Purpose4/5

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

States a specific verb ('wait') and resource (observable page state) and enumerates the observable condition categories, so an agent can tell it is a generalized state-wait. It does not explicitly differentiate from siblings wait_for_element, wait_for_url, and wait_time, whose functionality it partially overlaps, which keeps it below a 5.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus wait_for_element, wait_for_url, or wait_time, even though those siblings cover subsets of the same behavior. The agent must infer that this is the general-purpose wait from the condition list alone, and no exclusions or prerequisites are given.

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

Deploy Server