Skip to main content
Glama

Get component

get_component
Read-onlyIdempotent

Return one component candidate and its descendants. Prefers the id/parent tree; falls back to rectangle containment. Includes a crop rectangle for the page image.

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>",
      "elementId": "<elementId>"
    },
    "name": "get_component"
  }
}

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..200. Default 100.
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.
elementIdYesZero-based captured element ID from find_elements or get_elements. Must belong to the selected page, view and pinned version.
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
idYesCount or zero-based index
cropYes
rootYes
elementsYesResult entries
extractionYesText value

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changed
    • 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: +"Root element and bounded descendant evidence"
    • addedOutput schema / properties / crop
      Added value: +{
      +  "$ref": "#/$defs/rect"
      +}
    • addedOutput schema / properties / elements
      Added value: +{
      +  "description": "Result entries",
      +  "items": {
      +    "additionalProperties": true,
      +    "description": "Captured descendant",
      +    "properties": {
      +      "element": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/element"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "id": {
      +        "description": "Count or zero-based index",
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "element"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / extraction
      Added value: +{
      +  "description": "Text value",
      +  "type": "string"
      +}
    • addedOutput schema / properties / id
      Added value: +{
      +  "description": "Count or zero-based index",
      +  "type": "integer"
      +}
    • removedOutput schema / properties / result
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Root element and bounded descendant evidence",
      -  "properties": {
      -    "crop": {
      -      "$ref": "#/$defs/rect"
      -    },
      -    "elements": {
      -      "description": "Result entries",
      -      "items": {
      -        "additionalProperties": true,
      -        "description": "Captured descendant",
      -        "properties": {
      -          "element": {
      -            "anyOf": [
      -              {
      -                "$ref": "#/$defs/element"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "id": {
      -            "description": "Count or zero-based index",
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "element"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "extraction": {
      -      "description": "Text value",
      -      "type": "string"
      -    },
      -    "id": {
      -      "description": "Count or zero-based index",
      -      "type": "integer"
      -    },
      -    "root": {
      -      "$ref": "#/$defs/element"
      -    }
      -  },
      -  "required": [
      -    "id",
      -    "root",
      -    "crop",
      -    "elements",
      -    "extraction"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / properties / root
      Added value: +{
      +  "$ref": "#/$defs/element"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "id",
      +  "root",
      +  "crop",
      +  "elements",
      +  "extraction"
      +]
  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 / elementId / description
      Added value: +"Zero-based captured element ID from find_elements or get_elements. Must belong to the selected page, view and pinned version."
    • addedInput schema / properties / limit / description
      Added value: +"Maximum items returned, clamped to 1..200. Default 100."
    • 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": "Root element and bounded descendant evidence",
      +      "properties": {
      +        "crop": {
      +          "$ref": "#/$defs/rect"
      +        },
      +        "elements": {
      +          "description": "Result entries",
      +          "items": {
      +            "additionalProperties": true,
      +            "description": "Captured descendant",
      +            "properties": {
      +              "element": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/element"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "id": {
      +                "description": "Count or zero-based index",
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "element"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "extraction": {
      +          "description": "Text value",
      +          "type": "string"
      +        },
      +        "id": {
      +          "description": "Count or zero-based index",
      +          "type": "integer"
      +        },
      +        "root": {
      +          "$ref": "#/$defs/element"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "root",
      +        "crop",
      +        "elements",
      +        "extraction"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  4. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so the safety profile is covered. The description goes beyond them by disclosing the resolution strategy (id/parent tree preferred, rectangle containment as fallback) and that the response carries a crop rectangle for the page image — real behavioral context an agent cannot get from structured fields.

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?

Three short sentences, each carrying distinct information: the return scope, the resolution algorithm, and the attached crop rectangle. The core purpose is front-loaded and nothing is padded.

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?

With a full schema and an output schema, the description only needs to cover behavior, which it does by explaining the tree-vs-containment fallback. Minor gaps remain around failure modes such as an elementId that does not belong to the pinned page/view/version, but those constraints are already stated in the schema.

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

Parameters3/5

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

Schema description coverage is 100% and every parameter, including the page/view/version pinning rules, is documented in the schema itself. The description adds no parameter-level meaning beyond what is already structured, so the baseline 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?

The description states a specific verb and resource: 'Return one component candidate and its descendants.' That clearly separates it from list-style siblings such as list_component_candidates, though it never names the closest alternatives (get_component_tree, get_page_components) to sharpen the distinction.

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 explicit when-to-use or when-not-to-use guidance and no mention of alternatives among the many get_component_* siblings. The single-item scope implies usage but leaves the agent to infer it from the tool name.

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