Skip to main content
Glama

Get elements

get_elements
Read-onlyIdempotent

Read a paginated slice of captured elements: id/parent tree, layout, effects, text/content, href/action, media source and rectangles (about 1 KB each). detail=full adds computed styles and state probes (about 10 KB each); for one element prefer get_component_styles.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "product": "<product>",
      "version": "<version>",
      "page": "<page>",
      "view": "<view>"
    },
    "name": "get_elements"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageYesCaptured page key returned by list_pages or get_application_manifest, not a URL or filesystem path.
viewYesExact stored profile key from list_pages.views (desktop, mobile, numbered profiles or a device label); do not pass the operating system here.
limitNoMaximum items returned, clamped to 1..50. Default 20.
detailNosummary (default) omits computed styles, state probes and null fields; full returns the stored element records.summary
offsetNoZero-based result offset for pagination. Negative values are treated as zero; default is 0.
productYesProduct key, for example finance-ozon-ru
versionYesExact capture version returned by list_versions. Pin the same version across related calls; do not use latest as an alias.
environmentNoEnvironment ID from the selected backend platform type in list_platforms.options.platforms[].environments[].id (backend implementation). Omit only when the version has one captured environment. Use captured pairs from list_platforms/list_versions for actual availability.

Output Schema

NameRequiredDescriptionDefault
totalYesElements captured on the page
detailNosummary omits computed styles, state probes and null fields
offsetYesZero-based index of the first returned element
elementsYesResult entries

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changed
    • addedInput schema / properties / detail
      Added value: +{
      +  "default": "summary",
      +  "description": "summary (default) omits computed styles, state probes and null fields; full returns the stored element records.",
      +  "enum": [
      +    "summary",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • changedOutput schema / description
      Previous value: -"Structured result. Existing text or image content remains available in content."New value: +"Paginated captured element records"
    • addedOutput schema / properties / detail
      Added value: +{
      +  "description": "summary omits computed styles, state probes and null fields",
      +  "enum": [
      +    "summary",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / elements
      Added value: +{
      +  "description": "Result entries",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "$ref": "#/$defs/element"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / offset
      Added value: +{
      +  "description": "Zero-based index of the first returned element",
      +  "type": "integer"
      +}
    • removedOutput schema / properties / result
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Paginated captured element records",
      -  "properties": {
      -    "elements": {
      -      "description": "Result entries",
      -      "items": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/element"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": "array"
      -    },
      -    "offset": {
      -      "description": "Count or zero-based index",
      -      "type": "integer"
      -    },
      -    "total": {
      -      "description": "Count or zero-based index",
      -      "type": "integer"
      -    }
      -  },
      -  "required": [
      -    "total",
      -    "offset",
      -    "elements"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / properties / total
      Added value: +{
      +  "description": "Elements captured on the page",
      +  "type": "integer"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "total",
      +  "offset",
      +  "elements"
      +]
  2. Changed16 schema fields changed
    • addedOutput schema / $defs / element / properties / a11y
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "DOM approximation of computed role, accessible name, focusability and ARIA states",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / component
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Component kind used for the state catalog (button, link, nav-item, textbox, checkbox, tab, menu-trigger, disclosure, card…)",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / embed
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Embedded frame or object: src, provider, title, same-origin flag. The child document is not captured",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / field
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Form control metadata: type, name, label, placeholder, constraints, options. Never contains entered values",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / form
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Form element: endpoint without query, method, enctype, field count",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / frame
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Embedded frame inspection: url, title, element count, evidence file and screenshot",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / logo
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Brand logo evidence: primary, score, confidence (high/medium/low) and the signals that matched",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / media
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Image or player attributes: alt, srcset, sizes, loading, autoplay, loop, muted, poster, sources, tracks",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / observedStates
      Added value: +{
      +  "description": "States the page already showed for this element (disabled, checked, selected, expanded, current, loading, error…)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / $defs / element / properties / pseudoStyles
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Computed styles of ::before, ::after and a styled ::marker",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / reveals
      Added value: +{
      +  "description": "Content revealed by real hover or click on this element: evidence file with the new nodes, screenshot and count",
      +  "items": {},
      +  "type": "array"
      +}
    • addedOutput schema / $defs / element / properties / stateCatalog
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Applicable states for the component kind with measured, unchanged and unsupported lists and screenshot file names per state",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / states
      Added value: +{
      +  "description": "Measured computed-style deltas per state (pseudo-class forced through CDP or DOM state set and restored): state, method, computed, screenshot for the element itself; trigger is the ancestor whose state restyles this node",
      +  "items": {},
      +  "type": "array"
      +}
    • addedOutput schema / $defs / element / properties / themeVariants
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "description": "Computed-style deltas keyed by alternate color scheme, measured with prefers-color-scheme emulation and the site theme switch",
      +      "properties": {},
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / title
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "title attribute",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / element / properties / volatile
      Added value: +{
      +  "description": "Reasons the region changes independently of user input (aria-live, carousel, autoplay video, looping animation, observed mutations); exclude from visual diffs",
      +  "items": {},
      +  "type": "array"
      +}
  3. Changed6 schema fields changed
    • addedInput schema / properties / limit / description
      Added value: +"Maximum items returned, clamped to 1..50. Default 20."
    • addedInput schema / properties / offset / description
      Added value: +"Zero-based result offset for pagination. Negative values are treated as zero; default is 0."
    • addedInput schema / properties / page / description
      Added value: +"Captured page key returned by list_pages or get_application_manifest, not a URL or filesystem path."
    • addedInput schema / properties / product / description
      Added value: +"Product key, for example finance-ozon-ru"
    • addedInput schema / properties / version / description
      Added value: +"Exact capture version returned by list_versions. Pin the same version across related calls; do not use latest as an alias."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "element": {
      +      "additionalProperties": true,
      +      "description": "Captured element; fields depend on capture format and available evidence",
      +      "properties": {
      +        "computed": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "description": "Captured CSS properties",
      +              "properties": {},
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "content": {
      +          "anyOf": [
      +            {
      +              "description": "content",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "effects": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "description": "Captured effects",
      +              "properties": {},
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "id": {
      +          "description": "Count or zero-based index",
      +          "type": "integer"
      +        },
      +        "layout": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "description": "Measured layout",
      +              "properties": {},
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "lines": {
      +          "anyOf": [
      +            {
      +              "description": "Result entries",
      +              "items": {
      +                "description": "Text value",
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "motion": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "description": "Captured motion",
      +              "properties": {},
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "parent": {
      +          "anyOf": [
      +            {
      +              "description": "Count or zero-based index",
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "path": {
      +          "anyOf": [
      +            {
      +              "description": "path",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "rect": {
      +          "anyOf": [
      +            {
      +              "$ref": "#/$defs/rect"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "role": {
      +          "anyOf": [
      +            {
      +              "description": "role",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "source": {
      +          "anyOf": [
      +            {
      +              "description": "source",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "tag": {
      +          "anyOf": [
      +            {
      +              "description": "tag",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "text": {
      +          "anyOf": [
      +            {
      +              "description": "text",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "textRuns": {
      +          "anyOf": [
      +            {
      +              "description": "Result entries",
      +              "items": {
      +                "additionalProperties": true,
      +                "description": "Captured styled text run",
      +                "properties": {},
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "rect": {
      +      "additionalProperties": true,
      +      "description": "Captured CSS-pixel rectangle",
      +      "properties": {
      +        "height": {
      +          "description": "height",
      +          "type": "number"
      +        },
      +        "width": {
      +          "description": "width",
      +          "type": "number"
      +        },
      +        "x": {
      +          "description": "x",
      +          "type": "number"
      +        },
      +        "y": {
      +          "description": "y",
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "description": "Structured result. Existing text or image content remains available in content.",
      +  "properties": {
      +    "result": {
      +      "additionalProperties": true,
      +      "description": "Paginated captured element records",
      +      "properties": {
      +        "elements": {
      +          "description": "Result entries",
      +          "items": {
      +            "anyOf": [
      +              {
      +                "$ref": "#/$defs/element"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        "offset": {
      +          "description": "Count or zero-based index",
      +          "type": "integer"
      +        },
      +        "total": {
      +          "description": "Count or zero-based index",
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "total",
      +        "offset",
      +        "elements"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  4. First observed

TDQS

A3.8/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so safety is covered structurally. The description adds genuinely useful behavior beyond that: approximate payload cost per element (~1 KB vs ~10 KB) and the fact that results are a paged slice. It does not discuss ordering, total counts, or behavior when page/version keys are stale.

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?

Two dense sentences, front-loaded with the core action and payload contents, then the cost tradeoff and the alternative routing. No filler and every clause carries information an agent can act on.

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

Completeness4/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 shape need not be restated, and the description covers scope, cost and paging adequately for an 8-parameter read tool. The remaining gap is sibling-level disambiguation (find_elements, get_page_components) for an agent choosing among many listing tools.

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 coverage is 100%, so the schema already documents page, view, version, limit, offset and detail. The description's incremental contribution is limited to the size implications of detail=full (computed styles and state probes); it adds no guidance on the required product/version/page/view keys. Baseline 3 applies, with a small lift for the payload framing.

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 ('Read a paginated slice of captured elements') and enumerates exactly what is included: id/parent tree, layout, effects, text/content, href/action, media source, rectangles. It differentiates from get_component_styles for the single-element case, though it does not distinguish itself from the closely related find_elements sibling.

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

Usage Guidelines4/5

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

Gives an explicit routing rule: 'for one element prefer get_component_styles.' It also implies the detail=summary vs detail=full tradeoff. It stops short of explaining when to use this bulk listing versus find_elements or get_page_components, so exclusions are only partially covered.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources