PlugWiki
wigolo logo

Wigolo MCP Server: Setup for Claude, Cursor and Other Apps

CommunityLocal

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.

Install wigolo MCP

Claude Code

  1. 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. 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 · search

  • Read 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 · fetch

  • Crawl 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 · crawl

  • Pull 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 · extract

  • Search, 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 · cache

  • Find 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_similar

  • Answer 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 · research

  • Gather 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 · agent

  • Compare 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 · diff

  • Watch 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-onlyNo read-only switch is documented.
Talks toPublic 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 keysNo 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

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.