Skip to main content
Glama
jumodada

DrissionPage MCP Server

by jumodada
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Page Snapshot

page_snapshot
Read-onlyIdempotent

Capture a bounded page outline with text excerpts, headings, links, buttons, inputs, forms, and recommended selectors to inspect and automate web pages.

Instructions

Return a bounded page outline with text excerpt, headings, links, buttons, inputs, forms, and recommended selectors.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
tab_idNoOptional MCP or native DrissionPage tab id. When omitted, the current tab is captured at call start.
include_htmlNoInclude bounded outerHTML excerpts for summarized elements
max_elementsNoMaximum total headings/links/buttons/inputs/forms to return
max_text_charsNoMaximum page text excerpt characters to return

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.8.8
    • 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": {
-          "buttons": {
-            "items": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "title": "Buttons",
-            "type": "array"
-          },
-          "counts": {
-            "additionalProperties": {
-              "type": "integer"
-            },
-            "title": "Counts",
-            "type": "object"
-          },
-          "forms": {
-            "items": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "title": "Forms",
-            "type": "array"
-          },
-          "headings": {
-            "items": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "title": "Headings",
-            "type": "array"
-          },
-          "inputs": {
-            "items": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "title": "Inputs",
-            "type": "array"
-          },
-          "limits": {
-            "additionalProperties": true,
-            "title": "Limits",
-            "type": "object"
-          },
-          "links": {
-            "items": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "title": "Links",
-            "type": "array"
-          },
-          "meta": {
-            "additionalProperties": true,
-            "title": "Meta",
-            "type": "object"
-          },
-          "text_excerpt": {
-            "title": "Text Excerpt",
-            "type": "string"
-          },
-          "title": {
-            "title": "Title",
-            "type": "string"
-          },
-          "truncated": {
-            "additionalProperties": true,
-            "title": "Truncated",
-            "type": "object"
-          },
-          "url": {
-            "title": "Url",
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "title",
-          "text_excerpt",
-          "headings",
-          "links",
-          "buttons",
-          "inputs",
-          "forms",
-          "counts",
-          "truncated",
-          "limits",
-          "meta"
-        ],
-        "title": "PageSnapshotData",
-        "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": {
+          "buttons": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Buttons",
+            "type": "array"
+          },
+          "counts": {
+            "additionalProperties": {
+              "type": "integer"
+            },
+            "title": "Counts",
+            "type": "object"
+          },
+          "forms": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Forms",
+            "type": "array"
+          },
+          "headings": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Headings",
+            "type": "array"
+          },
+          "inputs": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Inputs",
+            "type": "array"
+          },
+          "limits": {
+            "additionalProperties": true,
+            "title": "Limits",
+            "type": "object"
+          },
+          "links": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Links",
+            "type": "array"
+          },
+          "meta": {
+            "additionalProperties": true,
+            "title": "Meta",
+            "type": "object"
+          },
+          "tab_id": {
+            "description": "MCP tab id captured for this operation.",
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "text_excerpt": {
+            "title": "Text Excerpt",
+            "type": "string"
+          },
+          "title": {
+            "title": "Title",
+            "type": "string"
+          },
+          "truncated": {
+            "additionalProperties": true,
+            "title": "Truncated",
+            "type": "object"
+          },
+          "url": {
+            "title": "Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "title",
+          "text_excerpt",
+          "headings",
+          "links",
+          "buttons",
+          "inputs",
+          "forms",
+          "counts",
+          "truncated",
+          "limits",
+          "meta",
+          "tab_id"
+        ],
+        "title": "PageSnapshotData",
+        "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"
+  }
+]
  2. Addedv0.8.0
  3. Removedv0.7.2
  4. Changed1 schema field changedv0.7.2
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "buttons": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "counts": {
-            "additionalProperties": {
-              "type": "integer"
-            },
-            "type": "object"
-          },
-          "forms": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "headings": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "inputs": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "limits": {
-            "additionalProperties": false,
-            "properties": {
-              "max_elements": {
-                "type": "integer"
-              },
-              "max_text_chars": {
-                "type": "integer"
-              }
-            },
-            "required": [
-              "max_elements",
-              "max_text_chars"
-            ],
-            "title": "PageSnapshotLimits",
-            "type": "object"
-          },
-          "links": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "meta": {
-            "additionalProperties": false,
-            "properties": {
-              "approx_tokens": {
-                "type": "integer"
-              },
-              "json_chars": {
-                "type": "integer"
-              },
-              "truncated": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "approx_tokens",
-              "json_chars",
-              "truncated"
-            ],
-            "title": "ResponseMeta",
-            "type": "object"
-          },
-          "text_excerpt": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "truncated": {
-            "additionalProperties": false,
-            "properties": {
-              "elements": {
-                "type": "boolean"
-              },
-              "returned_elements": {
-                "type": "integer"
-              },
-              "text": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "text",
-              "elements",
-              "returned_elements"
-            ],
-            "title": "PageSnapshotTruncation",
-            "type": "object"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "title",
-          "text_excerpt",
-          "headings",
-          "links",
-          "buttons",
-          "inputs",
-          "forms",
-          "counts",
-          "truncated",
-          "limits",
-          "meta"
-        ],
-        "title": "PageSnapshotData",
-        "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": {
+          "buttons": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Buttons",
+            "type": "array"
+          },
+          "counts": {
+            "additionalProperties": {
+              "type": "integer"
+            },
+            "title": "Counts",
+            "type": "object"
+          },
+          "forms": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Forms",
+            "type": "array"
+          },
+          "headings": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Headings",
+            "type": "array"
+          },
+          "inputs": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Inputs",
+            "type": "array"
+          },
+          "limits": {
+            "additionalProperties": true,
+            "title": "Limits",
+            "type": "object"
+          },
+          "links": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "title": "Links",
+            "type": "array"
+          },
+          "meta": {
+            "additionalProperties": true,
+            "title": "Meta",
+            "type": "object"
+          },
+          "text_excerpt": {
+            "title": "Text Excerpt",
+            "type": "string"
+          },
+          "title": {
+            "title": "Title",
+            "type": "string"
+          },
+          "truncated": {
+            "additionalProperties": true,
+            "title": "Truncated",
+            "type": "object"
+          },
+          "url": {
+            "title": "Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "title",
+          "text_excerpt",
+          "headings",
+          "links",
+          "buttons",
+          "inputs",
+          "forms",
+          "counts",
+          "truncated",
+          "limits",
+          "meta"
+        ],
+        "title": "PageSnapshotData",
+        "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"
+  }
+]
  5. Changed1 schema field changedv0.5.1
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "buttons": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "counts": {
-            "additionalProperties": {
-              "type": "integer"
-            },
-            "type": "object"
-          },
-          "forms": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "headings": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "inputs": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "limits": {
-            "additionalProperties": false,
-            "properties": {
-              "max_elements": {
-                "type": "integer"
-              },
-              "max_text_chars": {
-                "type": "integer"
-              }
-            },
-            "required": [
-              "max_elements",
-              "max_text_chars"
-            ],
-            "title": "PageSnapshotLimits",
-            "type": "object"
-          },
-          "links": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "action": {
-                  "type": "string"
-                },
-                "attributes": {
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "object"
-                },
-                "href": {
-                  "type": "string"
-                },
-                "html": {
-                  "type": "string"
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "method": {
-                  "type": "string"
-                },
-                "selector": {
-                  "type": "string"
-                },
-                "tag": {
-                  "type": "string"
-                },
-                "text": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "tag",
-                "text",
-                "selector",
-                "attributes"
-              ],
-              "title": "OutlineElement",
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "text_excerpt": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "truncated": {
-            "additionalProperties": false,
-            "properties": {
-              "elements": {
-                "type": "boolean"
-              },
-              "returned_elements": {
-                "type": "integer"
-              },
-              "text": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "text",
-              "elements",
-              "returned_elements"
-            ],
-            "title": "PageSnapshotTruncation",
-            "type": "object"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "title",
-          "text_excerpt",
-          "headings",
-          "links",
-          "buttons",
-          "inputs",
-          "forms",
-          "counts",
-          "truncated",
-          "limits"
-        ],
-        "title": "PageSnapshotData",
-        "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": {
+          "buttons": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "attributes": {
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "object"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "html": {
+                  "type": "string"
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "method": {
+                  "type": "string"
+                },
+                "selector": {
+                  "type": "string"
+                },
+                "tag": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "tag",
+                "text",
+                "selector",
+                "attributes"
+              ],
+              "title": "OutlineElement",
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "counts": {
+            "additionalProperties": {
+              "type": "integer"
+            },
+            "type": "object"
+          },
+          "forms": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "attributes": {
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "object"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "html": {
+                  "type": "string"
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "method": {
+                  "type": "string"
+                },
+                "selector": {
+                  "type": "string"
+                },
+                "tag": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "tag",
+                "text",
+                "selector",
+                "attributes"
+              ],
+              "title": "OutlineElement",
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "headings": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "attributes": {
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "object"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "html": {
+                  "type": "string"
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "method": {
+                  "type": "string"
+                },
+                "selector": {
+                  "type": "string"
+                },
+                "tag": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "tag",
+                "text",
+                "selector",
+                "attributes"
+              ],
+              "title": "OutlineElement",
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "inputs": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "attributes": {
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "object"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "html": {
+                  "type": "string"
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "method": {
+                  "type": "string"
+                },
+                "selector": {
+                  "type": "string"
+                },
+                "tag": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "tag",
+                "text",
+                "selector",
+                "attributes"
+              ],
+              "title": "OutlineElement",
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "limits": {
+            "additionalProperties": false,
+            "properties": {
+              "max_elements": {
+                "type": "integer"
+              },
+              "max_text_chars": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "max_elements",
+              "max_text_chars"
+            ],
+            "title": "PageSnapshotLimits",
+            "type": "object"
+          },
+          "links": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "attributes": {
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "object"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "html": {
+                  "type": "string"
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "method": {
+                  "type": "string"
+                },
+                "selector": {
+                  "type": "string"
+                },
+                "tag": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "tag",
+                "text",
+                "selector",
+                "attributes"
+              ],
+              "title": "OutlineElement",
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "meta": {
+            "additionalProperties": false,
+            "properties": {
+              "approx_tokens": {
+                "type": "integer"
+              },
+              "json_chars": {
+                "type": "integer"
+              },
+              "truncated": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "approx_tokens",
+              "json_chars",
+              "truncated"
+            ],
+            "title": "ResponseMeta",
+            "type": "object"
+          },
+          "text_excerpt": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "truncated": {
+            "additionalProperties": false,
+            "properties": {
+              "elements": {
+                "type": "boolean"
+              },
+              "returned_elements": {
+                "type": "integer"
+              },
+              "text": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "text",
+              "elements",
+              "returned_elements"
+            ],
+            "title": "PageSnapshotTruncation",
+            "type": "object"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "title",
+          "text_excerpt",
+          "headings",
+          "links",
+          "buttons",
+          "inputs",
+          "forms",
+          "counts",
+          "truncated",
+          "limits",
+          "meta"
+        ],
+        "title": "PageSnapshotData",
+        "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"
+  }
+]
  6. Addedv0.5.0

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, openWorldHint=true and destructiveHint=false, so the safety profile is covered. The description adds the 'bounded' trait, implying capped output, which is useful but thin; it says nothing about truncation behavior or how selectors are derived.

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 with no filler; the key action comes first and the content list follows. It is slightly dense with enumerations but every clause earns its place.

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 the safety profile is carried by annotations. However, for a tool with multiple near-overlapping siblings, the description lacks the usage/routing context an agent needs to choose it confidently, leaving it only minimally complete.

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%, so the schema already documents tab_id, include_html, max_elements and max_text_chars. The description's word 'bounded' loosely gestures at the size-limiting parameters but adds no syntax or meaning beyond the schema, so the baseline 3 applies.

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 and resource ('Return a bounded page outline') and enumerates exactly what content the outline contains (headings, links, buttons, inputs, forms, selectors). It is clear what the tool does, but it does not differentiate itself from sibling snapshot/observe tools like page_accessibility_snapshot or page_observe.

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 when-to-use guidance, no mention of prerequisites (e.g., a page must be navigated first), and no routing to alternatives. With several overlapping siblings (page_accessibility_snapshot, page_observe, page_evaluate, frame_snapshot), the absence of any differentiation guidance is a real gap.

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

Deploy Server

Other Tools