Skip to main content
Glama
helmif

semantic-dom-mcp

by helmif

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
QA_MCP_TEAM_NAMENoOptional team name used in the write_playwright_test prompt.QA
QA_MCP_ALLOWED_HOSTSYesComma-separated hostnames the server may navigate to. Navigation is denied by default. Supports host, host:port, and *.domain entries.
QA_MCP_STORAGE_STATENoOptional path to a Playwright storageState JSON for pre-authenticated staging sessions.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
extract_semantic_domA

Navigate to a staging URL and return factual Semantic JSON of all interactive/test-relevant elements with Playwright-native locators and live state. Use this before writing any Playwright test so selectors are real, not guessed.

extract_semantic_dom_afterA

Like extract_semantic_dom, but first performs a short DECLARED list of actions (fill/click/press/wait) in the main frame, then returns Semantic JSON of the RESULTING state. Use it for post-interaction UI a plain snapshot cannot see: success/error toasts, validation messages, opened dialogs. Derive action locators from a prior extract_semantic_dom call. The page must remain on allowlisted hosts after the actions, or nothing is extracted. Uniqueness reflects capture time — accumulating UI (chat threads, lists) can multiply matches later.

list_framesA

Diagnostic: navigate to a URL and return its frame tree (frame_path, url, name, same_origin, reachable). Useful for debugging cross-origin iframe boundaries before extraction.

check_authA

Diagnostic: navigates with the configured QA_MCP_STORAGE_STATE session and reports whether the page bounced to a login-looking path (session likely expired). Use when extractions unexpectedly return login forms instead of the requested page.

Prompts

Interactive templates invoked by user choice

NameDescription
write_playwright_testTeam-standard prompt for writing a Playwright test in TypeScript from a Semantic DOM extraction. Ensures every engineer gets identical conventions: locator usage, frame chaining, structure, assertions, and single-snapshot state honesty.

Resources

Contextual data attached and managed by the client

NameDescription
playwright-conventionsThe team's non-negotiable Playwright test-writing conventions (read-only).

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/helmif/semantic-dom-mcp'

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