wigolo — Claude Code MCP server: web tools without API keys
A local MCP server that hands your coding agent web search, page fetching, crawling and a cache. The core tools run without API keys.
claude mcp add wigolo -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y wigoloWhat wigolo does
wigolo sits next to your coding agent and exposes one set of web tools: search, fetch, crawl, extract, cache, find-similar, research and autonomous gather loops. The core runs keyless, keeps its data under ~/.wigolo/, and nothing leaves your machine.
Setup starts with npx wigolo init, which pulls down the browser engine and on-device models, then runs a health check and reports on each part. Pass --agents=claude-code,cursor to have the MCP config written for those agents in the same run. You need Node ≥ 20 and roughly 1.5 GB of free disk space. Add --no-warmup if you would rather defer the downloads until first use.
research, agent and search format=answer call an LLM to write a cited answer. Without one they return a raw brief your agent has to assemble itself. A free Gemini key goes in via WIGOLO_LLM_PROVIDER=gemini and GEMINI_API_KEY; other providers work too, and WIGOLO_LLM_PROVIDER=ollama keeps everything local. Run npx wigolo doctor to check health, or npx wigolo config --uninstall --yes to remove it.
What it helps with
- pull current facts off the web from inside the agent
- fetch a page and lift one section out of it
- walk a docs site and collect every auth detail
- cache results so repeat lookups skip the network
- surface sources similar to one you already have
Example prompts for the agent
- Search the web for how this flag is configured now and give me the links
- Fetch that page and pull out the parameters table
- Crawl the docs site and gather everything about authentication
How to install wigolo
Platform CLI
claude mcp add wigolo -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y wigoloReplace <…> with your own values
Platform CLI
codex mcp add wigolo --env YOUR_API_KEY=<YOUR_API_KEY> -- npx -y wigoloReplace <…> with your own values
Config file
{
"mcpServers": {
"wigolo": {
"command": "npx",
"args": [
"-y",
"wigolo"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"wigolo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wigolo"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e YOUR_API_KEY=<YOUR_API_KEY> wigolo npx -y wigoloReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about wigolo
How do I install wigolo in Claude Code?
Run npx wigolo init first, then claude mcp add wigolo -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y wigolo. The equivalent form is claude mcp add --env YOUR_API_KEY=<YOUR_API_KEY> --transport stdio wigolo -- npx -y wigolo.
What does wigolo do?
It gives an agent web tools: search, fetch, crawl, extract, cache, find-similar and research loops. The core tools need no API key.
Do I need an API key for wigolo?
No for search, fetch, crawl, extract, cache and find-similar. A key is only needed by research, agent and search format=answer, which use an LLM to write the answer.
