
SearXNG Search
MCP server for web search and page reading through a SearXNG instance
The repository was last updated yesterday and is published under MIT.
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- GitHub stars
- 1.4K
- Last commit
- 1 day ago
- Language
- TypeScript
About SearXNG Search
SearXNG 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.
This MCP server connects AI assistants to a SearXNG search instance. It offers web search with pagination and filters, reading of web pages, structured text and PDF text, and discovery of the instance's capabilities.
It does not install SearXNG; you need an instance with JSON search enabled, either self-run or trusted. It runs locally over stdio via npx or Docker, or as a Streamable HTTP service with bearer or OAuth protection. Privacy depends on the SearXNG deployment you choose.
It is for developers who want search in Claude, Cursor and similar clients without a paid search API.
Install
Run in a terminal
claude mcp add mcp-searxng --env SEARXNG_URL='<SEARXNG_URL>' --env AUTH_USERNAME='<AUTH_USERNAME>' --env AUTH_PASSWORD='<AUTH_PASSWORD>' -- npx -y mcp-searxngAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-searxng": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Configuration
SEARXNG_URLURL of your SearXNG instanceRequiredAUTH_USERNAMELegacy global SearXNG Basic Auth usernameAUTH_PASSWORDLegacy global SearXNG Basic Auth password
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- searxng_web_search
- Search the web through SearXNG
- searxng_instance_info
- Report instance capabilities
- searxng_search_suggestions
- Get query suggestions
What it does
- Paginated search
- Web search with filters and direct answers.
- URL reading
- Reads HTML, text and bounded PDF content.
- Instance discovery
- Reports instance capabilities and query suggestions.
- Flexible transports
- Local stdio or Streamable HTTP.
- Resilience options
- Optional failover, caching, proxies and HTML fallback.
Good for
- Give an assistant web search without a vendor API key
- Read a page's content during research
- Use a self-hosted private search backend
- Run a shared HTTP search service for a team
Pricing
Open source
MIT licensed; requires your own SearXNG instance
Prices change. Check npmjs.com before you buy.
SearXNG Search FAQ
What do I need first?
A SearXNG instance with JSON search enabled; the server does not install one.
Does it need a paid search API key?
No, but you operate or choose the SearXNG instance.
Is it private?
Privacy depends on the SearXNG deployment; a public instance may log queries.
Is SearXNG Search free?
Yes. SearXNG Search is open source, so you can use and self-host it for free.
How do I add SearXNG Search to Claude Code?
Run this command in your terminal: claude mcp add mcp-searxng --env SEARXNG_URL='<SEARXNG_URL>' --env AUTH_USERNAME='<AUTH_USERNAME>' --env AUTH_PASSWORD='<AUTH_PASSWORD>' -- npx -y mcp-searxng
What are the best alternatives to SearXNG Search?
The closest alternatives to SearXNG Search are Scrapling MCP Server, Firecrawl MCP Server, NeuralVerge, AI-Powered directory and Shopify MCP Server (any store).
Alternatives to SearXNG 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

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

Pull every video of a YouTube channel with stats via the official API, pay per video
- Remote
- Paid
- Design and media