
Wigolo MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and other assistants search the web, read pages, crawl sites and research questions from your own computer, with no API key.
Wigolo is a web layer that runs on your computer. Your assistant calls it to search many search engines, read pages as clean text, crawl docs sites and run multi-step research. It saves what it reads in a local cache, so asking again is instant. Search, reading and crawling need no account or key.
It is a community project in public beta, not from a search company. Setup downloads about 1.5 GB (a browser engine and on-device models) and needs Node 22 or newer. The research and agent tools write a finished answer only if you add an LLM key or a local model. Without one they return the gathered material for your assistant to write up.
Good for
- Developers who want free web search and page reading in Claude Code or Cursor
- Researchers who want cited answers with the source text pinned to each claim
- Teams who do not want queries sent to a paid search service
- Anyone who wants to watch pages for changes
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install wigolo MCP
Claude Code
- 1
Copy this prompt.
Add the wigolo MCP server to Claude Code. Run this command: claude mcp add wigolo -- npx -y wigolo Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Built from the package data we hold. Not yet tested by us.
Tools
Search the web and get cited evidence
Searches many engines at once, ranks the results on your computer, and returns scored excerpts with citation IDs. You can pass several queries together and limit by site or date.
Try: “Search the Rust docs and blog for how async functions in traits work.”
Network ·
searchRead one page as clean markdown
Loads a web page as markdown, moving up to a real browser when the page needs JavaScript or blocks plain requests. It can also click and type on the page before reading it.
Try: “Fetch the Data Cache section of the Next.js caching docs.”
Write ·
fetchCrawl many pages into the local cache
Follows links or a sitemap from a start page, respecting robots.txt, and saves the pages in the local cache. A map mode lists the URLs without their content.
Try: “Crawl the Astro docs guides from the sitemap, up to 40 pages.”
Files ·
crawlPull tables and structured data from a page
Pulls tables, metadata, JSON-LD, brand details or fields matching a schema you give out of a page. Most modes need no LLM.
Try: “Extract every table from the PostgreSQL versioning page.”
Network ·
extractSearch, check or clear what it already saw
Searches pages wigolo already saved, shows cache totals, checks saved pages for changes, and can delete matching entries.
Try: “How many pages have you cached, and are any of the Node.js release pages changed?”
Delete ·
cacheFind pages similar to a URL or topic
Finds pages like a URL or a described topic by combining the local cache with live web search. It works best after a crawl.
Try: “Find pages similar to 12factor.net/config.”
Network ·
find_similarAnswer a question from many sources
Splits a question into sub-queries, searches and cross-checks the sources, and returns a structured brief with per-claim sources and gaps. With no LLM set, it returns the brief for your assistant to write up.
Try: “How do Deno and Bun differ in Node.js compatibility?”
Network ·
researchGather data on its own within a time budget
Plans searches and URLs from your prompt, fetches pages in parallel, optionally extracts fields you define, and logs every step. It stops at a page and time limit.
Try: “Gather the current LTS support windows for Node.js releases as JSON.”
Network ·
agentCompare two versions of a page or text
Compares a live page with its cached copy, two URLs, or two pieces of markdown, and returns a patch, a section list or a count of changes.
Try: “What changed on the Node.js previous-releases page since last time?”
Network ·
diffWatch pages for changes
Registers jobs that re-check pages on an interval and report changes inline or to a webhook address. Jobs only run while a wigolo session or server is active.
Try: “Watch the Go release page every hour and tell me when it changes.”
Delete ·
watch
From the official docs
Permissions
medium risk · 5 things to watch
Medium risk
The assistant can open any public web address, run browser clicks and typing on a page, and read your saved login if you let it. Keep the login option off by default and check where you point it.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
The browser can click and type on pages
The fetch tool accepts click and type steps, and the source marks it as able to change things on the page. Do not point it at sites where you are signed in unless you mean to. github.com
It can use your saved browser login
With the use_auth option, fetch and crawl use your stored browser session. Leave it off unless you need a logged-in page. github.com
It can delete its own cache and watch jobs
The cache tool can delete saved pages that match a filter, and the watch tool can delete its own jobs. Both only touch wigolo's local store. github.com
Watch jobs can call a webhook
The watch tool can send change reports to a URL you provide. Private and loopback addresses are refused. github.com
Its HTTP server needs a token off localhost
The optional serve mode is open only on 127.0.0.1. Bound to any other address it refuses to start without a token. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. |
|---|---|
| Talks to | Public websites you or the assistant ask it to open. Search engines it queries directly. The LLM provider you choose, only if you set one for research or agent synthesis. A webhook address, if you give one to the watch tool |
| Sign-in and keys | No account is needed. The cache, models and config live under ~/.wigolo/ on your machine. An optional LLM key goes in your shell or your assistant's env settings. |
Questions
Does Wigolo need an API key?
No. Search, fetch, crawl, extract and cache work without any key. A key (Gemini, Anthropic, OpenAI or Groq) or a local Ollama model is optional and only improves the written answers from research, agent and search with answer format.
Is it free?
Yes. It is open source under AGPL-3.0, runs on your machine, and has no per-query fee. An LLM provider you add yourself may charge.
What does setup need?
Node 22 or newer and about 1.5 GB of disk for the browser engine and on-device models. Running the init command from the README downloads them ahead of time. Otherwise they download on first use.
Does my search data leave my computer?
Searches go to public search engines and pages are fetched from the sites themselves. The cache, models and config stay under ~/.wigolo/. Your text is sent to an LLM provider only if you set one for synthesis.
Can it read pages behind a login?
Yes, if you turn on the use_auth option, which uses your stored browser session. It is off by default.
Can it run in Docker?
Yes. The project publishes an image, ghcr.io/knockoutez/wigolo, plus a larger -full tag with the browser preloaded. Use it as the command in your MCP config, as the installation guide shows.
Is it good at sites that block bots?
It steps up to a real browser when a plain request is blocked. If a challenge cannot be cleared it reports a blocked_by_challenge failure instead of returning junk. The README notes that datacenter IP addresses can fail walls a home connection passes.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
wigolo- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 0.2.1
- License
- AGPL-3.0-only
- Last commit
- Oct 31, 2026
- Open issues
- 15
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 4Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com