Skip to main content
Glama
timotheeiss

Semantic Hints MCP

by timotheeiss

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SEMANTIC_HINTS_CDP_URLNoCDP endpoint of the shared Chromium to attach to.http://127.0.0.1:9222
SEMANTIC_HINTS_HEADLESSNoHeadless mode for the standalone-launch fallback only.true
SEMANTIC_HINTS_TARGET_URLNoOptional default app URL, opened when a tool is called with no url.
SEMANTIC_HINTS_LAUNCH_BROWSERNoIf true, may launch a private browser when the CDP connection fails.false

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
semantic_snapshotA

Return a compact map of hinted UI elements (only elements carrying data-agent-id), grouped into regions/actions/inputs/observables/navigation/other. Use this as a cheap first observation instead of a full accessibility snapshot. To act on an element, pick its id and use the Playwright MCP with selector [data-agent-id='']. Returns compact JSON only — never HTML, DOM, or class names.

semantic_observeA

Return the current compact value/state of a single hinted element, resolved via [data-agent-id='']. Returns a clear error if no element or multiple elements match. Use after a snapshot to read the live value/state of one element. Returns compact JSON only.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/timotheeiss/semantic-hints-mcp'

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