mcp_searxng
This server provides privacy-respecting web search via a SearXNG instance, exposing multiple MCP tools with structured error handling (all responses contain a success flag).
search_web: Perform general web searches. Optionally filter by engine, category (general, news, images, science, files, social media, videos), language, and maximum result count.search_news: Search for news articles, controlling the number of results.search_images: Image search; results include title, URL, thumbnail, and source.list_engines: List all available search engines, defaulting to only enabled ones; optionally show all engines.
Provides privacy-respecting web search via SearXNG, including tools for general web search, news search, image search with thumbnails, and listing available/enabled engines.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp_searxngsearch the web for the latest developments in renewable energy"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp_searxng
MCP server for privacy-respecting web search via SearXNG.
Requires pi-mcp-bridge to connect to pi.
Prerequisites
SearXNG instance running (default:
http://localhost:8080/searxng)
Related MCP server: mcp_server_searXNG
Installation
pip install git+https://github.com/timaliev/mcp_searxng.gitOr via uv:
uv tool install git+https://github.com/timaliev/mcp_searxng.gitConfiguration
With pi-mcp-bridge
In ~/.pi/agent/settings.json:
{
"mcpBridge": {
"servers": [
{
"name": "searxng",
"command": "mcp-searxng",
"args": [],
"env": {
"SEARXNG_URL": "http://localhost:8080/searxng"
},
"setupCommands": [
"uv tool install --python 3.11 git+https://github.com/timaliev/mcp_searxng.git"
],
"githubRepo": "timaliev/mcp_searxng",
"versionCommand": "mcp-searxng --version"
}
]
}
}Standalone MCP client
In ~/.mcp.json:
{
"mcpServers": {
"searxng": {
"command": "mcp-searxng",
"args": [],
"env": {
"SEARXNG_URL": "http://localhost:8080/searxng"
}
}
}
}Environment Variables
Variable | Default | Description |
|
| SearXNG instance URL |
Tools
Tool | Description |
| Web search with engine/category/language filters |
| News-only search |
| Image search with thumbnails |
| List available/enabled SearXNG engines |
Error Handling
All tools return a structured response with a success field. If SearXNG is unreachable or returns an error, success will be false with an error code and detail:
Error Code | Cause |
| SearXNG instance is not running or not reachable at the configured |
| SearXNG returned an HTTP error (e.g., 500) |
| Unexpected error while processing the request |
Example error response:
{
"success": false,
"error": "ECONNREFUSED",
"detail": "Cannot reach SearXNG at http://localhost:8080/searxng"
}The server does not crash or exit — errors are returned inline so the agent can handle them gracefully.
Development
git clone https://github.com/timaliev/mcp_searxng.git
cd mcp_searxng
uv run mcp-searxngMaintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server that enables web search capabilities by integrating with a SearXNG instance to aggregate results from over 130 engines. It allows users to perform filtered searches across categories like news, science, and social media while supporting advanced parameters for language and time range.9MIT
- AlicenseNot gradedqualityCmaintenanceA privacy-friendly web search MCP server using SearXNG, enabling searches across multiple engines and categories.1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that integrates the SearXNG API to provide web search with pagination, filtering, and URL content extraction.28MIT
- FlicenseNot gradedqualityDmaintenancePrivacy-focused web search MCP server using SearXNG with Streamable HTTP transport, supporting authentication and advanced search parameters.
Related MCP Connectors
Serper MCP — wraps the Serper Google Search API (serper.dev)
MCP server for Google search results via SERP API
An MCP server for deep research or task groups
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/timaliev/mcp_searxng'
If you have feedback or need assistance with the MCP directory API, please join our Discord server