Perfect
Tabs
browser_status · browser_tabs · browser_navigate · browser_back · browser_forward · browser_tab_focus · browser_tab_close
The bind
Cursor is brilliant in the repo. The browser was the missing limb.
Out of the box, Cursor doesn’t give you trustworthy hands in the Chrome you already live in — cookies, SSO, the messy real web. Stock agent browser paths often lean on broad Mac automation permissions, then hog the machine while the run is live. Hard to ship real R&D when your desk is held hostage.
Perfect is the bridge I needed: local MCP, your real Chrome, a green Perfect tab group you can see, Manual approvals by default, and a Stop that actually stops.
Without Perfect
- No native Cursor ↔ Chrome MCP path for your logged-in session
- OS-level automation that fights you for the desktop
- Guessing whether the agent is safe on checkout or Buy now
With Perfect
- Local token bridge · Linked in the side panel
- Agent work stays in a visible Perfect tab group
- Manual / Auto / Skip with prohibited actions hard-blocked
Try a prompt
Paste once. Watch the chain.
Perfect doesn’t invent a special search API. Agents chain real tools — navigate, wait, snapshot, press — on sites you approve.
Product walkthrough
See the instrument, not the pitch deck.
Welcome on first install. Linked when the bridge is live. Agent tabs grouped so you keep ownership of the desk.
Read
browser_snapshot · browser_extract · browser_console · browser_network · browser_wait
Act
browser_click · browser_hover · browser_drag · browser_fill · browser_type · browser_select · browser_upload · browser_press · browser_scroll · browser_handle_dialog
See
browser_screenshot — annotations, fullPage, clip
Guarded
browser_evaluate · browser_propose_plan · browser_stop
Safety defaults
Manual mode · protected pauses · Buy now / checkout prohibited · local token · no Perfect cloud
How to connect
About two minutes to Linked.
-
Install Perfect
Easiest: Add to Chrome from the Chrome Web Store. Or download the zip, unzip, then Load unpacked from
chrome://extensions. -
Copy the setup prompt
Open Perfect → Copy setup prompt for Cursor. It merges only the
perfectMCP entry (npx -y perfect-mcp, GitHub fallback if needed). -
Enable in Cursor
Settings → Tools & MCP → enable perfect (toggle off/on if it was already on). Node.js 20+ required.
-
Confirm Linked
Side panel shows Linked to Cursor. Agent tabs appear in the green Perfect group. Reconnect pings without tearing down a live bridge.
Then you’re Linked
Agent tabs stay in the green Perfect group — you keep the desk while the bridge runs locally.
Permission & safety
You stay in the loop.
Modeled on Claude-for-Chrome-style gates. Default is Manual. Skip is dangerous — prohibited actions still hard-block.
- Manual
- Ask before acting. Safest default for live R&D.
- Auto
- Fewer prompts on trusted sites; protected and new hosts still pause.
- Skip
- Dangerous. Checkout / Buy now / Pay now stay prohibited.
Stop in the side panel or on-page HUD cancels work and detaches the debugger.
The debugger permission is only for local Chrome DevTools Protocol automation — not remote control by a Perfect server.
Honest limitations
Useful without overclaiming.
-
Heavy SPAs can be flaky to snapshot
YouTube and similar sites may need navigate + wait + screenshot + keyboard (
k) instead of a perfect accessibility tree. -
No dedicated browser_search API
Search is navigate + fill + click like a person. That’s intentional.
-
Chrome MV3 + Node locally
You need Node.js 20+ for the MCP server via npx. Extension alone is not enough.
-
Chrome Web Store + GitHub zip
Install from the Chrome Web Store or load the GitHub zip unpacked. You still need Node.js 20+ for the local MCP server.
Privacy by default
No Perfect cloud in v0.2.
On your machine
Bridge token, permission preferences, welcome-seen flag, local audit log.
To your MCP client
Snapshots and page text flow only over the local MCP connection you configure. That client’s policy applies next.
Never by Perfect
No Perfect analytics SDK. No sale of personal data. Full policy on the privacy page.
Download
Free forever. Add to Chrome — or load the zip.
- Install from the Chrome Web Store (recommended).
- Or download
perfect-extension.zipfrom GitHub Releases → Load unpacked. - Open Perfect → Copy setup prompt → paste in Cursor → enable perfect → Linked.
- Node.js 20+ required locally for the MCP server.
Why I built this
I needed hands in Chrome without surrendering the Mac.
I use Cursor every day. The moment the work left the repo — live forms, WPBakery builders, real research tabs, media checks — I hit the same wall: there was no clean, local, permissioned bridge into the browser I already trust.
The alternatives asked for heavy OS permissions, then made the machine feel occupied while the agent ran. That’s fine for a demo. It’s terrible for shipping.
So I built Perfect: MCP on localhost, a token you own, a side panel that says Linked, a green tab group you can see, Manual by default, Stop when you need it. Free, open source, unofficial — because the gap was real.
What I needed
Same cookies. Same session. Visible agent tabs. Approvals I control. No Perfect cloud watching.
Who it’s for
Anyone doing live R&D with Cursor — marketers, builders, researchers — who wants real execution in Chrome without losing the desk.
About the maker
Gobinda Tarafdar
WordPress product marketer · stubborn problem-solver · lifelong Harry Potter devotee
By day I am the Product Marketing Specialist at WPBakery. Before that, I helped a single plugin cross 400,000+ active users. When the day-job owl flies home, I tinker on my own workshop of spells.
Also from the workshop
Other tools from the same bench.
Free, local-first where it counts.
- Last Sign-in Remembers how you signed in — never passwords or cookies
- Porter Copy folders between your Macs like Finder · MCP for AI IDEs
- Aligner Free local Chrome toolkit for design, measure, and WordPress
- FinderFlow Mac file manager with built-in editor
- Slack Agent Bridge MCP bridge for Cursor and Claude
- Auto AFK Slack Lock your Mac, Slack goes AFK
- Slack Teammate Time Teammate local times inline in Slack
- Broken Link Checker Find broken links without leaving the page
- Docscriber Documentation, conjured
- TheRecaller A memory charm for what you forget online
- TheEditra AI video editor
- The Quill Press Tech news, Daily Prophet style
- Costlas Cost of living for 140+ countries
FAQ
Straight answers.
Is Perfect affiliated with Cursor?
No. Unofficial open source — not affiliated with Cursor, Anysphere, Google, or Anthropic.
Does Perfect upload my browsing to a cloud?
No Perfect cloud in v0.2. Token and preferences stay local. Tool results go only to your configured MCP client.
What do I need besides the extension?
Node.js 20+ so Cursor can run npx -y perfect-mcp (GitHub fallback if the npm package isn’t published yet).
Is the Chrome Web Store listing live?
Yes — Add Perfect from the Chrome Web Store. GitHub Releases zip remains available for Load unpacked / contributors.
License?
MIT. Free to use, fork, and share.
Support
Questions, bugs, or store review notes.
Share this page: gtarafdar.github.io/perfect/#support