BrowserMesh

Overview Schema Source Related Servers Discussions Admin

Get accessibility snapshot

browser_snapshot

Read-onlyIdempotent

Capture a bounded accessibility snapshot of a page or iframe, with optional scoping, interactive-only filtering, and cursor-based continuation for large content.

Instructions

Inspect a bounded accessibility-oriented snapshot of one explicitly addressed page, optionally scoped by a locator including a bounded semantic iframe chain. BrowserMesh rejects oversized DOM sources before native ARIA serialization. Use interactiveOnly to retain interactive nodes with ancestor context and maxChildren to limit every node after filtering. A nextCursor continues the immutable captured serialization without rereading a changed DOM; cursors are page-scoped, expire after 30 seconds, and become stale on navigation or close. Semantic scope, depth, boxes, character/byte bounds, omissions, and truncation are explicit; partial content is aria-yaml-fragment. Non-empty password-input values are redacted before content crosses MCP. Optional 30-second element refs are separate short-lived action conveniences.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`scope`	No
`cursor`	No
`pageId`	Yes
`maxRefs`	No
`maxBytes`	No
`maxChars`	No
`maxDepth`	No
`sessionId`	Yes
`timeoutMs`	No
`includeRefs`	No
`maxChildren`	No
`interactiveOnly`	No
`includeBoundingBoxes`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`refs`	Yes
`pageId`	Yes
`partial`	Yes
`snapshot`	Yes
`omissions`	Yes
`sessionId`	Yes
`pagination`	Yes
`truncation`	Yes
`operationId`	Yes
`appliedBounds`	Yes
`contentFormat`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedv0.2.2Sep 8, 2026

changedOutput schema / properties / pagination / properties / expiresAt / anyOf

Previous value: -[
-  {
-    "format": "date-time",
-    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "format": "date-time",
+    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / pagination / properties / nextCursor / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / pagination / properties / nextCursor / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / pagination / properties / snapshotId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / pagination / properties / snapshotId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

Changed48 schema fields changedv0.2.1Aug 19, 2026

addedInput schema / $defs

Added value: +{
+  "shared0": {
+    "description": "Top document or a bounded outer-to-inner chain of semantic iframe element selectors",
+    "oneOf": [
+      {
+        "properties": {
+          "kind": {
+            "const": "main",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "type": "object"
+      },
+      {
+        "properties": {
+          "chain": {
+            "items": {
+              "oneOf": [
+                {
+                  "properties": {
+                    "exact": {
+                      "default": true,
+                      "type": "boolean"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "strategy": {
+                      "const": "role",
+                      "type": "string"
+                    },
+                    "value": {
+                      "$ref": "#/$defs/shared1"
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "value"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "properties": {
+                    "strategy": {
+                      "$ref": "#/$defs/shared2"
+                    },
+                    "value": {
+                      "minLength": 1,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "value"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "maxItems": 5,
+            "minItems": 1,
+            "type": "array"
+          },
+          "kind": {
+            "const": "iframe",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "chain"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "shared1": {
+    "enum": [
+      "button",
+      "link",
+      "textbox",
+      "checkbox",
+      "radio",
+      "combobox",
+      "heading",
+      "listitem",
+      "option",
+      "tab"
+    ],
+    "type": "string"
+  },
+  "shared2": {
+    "enum": [
+      "text",
+      "label",
+      "placeholder",
+      "testId",
+      "css"
+    ],
+    "type": "string"
+  }
+}

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedInput schema / properties / scope / oneOf

Previous value: -[
-  {
-    "properties": {
-      "exact": {
-        "default": true,
-        "type": "boolean"
-      },
-      "frame": {
-        "description": "Top document or a bounded outer-to-inner chain of semantic iframe element selectors",
-        "oneOf": [
-          {
-            "properties": {
-              "kind": {
-                "const": "main",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind"
-            ],
-            "type": "object"
-          },
-          {
-            "properties": {
-              "chain": {
-                "items": {
-                  "oneOf": [
-                    {
-                      "properties": {
-                        "exact": {
-                          "default": true,
-                          "type": "boolean"
-                        },
-                        "name": {
-                          "type": "string"
-                        },
-                        "strategy": {
-                          "const": "role",
-                          "type": "string"
-                        },
-                        "value": {
-                          "enum": [
-                            "button",
-                            "link",
-                            "textbox",
-                            "checkbox",
-                            "radio",
-                            "combobox",
-                            "heading",
-                            "listitem",
-                            "option",
-                            "tab"
-                          ],
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "strategy",
-                        "value"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "strategy": {
-                          "enum": [
-                            "text",
-                            "label",
-                            "placeholder",
-                            "testId",
-                            "css"
-                          ],
-                          "type": "string"
-                        },
-                        "value": {
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "strategy",
-                        "value"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "maxItems": 5,
-                "minItems": 1,
-                "type": "array"
-              },
-              "kind": {
-                "const": "iframe",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "chain"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "name": {
-        "type": "string"
-      },
-      "strategy": {
-        "const": "role",
-        "type": "string"
-      },
-      "value": {
-        "enum": [
-          "button",
-          "link",
-          "textbox",
-          "checkbox",
-          "radio",
-          "combobox",
-          "heading",
-          "listitem",
-          "option",
-          "tab"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "strategy",
-      "value"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "frame": {
-        "description": "Top document or a bounded outer-to-inner chain of semantic iframe element selectors",
-        "oneOf": [
-          {
-            "properties": {
-              "kind": {
-                "const": "main",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind"
-            ],
-            "type": "object"
-          },
-          {
-            "properties": {
-              "chain": {
-                "items": {
-                  "oneOf": [
-                    {
-                      "properties": {
-                        "exact": {
-                          "default": true,
-                          "type": "boolean"
-                        },
-                        "name": {
-                          "type": "string"
-                        },
-                        "strategy": {
-                          "const": "role",
-                          "type": "string"
-                        },
-                        "value": {
-                          "enum": [
-                            "button",
-                            "link",
-                            "textbox",
-                            "checkbox",
-                            "radio",
-                            "combobox",
-                            "heading",
-                            "listitem",
-                            "option",
-                            "tab"
-                          ],
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "strategy",
-                        "value"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "properties": {
-                        "strategy": {
-                          "enum": [
-                            "text",
-                            "label",
-                            "placeholder",
-                            "testId",
-                            "css"
-                          ],
-                          "type": "string"
-                        },
-                        "value": {
-                          "minLength": 1,
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "strategy",
-                        "value"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "maxItems": 5,
-                "minItems": 1,
-                "type": "array"
-              },
-              "kind": {
-                "const": "iframe",
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "chain"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "strategy": {
-        "enum": [
-          "text",
-          "label",
-          "placeholder",
-          "testId",
-          "css"
-        ],
-        "type": "string"
-      },
-      "value": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "strategy",
-      "value"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "exact": {
+        "default": true,
+        "type": "boolean"
+      },
+      "frame": {
+        "$ref": "#/$defs/shared0"
+      },
+      "name": {
+        "type": "string"
+      },
+      "strategy": {
+        "const": "role",
+        "type": "string"
+      },
+      "value": {
+        "$ref": "#/$defs/shared1"
+      }
+    },
+    "required": [
+      "strategy",
+      "value"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "frame": {
+        "$ref": "#/$defs/shared0"
+      },
+      "strategy": {
+        "$ref": "#/$defs/shared2"
+      },
+      "value": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "strategy",
+      "value"
+    ],
+    "type": "object"
+  }
+]

addedOutput schema / $defs

Added value: +{
+  "shared0": {
+    "oneOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "const": "main",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "chain": {
+            "items": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "exact": {
+                      "type": "boolean"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "strategy": {
+                      "const": "role",
+                      "type": "string"
+                    },
+                    "value": {
+                      "$ref": "#/$defs/shared3"
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "value"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "strategy": {
+                      "$ref": "#/$defs/shared4"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "value"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "maxItems": 5,
+            "minItems": 1,
+            "type": "array"
+          },
+          "kind": {
+            "const": "iframe",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "chain"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "shared1": {
+    "maximum": 9007199254740991,
+    "minimum": 0,
+    "type": "integer"
+  },
+  "shared2": {
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  },
+  "shared3": {
+    "enum": [
+      "button",
+      "link",
+      "textbox",
+      "checkbox",
+      "radio",
+      "combobox",
+      "heading",
+      "listitem",
+      "option",
+      "tab"
+    ],
+    "type": "string"
+  },
+  "shared4": {
+    "enum": [
+      "text",
+      "label",
+      "placeholder",
+      "testId",
+      "css"
+    ],
+    "type": "string"
+  }
+}

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedOutput schema / properties / appliedBounds / properties / maxBytes / $ref
```
Added value: +"#/$defs/shared2"
```
removedOutput schema / properties / appliedBounds / properties / maxBytes / exclusiveMinimum
```
Removed value: -0
```
removedOutput schema / properties / appliedBounds / properties / maxBytes / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / appliedBounds / properties / maxBytes / type
```
Removed value: -"integer"
```
addedOutput schema / properties / appliedBounds / properties / maxChars / $ref
```
Added value: +"#/$defs/shared2"
```
removedOutput schema / properties / appliedBounds / properties / maxChars / exclusiveMinimum
```
Removed value: -0
```
removedOutput schema / properties / appliedBounds / properties / maxChars / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / appliedBounds / properties / maxChars / type
```
Removed value: -"integer"
```

changedOutput schema / properties / appliedBounds / properties / maxChildren / anyOf

Previous value: -[
-  {
-    "exclusiveMinimum": 0,
-    "maximum": 9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "$ref": "#/$defs/shared2"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / appliedBounds / properties / maxDepth / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 0,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "$ref": "#/$defs/shared1"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / appliedBounds / properties / maxRefs / $ref
```
Added value: +"#/$defs/shared2"
```
removedOutput schema / properties / appliedBounds / properties / maxRefs / exclusiveMinimum
```
Removed value: -0
```
removedOutput schema / properties / appliedBounds / properties / maxRefs / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / appliedBounds / properties / maxRefs / type
```
Removed value: -"integer"
```

changedOutput schema / properties / appliedBounds / properties / scope / anyOf

Previous value: -[
-  {
-    "oneOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "exact": {
-            "type": "boolean"
-          },
-          "frame": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "kind": {
-                    "const": "main",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "chain": {
-                    "items": {
-                      "oneOf": [
-                        {
-                          "additionalProperties": false,
-                          "properties": {
-                            "exact": {
-                              "type": "boolean"
-                            },
-                            "name": {
-                              "type": "string"
-                            },
-                            "strategy": {
-                              "const": "role",
-                              "type": "string"
-                            },
-                            "value": {
-                              "enum": [
-                                "button",
-                                "link",
-                                "textbox",
-                                "checkbox",
-                                "radio",
-                                "combobox",
-                                "heading",
-                                "listitem",
-                                "option",
-                                "tab"
-                              ],
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "strategy",
-                            "value"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "additionalProperties": false,
-                          "properties": {
-                            "strategy": {
-                              "enum": [
-                                "text",
-                                "label",
-                                "placeholder",
-                                "testId",
-                                "css"
-                              ],
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "strategy",
-                            "value"
-                          ],
-                          "type": "object"
-                        }
-                      ]
-                    },
-                    "maxItems": 5,
-                    "minItems": 1,
-                    "type": "array"
-                  },
-                  "kind": {
-                    "const": "iframe",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind",
-                  "chain"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          "name": {
-            "type": "string"
-          },
-          "strategy": {
-            "const": "role",
-            "type": "string"
-          },
-          "value": {
-            "enum": [
-              "button",
-              "link",
-              "textbox",
-              "checkbox",
-              "radio",
-              "combobox",
-              "heading",
-              "listitem",
-              "option",
-              "tab"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "strategy",
-          "value"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "frame": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "kind": {
-                    "const": "main",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "chain": {
-                    "items": {
-                      "oneOf": [
-                        {
-                          "additionalProperties": false,
-                          "properties": {
-                            "exact": {
-                              "type": "boolean"
-                            },
-                            "name": {
-                              "type": "string"
-                            },
-                            "strategy": {
-                              "const": "role",
-                              "type": "string"
-                            },
-                            "value": {
-                              "enum": [
-                                "button",
-                                "link",
-                                "textbox",
-                                "checkbox",
-                                "radio",
-                                "combobox",
-                                "heading",
-                                "listitem",
-                                "option",
-                                "tab"
-                              ],
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "strategy",
-                            "value"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "additionalProperties": false,
-                          "properties": {
-                            "strategy": {
-                              "enum": [
-                                "text",
-                                "label",
-                                "placeholder",
-                                "testId",
-                                "css"
-                              ],
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "strategy",
-                            "value"
-                          ],
-                          "type": "object"
-                        }
-                      ]
-                    },
-                    "maxItems": 5,
-                    "minItems": 1,
-                    "type": "array"
-                  },
-                  "kind": {
-                    "const": "iframe",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "kind",
-                  "chain"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          "strategy": {
-            "enum": [
-              "text",
-              "label",
-              "placeholder",
-              "testId",
-              "css"
-            ],
-            "type": "string"
-          },
-          "value": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "strategy",
-          "value"
-        ],
-        "type": "object"
-      }
-    ]
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "oneOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "exact": {
+            "type": "boolean"
+          },
+          "frame": {
+            "$ref": "#/$defs/shared0"
+          },
+          "name": {
+            "type": "string"
+          },
+          "strategy": {
+            "const": "role",
+            "type": "string"
+          },
+          "value": {
+            "$ref": "#/$defs/shared3"
+          }
+        },
+        "required": [
+          "strategy",
+          "value"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "frame": {
+            "$ref": "#/$defs/shared0"
+          },
+          "strategy": {
+            "$ref": "#/$defs/shared4"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "strategy",
+          "value"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / omissions / properties / maxChildrenNodes / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / omissions / properties / maxChildrenNodes / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / omissions / properties / maxChildrenNodes / minimum
```
Removed value: -0
```
removedOutput schema / properties / omissions / properties / maxChildrenNodes / type
```
Removed value: -"integer"
```
addedOutput schema / properties / omissions / properties / nonInteractiveNodes / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / omissions / properties / nonInteractiveNodes / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / omissions / properties / nonInteractiveNodes / minimum
```
Removed value: -0
```
removedOutput schema / properties / omissions / properties / nonInteractiveNodes / type
```
Removed value: -"integer"
```
addedOutput schema / properties / pagination / properties / offsetChars / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / pagination / properties / offsetChars / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / pagination / properties / offsetChars / minimum
```
Removed value: -0
```
removedOutput schema / properties / pagination / properties / offsetChars / type
```
Removed value: -"integer"
```
addedOutput schema / properties / truncation / properties / originalBytes / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / truncation / properties / originalBytes / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / truncation / properties / originalBytes / minimum
```
Removed value: -0
```
removedOutput schema / properties / truncation / properties / originalBytes / type
```
Removed value: -"integer"
```
addedOutput schema / properties / truncation / properties / originalChars / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / truncation / properties / originalChars / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / truncation / properties / originalChars / minimum
```
Removed value: -0
```
removedOutput schema / properties / truncation / properties / originalChars / type
```
Removed value: -"integer"
```
addedOutput schema / properties / truncation / properties / returnedBytes / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / truncation / properties / returnedBytes / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / truncation / properties / returnedBytes / minimum
```
Removed value: -0
```
removedOutput schema / properties / truncation / properties / returnedBytes / type
```
Removed value: -"integer"
```
addedOutput schema / properties / truncation / properties / returnedChars / $ref
```
Added value: +"#/$defs/shared1"
```
removedOutput schema / properties / truncation / properties / returnedChars / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / truncation / properties / returnedChars / minimum
```
Removed value: -0
```
removedOutput schema / properties / truncation / properties / returnedChars / type
```
Removed value: -"integer"
```

Changed11 schema fields changedv0.1.5Aug 14, 2026

addedInput schema / properties / cursor

Added value: +{
+  "maxLength": 160,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / includeBoundingBoxes

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

addedInput schema / properties / includeRefs

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

addedInput schema / properties / interactiveOnly

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

addedInput schema / properties / maxBytes

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 131072,
+  "type": "integer"
+}

addedInput schema / properties / maxChars

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 100000,
+  "type": "integer"
+}

addedInput schema / properties / maxChildren

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 1000,
+  "type": "integer"
+}

addedInput schema / properties / maxDepth

Added value: +{
+  "maximum": 100,
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / maxRefs

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 100,
+  "type": "integer"
+}

addedInput schema / properties / scope

Added value: +{
+  "oneOf": [
+    {
+      "properties": {
+        "exact": {
+          "default": true,
+          "type": "boolean"
+        },
+        "frame": {
+          "description": "Top document or a bounded outer-to-inner chain of semantic iframe element selectors",
+          "oneOf": [
+            {
+              "properties": {
+                "kind": {
+                  "const": "main",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "chain": {
+                  "items": {
+                    "oneOf": [
+                      {
+                        "properties": {
+                          "exact": {
+                            "default": true,
+                            "type": "boolean"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "strategy": {
+                            "const": "role",
+                            "type": "string"
+                          },
+                          "value": {
+                            "enum": [
+                              "button",
+                              "link",
+                              "textbox",
+                              "checkbox",
+                              "radio",
+                              "combobox",
+                              "heading",
+                              "listitem",
+                              "option",
+                              "tab"
+                            ],
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "strategy",
+                          "value"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "strategy": {
+                            "enum": [
+                              "text",
+                              "label",
+                              "placeholder",
+                              "testId",
+                              "css"
+                            ],
+                            "type": "string"
+                          },
+                          "value": {
+                            "minLength": 1,
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "strategy",
+                          "value"
+                        ],
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "maxItems": 5,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "kind": {
+                  "const": "iframe",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "chain"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "strategy": {
+          "const": "role",
+          "type": "string"
+        },
+        "value": {
+          "enum": [
+            "button",
+            "link",
+            "textbox",
+            "checkbox",
+            "radio",
+            "combobox",
+            "heading",
+            "listitem",
+            "option",
+            "tab"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "strategy",
+        "value"
+      ],
+      "type": "object"
+    },
+    {
+      "properties": {
+        "frame": {
+          "description": "Top document or a bounded outer-to-inner chain of semantic iframe element selectors",
+          "oneOf": [
+            {
+              "properties": {
+                "kind": {
+                  "const": "main",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "type": "object"
+            },
+            {
+              "properties": {
+                "chain": {
+                  "items": {
+                    "oneOf": [
+                      {
+                        "properties": {
+                          "exact": {
+                            "default": true,
+                            "type": "boolean"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "strategy": {
+                            "const": "role",
+                            "type": "string"
+                          },
+                          "value": {
+                            "enum": [
+                              "button",
+                              "link",
+                              "textbox",
+                              "checkbox",
+                              "radio",
+                              "combobox",
+                              "heading",
+                              "listitem",
+                              "option",
+                              "tab"
+                            ],
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "strategy",
+                          "value"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "properties": {
+                          "strategy": {
+                            "enum": [
+                              "text",
+                              "label",
+                              "placeholder",
+                              "testId",
+                              "css"
+                            ],
+                            "type": "string"
+                          },
+                          "value": {
+                            "minLength": 1,
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "strategy",
+                          "value"
+                        ],
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "maxItems": 5,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "kind": {
+                  "const": "iframe",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "chain"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "strategy": {
+          "enum": [
+            "text",
+            "label",
+            "placeholder",
+            "testId",
+            "css"
+          ],
+          "type": "string"
+        },
+        "value": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "strategy",
+        "value"
+      ],
+      "type": "object"
+    }
+  ]
+}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "appliedBounds": {
+      "additionalProperties": false,
+      "properties": {
+        "includeBoundingBoxes": {
+          "type": "boolean"
+        },
+        "includeRefs": {
+          "type": "boolean"
+        },
+        "interactiveOnly": {
+          "type": "boolean"
+        },
+        "maxBytes": {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        "maxChars": {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        "maxChildren": {
+          "anyOf": [
+            {
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "maxDepth": {
+          "anyOf": [
+            {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "maxRefs": {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        "scope": {
+          "anyOf": [
+            {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "exact": {
+                      "type": "boolean"
+                    },
+                    "frame": {
+                      "oneOf": [
+                        {
+                          "additionalProperties": false,
+                          "properties": {
+                            "kind": {
+                              "const": "main",
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "kind"
+                          ],
+                          "type": "object"
+                        },
+                        {
+                          "additionalProperties": false,
+                          "properties": {
+                            "chain": {
+                              "items": {
+                                "oneOf": [
+                                  {
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "exact": {
+                                        "type": "boolean"
+                                      },
+                                      "name": {
+                                        "type": "string"
+                                      },
+                                      "strategy": {
+                                        "const": "role",
+                                        "type": "string"
+                                      },
+                                      "value": {
+                                        "enum": [
+                                          "button",
+                                          "link",
+                                          "textbox",
+                                          "checkbox",
+                                          "radio",
+                                          "combobox",
+                                          "heading",
+                                          "listitem",
+                                          "option",
+                                          "tab"
+                                        ],
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "strategy",
+                                      "value"
+                                    ],
+                                    "type": "object"
+                                  },
+                                  {
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "strategy": {
+                                        "enum": [
+                                          "text",
+                                          "label",
+                                          "placeholder",
+                                          "testId",
+                                          "css"
+                                        ],
+                                        "type": "string"
+                                      },
+                                      "value": {
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "strategy",
+                                      "value"
+                                    ],
+                                    "type": "object"
+                                  }
+                                ]
+                              },
+                              "maxItems": 5,
+                              "minItems": 1,
+                              "type": "array"
+                            },
+                            "kind": {
+                              "const": "iframe",
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "chain"
+                          ],
+                          "type": "object"
+                        }
+                      ]
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "strategy": {
+                      "const": "role",
+                      "type": "string"
+                    },
+                    "value": {
+                      "enum": [
+                        "button",
+                        "link",
+                        "textbox",
+                        "checkbox",
+                        "radio",
+                        "combobox",
+                        "heading",
+                        "listitem",
+                        "option",
+                        "tab"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "value"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "frame": {
+                      "oneOf": [
+                        {
+                          "additionalProperties": false,
+                          "properties": {
+                            "kind": {
+                              "const": "main",
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "kind"
+                          ],
+                          "type": "object"
+                        },
+                        {
+                          "additionalProperties": false,
+                          "properties": {
+                            "chain": {
+                              "items": {
+                                "oneOf": [
+                                  {
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "exact": {
+                                        "type": "boolean"
+                                      },
+                                      "name": {
+                                        "type": "string"
+                                      },
+                                      "strategy": {
+                                        "const": "role",
+                                        "type": "string"
+                                      },
+                                      "value": {
+                                        "enum": [
+                                          "button",
+                                          "link",
+                                          "textbox",
+                                          "checkbox",
+                                          "radio",
+                                          "combobox",
+                                          "heading",
+                                          "listitem",
+                                          "option",
+                                          "tab"
+                                        ],
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "strategy",
+                                      "value"
+                                    ],
+                                    "type": "object"
+                                  },
+                                  {
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "strategy": {
+                                        "enum": [
+                                          "text",
+                                          "label",
+                                          "placeholder",
+                                          "testId",
+                                          "css"
+                                        ],
+                                        "type": "string"
+                                      },
+                                      "value": {
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "strategy",
+                                      "value"
+                                    ],
+                                    "type": "object"
+                                  }
+                                ]
+                              },
+                              "maxItems": 5,
+                              "minItems": 1,
+                              "type": "array"
+                            },
+                            "kind": {
+                              "const": "iframe",
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "chain"
+                          ],
+                          "type": "object"
+                        }
+                      ]
+                    },
+                    "strategy": {
+                      "enum": [
+                        "text",
+                        "label",
+                        "placeholder",
+                        "testId",
+                        "css"
+                      ],
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "value"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "scope",
+        "maxDepth",
+        "includeBoundingBoxes",
+        "maxChars",
+        "maxBytes",
+        "includeRefs",
+        "maxRefs",
+        "interactiveOnly",
+        "maxChildren"
+      ],
+      "type": "object"
+    },
+    "contentFormat": {
+      "enum": [
+        "aria-yaml",
+        "aria-yaml-fragment"
+      ],
+      "type": "string"
+    },
+    "omissions": {
+      "additionalProperties": false,
+      "properties": {
+        "maxChildrenNodes": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "nonInteractiveNodes": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "sourceLimitReached": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "nonInteractiveNodes",
+        "maxChildrenNodes",
+        "sourceLimitReached"
+      ],
+      "type": "object"
+    },
+    "operationId": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "pageId": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "pagination": {
+      "additionalProperties": false,
+      "properties": {
+        "expiresAt": {
+          "anyOf": [
+            {
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "nextCursor": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "offsetChars": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "snapshotId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "snapshotId",
+        "nextCursor",
+        "offsetChars",
+        "expiresAt"
+      ],
+      "type": "object"
+    },
+    "partial": {
+      "type": "boolean"
+    },
+    "refs": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "maxLength": 120,
+            "type": "string"
+          },
+          "ref": {
+            "pattern": "^@e[a-f0-9]{32}$",
+            "type": "string"
+          },
+          "role": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "tag": {
+            "maxLength": 32,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "ref",
+          "tag"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "sessionId": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "snapshot": {
+      "type": "string"
+    },
+    "truncation": {
+      "additionalProperties": false,
+      "properties": {
+        "byMaxBytes": {
+          "type": "boolean"
+        },
+        "byMaxChars": {
+          "type": "boolean"
+        },
+        "originalBytes": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "originalChars": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "returnedBytes": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "returnedChars": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "truncated": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "truncated",
+        "byMaxChars",
+        "byMaxBytes",
+        "originalChars",
+        "originalBytes",
+        "returnedChars",
+        "returnedBytes"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "operationId",
+    "sessionId",
+    "pageId",
+    "snapshot",
+    "contentFormat",
+    "partial",
+    "refs",
+    "appliedBounds",
+    "omissions",
+    "pagination",
+    "truncation"
+  ],
+  "type": "object"
+}

First observedv0.1.2Aug 12, 2026

TDQS

A4.7/5.0

Behavior5/5

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

Discloses several behaviors beyond annotations: oversized DOMs are rejected before serialization, snapshots are immutable and cursor-continued without rereading a changed DOM, cursors expire or become stale, password-input values are redacted before crossing MCP, and output may be a partial aria-yaml-fragment. These are operationally important and fully consistent with readOnly and idempotent hints.

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?

Four dense, information-bearing sentences in a deliberate progression: purpose/scope, filtering, cursor semantics, then safety and edge cases. Every sentence adds unique operational knowledge without redundancy.

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 tool with 13 parameters and 0% schema parameter documentation, the description covers the major invocation concerns: scoping, bounding, pagination/consistency, output truncation, redaction, and refs. The output schema exists to explain return shape, and annotations cover mutability/idempotence, so little is left for agent guesswork.

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?

With schema description coverage at 0%, the description carries the burden and names semantics for the main controls: scope plus iframe chain, interactiveOnly, maxChildren, cursor, refs with 30-second validity, and broad character/byte/depth/box bounds. It does not spell out sessionId/pageId/timeoutMs semantics, but these are either structurally obvious or inferable from context.

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 action ('Inspect') on a specific artifact ('bounded accessibility-oriented snapshot') and anchors it to 'one explicitly addressed page', which distinguishes it from action tools like browser_click or browser_screenshot. The sibling set includes browser_observe and visible_text, but the description's emphasis on semantic/accessibility scope makes the function's role clear without needing to open the schema.

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

Usage Guidelines4/5

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

The description gives strong contextual guidance: when to scope with a locator/iframe chain, when to use interactiveOnly, when to page with cursor, and the short-lived nature of element refs. It does not explicitly name alternatives or state when not to use the tool, but the accessibility-oriented framing gives enough context for tool selection.

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