MCP SearXNG logo

MCP SearXNG

by Ihor-Sokoliuk

Searches through SearXNG, suggests queries, inspects instance capabilities, and reads web pages and PDFs as Markdown.

Install MCP SearXNG

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ihor-sokoliuk-mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Ihor-Sokoliuk/MCP-SearXNG MCP server connects MCP clients to an operator-controlled or trusted SearXNG instance for web search and result extraction. Its tools cover paginated searches, autocomplete suggestions, SearXNG capability discovery, and readable content retrieval from URLs. It runs locally over STDIO or as a Streamable HTTP service, with npm, npx, and Docker distribution options. Reach for it when an agent needs configurable search, source reading, and control over the underlying SearXNG deployment.

Use cases

  • Search the web through a self-hosted SearXNG deployment
  • Refine incomplete queries with autocomplete suggestions
  • Inspect search-engine and category availability
  • Read full pages or selected sections from search results
  • Extract bounded text from PDF documents

Key features

  • Paginated SearXNG web search
  • Query autocomplete suggestions
  • Instance capability discovery
  • HTML, JSON, structured-text, and PDF reading
  • STDIO and Streamable HTTP transports
  • Optional replica and browser-solver support

Tools4

What MCP SearXNG lets your agent do. Expand a tool for its parameters.

Verified live~1.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

39/39 checks healthy over the last 91d

Supply-chain signal

2 high-severity advisories on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 0High 2Medium 3Low 0

Scanned 6d ago via OSV.dev · mcp-searxng (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1.4kStargazers on the source repository.
npm downloads51kPackage downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP SearXNG works

What Ihor-Sokoliuk/MCP-SearXNG does

Ihor-Sokoliuk/MCP-SearXNG exposes SearXNG search and web-reading functions through the Model Context Protocol. It requires an existing SearXNG instance with JSON search enabled; it connects to that service rather than installing or hosting SearXNG automatically.

The search workflow can begin with query suggestions, continue with a filtered and paginated web search, and then fetch the full content of selected result URLs. The URL reader returns HTML as Markdown and presents JSON in formatted form. Plain text, YAML, TOML, and XML are returned as readable fenced text, while PDF text can be extracted within bounded processing limits.

How it works

An MCP client starts the server as a local process over STDIO or connects to an independently running Streamable HTTP service. SEARXNG_URL identifies the SearXNG backend, not the MCP endpoint. Multiple interchangeable SearXNG replicas can be configured as a semicolon-separated list.

Search requests use the query parameter. Pagination is available through pageno, while time_range and language narrow the search. If specific engines and a time range are combined, each selected engine must advertise time-range support in the SearXNG configuration.

URL reading operates directly on the selected website. Large responses can be divided with startChar and maxLength; a particular heading can be selected with section, or headings can be listed with readHeadings. These filtering modes are mutually exclusive where applicable.

Setup and configuration

Install with npm or run through npx. Node.js 22 or later is required for npm and npx installations. Docker images include their Node.js runtime. A minimal client configuration sets SEARXNG_URL to the base URL of the chosen SearXNG instance.

config.json
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": { "SEARXNG_URL": "https://search.example.com" }
    }
  }
}

Leave MCP_HTTP_PORT unset for local STDIO operation. HTTP deployments use the MCP service URL and can use static bearer or optional OAuth protection. Docker users must forward the environment variables into the container. Optional browser-solvers can be connected with FLARESOLVERR_URL, BYPARR_URL, or both.

Tools and capabilities

  • searxng_web_search searches SearXNG and returns result titles, URLs, and snippets. It supports pagination, language and time filters, engine selection, and full or compact response formats.
  • searxng_search_suggestions provides autocomplete suggestions for incomplete or broad queries.
  • searxng_instance_info reports reachable instance categories, engines, defaults, locales, and plugins from SearXNG configuration data.
  • web_url_read extracts readable content from known URLs, including HTML, structured text, and bounded PDF text. It can return complete content, a selected section, or headings only.

Limitations and notes

Search availability depends on the configured SearXNG instance and its enabled engines. A public instance receives the queries sent to it and may log them; using a self-operated instance changes the trust relationship but does not itself provide anonymity.

PDF OCR is not supported. Binary, media, archive, and other octet-stream downloads are rejected instead of being returned as raw bytes. URL reading returns an error string when a target cannot be reached or its content cannot be extracted.

Browser-solvers are optional. When configured, FlareSolverr is attempted before Byparr under the server's failover rules, and a final unavailable or busy provider can trigger one uncached direct-fetch fallback. HTTP session behavior varies by transport mode; legacy stateful sessions should be terminated with DELETE /mcp when finished.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP SearXNG

Ihor-Sokoliuk/MCP-SearXNG is an MCP server that connects AI clients to a configured SearXNG instance. Its main tools search the web, provide query suggestions, inspect instance capabilities, and read URLs as Markdown or extracted text, including bounded PDF text.

Install it with npm, run it with npx, or use the published Docker image. npm and npx installations require Node.js 22 or later. Configure the MCP client to start `mcp-searxng` and set `SEARXNG_URL` to an existing SearXNG instance.

Set `SEARXNG_URL` to the base URL of a SearXNG instance with JSON search enabled. The server connects to that instance and does not install SearXNG. A semicolon-separated replica list can be used for interchangeable deployments.

Yes, Cursor is named as a supported MCP client. Configure Cursor to start the local STDIO server or connect to an HTTP deployment, then provide the SearXNG backend through `SEARXNG_URL`.

Yes, `web_url_read` supports bounded PDF text extraction. It does not perform OCR, and binary downloads other than PDFs are rejected rather than returned as raw data.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP SearXNG AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ihor-sokoliuk-mcp-searxng?style=directory)](https://allmcps.com/mcp/ihor-sokoliuk-mcp-searxng)
HTML Embed
<a href="https://allmcps.com/mcp/ihor-sokoliuk-mcp-searxng"><img src="https://allmcps.com/api/badge/ihor-sokoliuk-mcp-searxng?style=directory" alt="MCP SearXNG on AllMCPs" /></a>