Skip to content
MCP server

Free Search

Keyless web search, page fetching and document reading that runs locally

Runs locallyStatus and history
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-mcp

Add 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

  1. MCP 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
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP 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
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce