Oculo MCP server
io.github.xidik12/oculo·v0.4.1·5 starsAI-powered native browser with 12 MCP tools. ~30 tokens per page.
5 stars
Reviews
Write oneNobody has reviewed Oculo yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Oculo tools (16, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
abortwrite actionCancel a pending tool call by callId, or pass callId="all" to cancel everything.
actPerform an action in Oculo browser: click, navigate, scroll, press key, hover, type, login. Elements found by ref (from a11y snapshot), text, role, label, placeholder, or CSS selector. After click/navigate/back/forward/reload, returns fresh ref-tagged snapshot. Use newTab with background=true to open tabs without switching, then use tabId to run actions in parallel.
fillFill form fields in Oculo browser by label, placeholder, or data-placeholder text. Handles text, select, checkbox, textarea, and contenteditable (DraftJS, ProseMirror). Use visible labels as keys.
lensVisual analysis of the current page via screenshot. Describe what you see or answer questions about the page visually.
mediaGenerate images (Nano Banana 2 / DALL-E 3) or videos (Veo 3.1) via Oculo. Returns saved file path. Supports image-to-image editing with reference image.
pageDescribe the current page in Oculo browser. Default: compact (~30-80 tokens). Use detail="a11y" for ref-tagged accessibility tree — interactive elements get [ref=e1],[ref=e2]... refs usable in act tool. Use detail="markdown" for full article content as clean markdown.
previewPre-fetch a URL without navigating. Returns page description without leaving current page.
readExtract structured data from the page in Oculo browser (search results, tables, lists, articles).
researchDeep web research on a topic. Opens multiple tabs, reads pages, synthesizes findings.
runwrite actionPREFERRED for any task with 2+ actions. Executes a multi-step pipeline in a SINGLE call — use this instead of multiple act/fill calls. Example — post on X: run({steps:[{act:{action:"navigate",url:"https://x.com/compose/post"}},{wait:{timeout:2000}},{act:{action:"type",text:"Hello world",role:"textbox"}},{act:{action:"click",text:"Post",role:"button"}}]}). Each step is an object with exactly ONE ke
shellwrite actionExecute a shell command (ls, npm, git, node, python, etc.) via Oculo and return stdout+stderr. Non-interactive only.
statusList all pending tool calls with their callId, toolName, and elapsed time.
tabsList all open browser tabs with their URLs and titles.
translateTranslate page content or specific text to another language.
webmcp_callCall a WebMCP tool registered by the current page. Use webmcp_list first to discover available tools.
webmcp_listDiscover WebMCP tools registered by the current page via navigator.modelContext.registerTool() or <form toolname="..."> elements. Returns list of available page-declared tools.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 70 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Oculo compares
Against every graded Scraping and browsing MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 70% of 866 Scraping and browsing servers
- Tools
- 16
- the typical Scraping and browsing server has 6
- Tools that change things
- 19%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 5
- more than 73% of 583 Scraping and browsing servers
What its tools let an agent do: 13 read · 1 change · 2 run or deploy
Install Oculo in Claude Code, Cursor or VS Code
Runs npx -y oculo-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add oculo -- npx -y oculo-mcp
What the publisher says
From the Oculo repository's README, as published. We do not edit it. Read it on GitHub
Website · Download · Quick Start · MCP Tools · Architecture · Contributing
Oculo is a full-Chromium desktop browser that speaks the Model Context Protocol. Point Claude Code, Cursor, Windsurf, or any MCP client at it and your agent can see and drive real web pages — read the DOM, click, fill forms, extract data, run multi-step pipelines — through 12 compact tools that answer in under 300 tokens per flow.
Cursor : VSCode :: Oculo : Chrome
See it in action
Your agent describes intent; Oculo resolves it into a few tiny tool calls and hands back terse, redacted results — not megabytes of screenshots.
You: "Log into GitHub and star the oculo repo"
Claude Code calls:
1. act({action: "navigate", url: "https://github.com/login"})
2. act({action: "login", site: "github.com"}) # vault lookup, password never leaves the OS keychain
3. act({action: "navigate", url: "https://github.com/xidik12/oculo"})
4. act({action: "click", text: "Star"})
→ 4 tool calls, <100 tokens of responseYou: "Fill out the contact form on example.com"
Claude Code calls:
1. act({action: "navigate", url: "https://example.com/contact"})
2. page() # see the form structure
3. fill({fields: {"Name": "...", "Email": "..."}, submit: true})
→ 3 tool callsOculo runs a real Chromium engine on your machine and adds an agent-first control layer on top. That combination is the point:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Oculo: common questions
- Is Oculo MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Oculo safety report
- How do I install Oculo?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Oculo need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Oculo maintained?
- The last commit was 107 days ago (2026-07-20). The latest release is v0.4.1.
- What can I use instead of Oculo?
- Servers from other publishers that do the same job: unbrowser by Unchained MCP server, AIHawk MCP server and Unbrowse MCP server.
- How does Oculo compare with other Scraping and browsing MCP servers?
- safety score 88/100 (higher than 70% of 866 Scraping and browsing servers); tools 16 (the typical Scraping and browsing server has 6); tools that change things 19% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Oculo
Same job from other publishers: the closest match first, then the best rated.
- unbrowser by UnchainedChrome-free MCP web access for agents with low-token page maps and browser escalation hints.not reviewedGrowingB
- AIHawkAI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions.not reviewedWidely usedA
- UnbrowseWebsites as APIs: read pages, run site tasks via learned APIs, cloud browser with saved logins.not reviewedEstablishedA
- SafariNative Safari browser automation for AI agents — 98 tools, zero Chrome overhead.not reviewedEstablishedC
- FortressStealth browser for AI agents: fetch pages behind Cloudflare/DataDome/CAPTCHA, extract clean data.not reviewedEstablishedB