Free Search
Keyless web search, page fetching and document reading that runs locally
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.18.2
- Listing updated
- 2 days ago
About Free Search
Free Search is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.
The headline tool is research(): one call searches several engines, fetches the top pages and returns a Markdown brief with sources and token estimate. Results from a default pool of keyless engines (DuckDuckGo, Bing, Yahoo! JAPAN and AnySearch) are merged with reciprocal rank fusion and de-duplicated, and extra engines join when a query is recent or written in Chinese or Korean.
Filters cover freshness, include and exclude domains, text matches and a category argument that routes to sources for papers, filings, packages or CVEs. Engines that return a CAPTCHA or login wall are benched and replaced. A local FTS5 cache lets cache_search find pages fetched earlier, and read_doc parses PDF, DOCX, XLSX, PPTX, EPUB and archives with pagination.
There is a Claude Code and Codex plugin that adds a verified-research skill, plus a proxy setting for engines that block your network. Browser-rendered engines need Chromium installed once.
Install
Run in a terminal
claude mcp add free-search-mcp --env SEARCH_MCP_PROXY='<SEARCH_MCP_PROXY>' -- uvx free-search-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp"
],
"env": {
"SEARCH_MCP_PROXY": "<SEARCH_MCP_PROXY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp"
],
"env": {
"SEARCH_MCP_PROXY": "<SEARCH_MCP_PROXY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"free-search-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"free-search-mcp"
],
"env": {
"SEARCH_MCP_PROXY": "<SEARCH_MCP_PROXY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp"
],
"env": {
"SEARCH_MCP_PROXY": "<SEARCH_MCP_PROXY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"free-search-mcp": {
"command": "uvx",
"args": [
"free-search-mcp"
],
"env": {
"SEARCH_MCP_PROXY": "<SEARCH_MCP_PROXY>"
}
}
}
}Configuration
SEARCH_MCP_PROXYOptional outbound proxy URL (http://, https:// or socks5://) for engines that block your network.SEARCH_MCP_REGIONOptional default region-language for results, e.g. us-en, uk-en, cn-zh. Default: us-en.SEARCH_MCP_CACHE_DIROptional directory for the local search/page cache. Default: ~/.cache/search-mcp.
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- search
- Parallel multi-engine search, rank-merged and de-duplicated, with optional filters.
- research
- Searches, fetches the top pages and returns a Markdown brief.
- paper_graph
- Walks one paper's citation graph and retraction notices.
- compare
- Fetches 2 to 5 URLs and returns side-by-side excerpts keyed by a question.
- fetch
- Fetches a page or file as Markdown, parsed text or a description.
- fetch_batch
- Fetches up to 20 URLs concurrently.
- read_doc
- Parses PDF, DOCX, XLSX, PPTX, EPUB, CSV, code and archives with pagination.
- extract_structured
- Pulls JSON-LD, OpenGraph, Twitter cards and microdata.
- cache_search
- Full-text search across previously fetched pages.
- engines
- Lists the search sources grouped by type.
- download
- Saves a file to the cache downloads folder.
What it does
- One-call research
- Search, fetch and summarize into a Markdown brief with sources.
- Multi-engine merge
- Parallel keyless engines combined by rank fusion and de-duplicated.
- Document reading
- Parses PDFs, Office files, EPUB, CSV and archives with pagination.
- Category routing
- Routes queries to paper, finance, news, software or security sources.
- Local page cache
- Full-text search over pages already fetched.
- Citation graph
- paper_graph walks references, citing works and retraction notices.
Good for
- Research a question without signing up for a search API
- Compare two to five pages side by side
- Read a long PDF in pieces
- Trace a paper's citations and corrections
- Search archived pages from an earlier session
Pricing
Open source
Free; no API key required
Free Search FAQ
Does it need an API key?
No. The README says it needs no search API key; an optional proxy and region can be set by environment variable.
How do I install it?
Through the Claude Code or Codex plugin, or as the free-search-mcp package from PyPI run with uv.
Where are downloads stored?
In a downloads folder under the cache directory, deleted automatically after 24 hours.
Is Chromium required?
Only for browser-rendered engines and JavaScript-heavy pages; other features work without it.
Is Free Search free?
Yes. Free Search is open source, so you can use and self-host it for free.
How do I add Free Search to Claude Code?
Run this command in your terminal: claude mcp add free-search-mcp --env SEARCH_MCP_PROXY='<SEARCH_MCP_PROXY>' -- uvx free-search-mcp
What are the best alternatives to Free Search?
The closest alternatives to Free Search are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.
Alternatives to Free Search

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

SearXNG Search
MCP serverMCP server for web search and page reading through a SearXNG instance
Runs locally- 3 tools
- Open source
- 1.4K GitHub stars
- Web search and scraping

NeuralVerge
MCP serverStructured, source-tagged business and people data from 300+ sources for agents
- 200 tools
- Remote
- Free trial
- 1 GitHub star
- Web search and scraping

AI-Powered directory
MCP serverSearch AI tools, agents and MCP servers and get install configs from inside your AI assistant.
- 4 tools
- Remote
- Free
- Developer tools

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce