ihor-sokoliuk avatar

SearXNG Search

ihor-sokoliuk/mcp-searxng

The Mcp Searxng server integrates the SearXNG metasearch API to provide AI assistants with web search and content extraction capabilities. It offers tools for executing paginated web searches with filters for time range, language, and safe search levels, as well as a URL content reader that extracts and caches page content with TTL optimization. This server enables AI assistants to access current web information and retrieve detailed content from URLs by connecting to any SearXNG instance via HTTP JSON API.

GitHub stars
1.4K
tools
2
auth
Secret needed
transport
STDIO
env vars
3
last updated
Nov 11, 2026

Install

From registry metadata
$ npx add-mcp mcp-searxng --name mcp-searxng --env 'SEARXNG_URL=${SEARXNG_URL}' --env 'AUTH_USERNAME=${AUTH_USERNAME}' --env 'AUTH_PASSWORD=${AUTH_PASSWORD}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add mcp-searxng --env SEARXNG_URL=YOUR_SEARXNG_URL --env AUTH_USERNAME=YOUR_AUTH_USERNAME --env AUTH_PASSWORD=YOUR_AUTH_PASSWORD -- npx -y mcp-searxng

Run in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.

Tools

Verified live · 2 tools

Verified live against the running server on Jun 10, 2026.

searxng_web_searchSearches the web using SearXNG and returns a list of results, each with a title, URL, and content snippet. CRITICAL: The required parameter name is exactly `query` (not `prompt`, `q`, or any other name). Calls an external SearXNG instance; availability depends on the `SEARXNG_...6 params

Searches the web using SearXNG and returns a list of results, each with a title, URL, and content snippet. CRITICAL: The required parameter name is exactly `query` (not `prompt`, `q`, or any other name). Calls an external SearXNG instance; availability depends on the `SEARXNG_...

Parameters* required
languagestring
Language code for search results (e.g., 'en', 'fr', 'de'). Default is instance-dependent.default: all
min_scorenumber
Minimum relevance score threshold from 0.0 to 1.0. Results below this score are filtered out.
pagenonumber
Search page number (starts at 1)default: 1
query*string
The search query string. This is the required parameter name — use exactly `query`, not `prompt` or `q`.
safesearchnumber
Safe search filter level (0: None, 1: Moderate, 2: Strict)one of 0 · 1 · 2default: 0
time_rangestring
Time range of search (day, week, month, year)one of day · week · month · year
web_url_readFetches a URL and returns its text content converted to markdown. Three modes: (1) Full content — omit filtering params; use `startChar`/`maxLength` to paginate large pages. (2) Section extraction — set `section` to return content under a specific heading. (3) Headings only —...6 params

Fetches a URL and returns its text content converted to markdown. Three modes: (1) Full content — omit filtering params; use `startChar`/`maxLength` to paginate large pages. (2) Section extraction — set `section` to return content under a specific heading. (3) Headings only —...

Parameters* required
maxLengthnumber
Maximum number of characters to return
paragraphRangestring
Return specific paragraph ranges (e.g., '1-5', '3', '10-')
readHeadingsboolean
Return only a list of headings instead of full content
sectionstring
Extract content under a specific heading (searches for heading text)
startCharnumber
Starting character position for content extraction (default: 0)
url*string
URL

Sponsors

Configuration

SEARXNG_URL*secret

URL of your SearXNG instance

AUTH_USERNAMEsecret

Legacy global SearXNG Basic Auth username

AUTH_PASSWORDsecret

Legacy global SearXNG Basic Auth password

Readme

🔍 SearXNG MCP Server

Privacy-respecting web search for AI assistants — use an operator-controlled or trusted SearXNG instance with Claude, Cursor, and more.


View the full README on GitHub

Details

Repository
github.com/ihor-sokoliuk/mcp-searxng
Category
Search & Web Crawling
Package
mcp-searxng
Transport
STDIO
Auth
Required
Registry
MCP registry, active
Resources
2
Tools verified
Jun 10, 2026

Related Search & Web Crawling MCP servers

View all
1johnhuang316 avatarCode Indexjohnhuang316/code-index-mcpA Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup942stars
2saurabhsharma2u avatarSearch Console MCPsaurabhsharma2u/search-console-mcpGoogle Search Console + Bing + GA4 + AdSense — unified SEO intelligence for AI agents.320stars
3zhengyanglsun avatariFlow Searchzhengyanglsun/iflow-search-jsMCP server for iFlow Search web search, image search, and URL fetch tools.0stars
4hasdata avatarHasData DuckDuckGohasdata/duckduckgo-mcpDuckDuckGo search as JSON. Ranked results, ads in their own array, 37 regions.7stars
5hasdata avatarHasData Web Scrapinghasdata/web-scraping-mcpFetch any public web page through managed proxies, with optional JS rendering and extraction rules.7stars
6hasdata avatarHasData Binghasdata/bing-mcpBing search results with the ad block and Copilot answer, geo and market targeting, as JSON.5stars