search-rotation MCP server
io.github.localfoundry/search-rotation·v0.4.10MCP server for web search and page extraction across the free tiers of several providers
0 stars
Reviews
Write oneNobody has reviewed search-rotation yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
search-rotation tools (4)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
engine_statusRead engine configuration, per-capability authentication requirements, local usage and quota sources. This is not a live health check. Historical errors do not prove a current failure; disabled engines are not necessarily missing credentials.
fetch_urlFetch a web page and return its content as markdown. Rotates across extraction providers (Jina Reader, Firecrawl, Parallel, Tavily, Exa) with failover.
open_dashboardOpen the local dashboard (API keys, engine order and toggles, quota view) in a web browser. Use when the user wants to configure engines or check quota.
web_searchWeb search with automatic round-robin across multiple free search APIs (Tavily, Firecrawl, Parallel, Exa, Google PSE, DuckDuckGo) including transparent failover. Returns numbered results with title, URL, snippet and publication date when available. Time filters restrict rotation and failover to compatible providers; never silently dropped.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan30 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 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How search-rotation compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 3,470 Web search servers
- Tools
- 4
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
What its tools let an agent do: 3 read · 1 create
Install search-rotation in Claude Code, Cursor or VS Code
Runs npx -y search-rotation on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add search-rotation -- npx -y search-rotation
What the publisher says
From the search-rotation repository's README, as published. We do not edit it. Read it on GitHub
One MCP server for web search and page extraction across multiple providers.
Built by Robin Bially under the LocalFoundry label.
Rotate across available quotas, automatically fail over when a provider is unavailable, and return consistent results to your AI assistant. A local dashboard lets you manage API keys, reorder engines, check quotas, and inspect request history.
Actual dashboard UI, shown in English with illustrative demo data. Calls and provider budgets are displayed separately; activity bars offer time-window and per-engine details.
Quick start
npm
npx -y search-rotation --http --openRequires Node.js 20.3+. For MCP over stdio, configure your client to run npx -y search-rotation with no arguments. The server is also listed in the official MCP Registry as io.github.localfoundry/search-rotation.
Homebrew
brew install localfoundry/tap/search-rotation
search-rotation --http --openHomebrew installs the required Node.js runtime. For MCP over stdio, configure your client to run search-rotation with no arguments. See the LocalFoundry tap for upgrades and details.
Pinned release from GitHub
npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.10Use this when you want a fixed version instead of the current npm release.
Add your provider keys in the dashboard, then connect your assistant using the MCP client setup guide for Codex, Claude, Cursor, or OpenCode.
What you get
- Search and fetch: independent rotation for web search and Markdown page extraction.
- Automatic failover: quota-aware ordering, rate-limit cooldowns, and request timeouts.
- Local dashboard: API keys, drag-and-drop engine order, per-engine calls and errors, separate quota balances, and interactive request history.
- Local or remote: MCP over stdio or authenticated Streamable HTTP.
Providers: Tavily · Firecrawl · Parallel · Exa · Google PSE · Jina Reader · DuckDuckGo HTML. Keyless access and quota accounting vary by provider.
MCP tools
websearch · fetchurl · enginestatus · opendashboard
The dashboard's MCP Tools tab explains each tool, its parameters, and copyable example calls.
Actual dashboard UI, shown in English.
Search time filters
web_search accepts the following arguments:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
search-rotation: common questions
- Is search-rotation MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the search-rotation safety report
- How do I install search-rotation?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does search-rotation need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is search-rotation maintained?
- The last commit was 39 days ago (2026-09-26). The latest release is v0.4.10.
- What can I use instead of search-rotation?
- Servers from other publishers that do the same job: Free Search MCP server, Exa Search MCP server and webclaw MCP server.
- How does search-rotation compare with other Web search MCP servers?
- safety score 92/100 (higher than 90% of 3,470 Web search servers); tools 4 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to search-rotation
Same job from other publishers: the closest match first, then the best rated.
Free SearchNo-API-key web search, page fetching and document reading across many engines. Local-first.not reviewedEstablishedB- Exa SearchSearch the live web and fetch clean content from source pages.not reviewedEstablishedA
- webclawWeb scraping, search, crawling, structured extraction and research for AI agents.not reviewedEstablishedA
Search1APIWeb search, agentic search, news, page retrieval, sitemaps, and trending topics through Search1API.not reviewedEstablishedA- FrankenSurfRead any web page and search the web: 28 tools, cheapest first, every page checked.not reviewedEstablishedA