# omnisnap-mcp

omnisnap-mcp gives Cursor, Claude, and any MCP client the Chrome tab you are already signed in to. It is a local stdio server. It is not hosted on this website. Install it with `npx -y omnisnap-mcp`. It needs OmniSnap AI Studio 1.9 or later and Node.js 18 or newer.

Registry name: `io.github.developerpagadi/omnisnap`. Card: https://omnisnap.metago.in/.well-known/mcp.json

```json
{
  "mcpServers": {
    "omnisnap": {
      "command": "npx",
      "args": ["-y", "omnisnap-mcp"]
    }
  }
}
```

Clients that can use that config include Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Cline, Codex, and Goose.

## How pairing works

1. In the extension, turn on Connect to AI. It shows a six-digit code.
2. The client asks for that code the first time. Type it once.
3. The server binds to 127.0.0.1. No web page can reach it. It stays off until you switch it on.

## Twenty-two tools

Read, without changing the page: `omnisnap_status`, `annotate_interactive`, `collect_selectors`, `get_page_object`, `verify_selectors`, `read_page`, `capture_page`, `capture_element`, `capture_matrix`, `get_diagnostics`, `watch_page`, `get_design_tokens`, `measure_accessibility`, `inspect_element`, `list_tabs`.

Move the camera, without changing the page contents: `scroll_to`, `set_viewport`, `set_color_scheme`, `hover`, `focus_element`.

Ask before acting: `propose_action` waits for you to approve a click or a keystroke. `await_user_selection` lets you click the element you mean.

Prompts the server ships: `/write-test`, `/file-bug`, `/audit-accessibility`, `/extract-design-system`.

## Limit

If the AI client uses a cloud model, the page content you asked it to look at can reach that model. Leave Connect to AI off and nothing about OmniSnap changes. Check the setup with `npx omnisnap-mcp --doctor`.

HTML guide: https://omnisnap.metago.in/mcp.html