MCP Tools Reference

Tools available to your AI agent

When connected via MCP, your AI agent gets these tools. Each tool is one operation against your daily quota.

sifr_capture

perception

Captures the current page state as structured SiFR JSON. Returns salience-scored elements with semantic relationships, computed styles, spatial positions, and actionable selectors. 5-15KB per capture vs 200-400KB raw HTML.

sifr_capture(url: "https://example.com")

read_page

perception

Returns the text content of the captured page in a readable format. Title, URL, and extracted text content. Useful for understanding page content without parsing SiFR nodes.

read_page(sessionId: "abc123")

query

perception

Search for elements in the captured page by text, tag, selector, or salience level. Returns matching nodes with full SiFR detail.

query(sessionId: "abc123", text: "Submit")

inspect

perception

Get full details about a specific element — all attributes, computed styles, spatial position, children, parent relationships.

inspect(sessionId: "abc123", nodeId: "btn003")

act

action

Perform a single action on the page — click, type, scroll, select, navigate. Returns mutation diff showing what changed.

act(sessionId: "abc123", action: "click", target: "btn003")

batch_act

action

Perform multiple actions in sequence as a single operation. Optionally submit a form after all steps. Reduces "element changed since capture" errors between clicks.

batch_act(sessionId: "abc123", steps: [ {action: "click", target: "button[data-test='tea']"}, {action: "click", target: "button[data-test='coffee']"} ], submit: "button[data-test='next']")

explore

action

Scroll within a page and recapture — discover content below the fold without a full page reload.

explore(sessionId: "abc123", action: "scroll", target: "#main")

list_tabs

perception

List all open browser tabs across all connected browsers. Returns tab ID, URL, title, and active status. Works cross-browser — Chrome and Firefox tabs in one response.

list_tabs()