MCP integration

SootSim exposes its capabilities as MCP (Model Context Protocol) tools, allowing AI agents like Claude Desktop and Claude Code to interact with your app.

Setup

Claude Desktop

add to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sootsim": {
      "command": "npx",
      "args": ["sootsim", "mcp", "--url", "http://localhost:5173"]
    }
  }
}

Claude Code

add to .claude/settings.json:

{
  "mcpServers": {
    "sootsim": {
      "command": "npx",
      "args": ["sootsim", "mcp"]
    }
  }
}

Available tools

tool	description
`sootsim_screenshot`	capture a screenshot of the app
`sootsim_tap`	tap an element by text, id, or label
`sootsim_find_element`	find an element in the node tree
`sootsim_dump_tree`	dump the node tree for inspection
`sootsim_run_flow`	run a maestro YAML flow
`sootsim_type_text`	type text into the focused input

Example usage

Once configured, you can ask Claude:

“take a screenshot of the app” “tap the login button” “find the search input and type ‘hello’” “dump the accessibility tree” “run the login test flow”

Claude will use SootSim’s MCP tools to interact with your app directly.

Skills

SootSim includes built-in skills that agents can discover:

test-flow — run test flows, generate flows from app crawling
screenshot-all — capture all screens, generate gallery
a11y-review — accessibility audit with issue detection
visual-diff — compare rendering against baseline screenshots
perf-profile — profile render performance
compat-check — check package compatibility

Setup