Skip to main content
Glama
jumodada

DrissionPage MCP Server

by jumodada

Page Snapshot

page_snapshot
Read-onlyIdempotent

Return a bounded page outline with text excerpts, headings, links, buttons, inputs, forms, and recommended selectors for browser automation.

Instructions

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

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
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. Dates show when Glama detected each change.

  1. Addedv0.8.0
  2. Removedv0.7.2
  3. 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"
      +  }
      +]
  4. 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"
      +  }
      +]
  5. Addedv0.5.0

TDQS

A4.1/5.0
Behavior4/5

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

Annotations (readOnlyHint, idempotentHint, destructiveHint=false) already establish the safety profile. The description adds valuable context by highlighting the 'bounded' nature (controlled by max_elements and max_text_chars) and enumerating the output components, going beyond the bare annotations without contradiction.

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?

The description is a single, front-loaded sentence that directly states the tool's purpose and output scope without any filler. Every word adds meaning.

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?

Given the simplicity of the tool, the presence of a rich output schema, and complete annotations, the description fully covers the necessary context. It communicates the key output categories and bounded nature, making it self-sufficient for agent invocation.

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% for all three parameters, so the schema already fully documents them. The description adds no additional parameter-specific detail; it focuses on the output rather than parameter behavior, which is acceptable but does not exceed the baseline.

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?

Description uses a specific verb ('Return') and a clear resource ('bounded page outline'), enumerating distinct content types (text excerpt, headings, links, buttons, inputs, forms, recommended selectors). This clearly differentiates it from sibling 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 Guidelines3/5

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

The description implies usage for obtaining a summarized page overview but does not explicitly state when to use it instead of alternatives, nor does it mention exclusions or preconditions. It lacks the explicit alternative guidance seen in the calibration example.

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jumodada/Drissionpage-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server