MCP Searxng MCP Server

MCP server for SearXNG integration

Remote serverstreamable-http

What is the MCP Searxng MCP server?

Mcp searxng mcp server connects MCP Searxng to AI assistants that speak the Model Context Protocol. MCP server for SearXNG integration.

What MCP Searxng does

An MCP server that integrates the SearXNG API, giving AI assistants web search capabilities.

Key capabilities

  • Instance Failover & Fan-out — Configure interchangeable SearXNG replicas in SEARXNG_URL; searches fail over in order by default, or query all healthy replicas in parallel and merge results with SEARXNG_FANOUT
  • Direct Answers & Metadata — Text results surface SearXNG answers, corrections, suggestions, and infoboxes before the result list
  • Search Suggestions — Query autocomplete via SearXNG's /autocompleter endpoint
  • Instance Capability Discovery — Inspect configured categories, engines, defaults, locales, and plugins from /config
  • URL Content Reading — Content-type-aware Markdown conversion, including bounded PDF text extraction, with pagination, section filtering, paragraph ranges, and heading extraction
  • Intelligent Caching — Both search results and URL content are cached in memory with configurable TTL and least-frequently-used (LFU) eviction, reducing redundant requests
  • SSRF Protection — web_url_read blocks private/internal URLs and redirects by default in all transport modes
  • HTTP Transport — Optional Streamable HTTP mode with opt-in hardening, rate limiting, and bounded stateless compatibility for serverless or horizontally scaled deployments

Tools it exposes

Once connected, the assistant can call these 5 tools directly:

  • searxng_web_search — Execute web searches with pagination
  • Inputs — - query (string): The search query. This string is passed to external search services
  • searxng_search_suggestions — Get autocomplete suggestions for refining search queries
  • searxng_instance_info — Discover categories aggregated from reachable configured SearXNG instances, optionally include engine names, and inspect defaults, locales, and plugins from
  • web_url_read — Read URL content as markdown with content-type-aware handling and advanced extraction options

Installing the mcp searxng mcp server

The server is distributed via npm as mcp-searxng, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

Before the server will start you need to supply 6 environment variables: SEARXNG_URL, SEARXNG_HTML_FALLBACK, YOUR_SEARXNG_INSTANCE_URL, FLARESOLVERR_URL, BYPARR_URL, MCP_HTTP_HOST. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Knowledge and memory servers address the most frustrating trait of language models — walking into every conversation with no recollection of the last one. MCP Searxng sits in that group, and the shape of its toolset — searxng_web_search, Inputs, searxng_search_suggestions among others — tells you what it is really for. Worth comparing against the other knowledge memory servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This is a hosted server — you point your client at an endpoint rather than running a local process, so there is nothing to keep updated on your machine.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by ihor-sokoliuk.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the mcp searxng mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
searxng_web_searchExecute web searches with pagination
Inputs- query (string): The search query. This string is passed to external search services.
searxng_search_suggestionsGet autocomplete suggestions for refining search queries
searxng_instance_infoDiscover categories aggregated from reachable configured SearXNG instances, optionally include engine names, and inspect defaults, locales, and plugins from the primary reachable instance. Categories—and engines when req
web_url_readRead URL content as markdown with content-type-aware handling and advanced extraction options

How to install the MCP Searxng MCP server

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SEARXNG_URLEndpoint or connection string the server talks to.Yes
SEARXNG_HTML_FALLBACKConfiguration value read at startup.Optional
YOUR_SEARXNG_INSTANCE_URLEndpoint or connection string the server talks to.Yes
FLARESOLVERR_URLEndpoint or connection string the server talks to.Yes
BYPARR_URLEndpoint or connection string the server talks to.Yes
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • Use MCP Searxng to searxng web search.
  • Use MCP Searxng to Inputs.
  • Use MCP Searxng to searxng search suggestions.

Frequently asked questions

It connects MCP Searxng to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (searxng_web_search, Inputs, searxng_search_suggestions, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Searxng directly.