Pinpoint MCP server

Pinpoint

Click an element on your local dev site, write what should change, and your coding agent gets it — with the selector, DOM path, computed styles, React/Vue component chain, source-file hint and a cropped screenshot. No screenshot files piling up in your Downloads folder, no describing "the third button on the left". Building a native app? The same works on the iOS Simulator.

It is not only for styling. Say what the thing should do — "disable this until the form is valid", "this should save the draft before closing", "show the error the API returned here" — and the agent is told to treat the element as where to start, then follow it into the handlers, state, API calls and backend behind it. More below.

Browser (extension) ──POST──▶ pinpoint bridge (127.0.0.1:7331) ──MCP / hooks──▶ Claude Code, Cursor, Codex…
        pins ◀──live events───┘   ~/.pinpoint/annotations.json   └── <repo>/.pinpoint/pending.md (optional)
iOS Simulator ─▶ 127.0.0.1:7331/ios ─┘  (screenshot + accessibility tree instead of the DOM)

Click an element, say what should change, your agent gets it. (full-speed video)

It is not a browser-driving agent

The distinction matters, because the two get filed together and they are opposites:

clicks and asserts. Good for testing and for browsing on your behalf.

• Playwright MCP, agent-browser, computer-use put the agent in the driver's seat — it navigates,

context to edit code with: a selector, the styles, the component chain, a source-file hint, a crop of the element. It never touches the page itself.

• Pinpoint keeps you in it. You click, you say what should change, and the agent gets structured

you meant, what it is called, and where it lives in the tree.

• A pasted screenshot carries none of that. The agent gets pixels and has to guess which control

So it composes with browser automation rather than competing: point at the thing, let the agent change it, let your tests drive the browser.

Quick start

You need Node 18+ and a Chromium browser (Chrome, Edge, Brave, Arc, Opera, Vivaldi).

git clone https://github.com/gowtham012/pinpoint
node pinpoint/bridge/cli.js setup

That is the install. setup installs its own dependencies first, then asks — every question has a default, so Enter all the way through is a working setup:

Shortened. The full README is on GitHub.