searxng-mcpb
Allows web search through a user-configured SearXNG instance, with support for engine and category selection, language and time-range filters, and bounded result counts.
Click on "Deploy 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., "@searxng-mcpbsearch the web for the latest news on 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.
SearXNG for Claude Desktop
This MCP Bundle adds web search to Claude Desktop through a SearXNG instance selected by the user. It supports engine and category selection, language and time-range filters, and bounded result counts.
Requirements
Claude Desktop on macOS or Windows
Network access to the selected SearXNG instance
The extension uses the MCPB uv runtime to create an isolated environment and
install its pinned searxng dependency; users do not need to install Python or
uv. Enter the base URL of a SearXNG instance during installation. For
predictable privacy and availability, use an instance you operate or whose
operator you trust.
Related MCP server: Claude Web Search MCP Server
Privacy Policy
The extension runs locally and does not send search queries to its maintainer. It sends each query and its search options directly to the SearXNG instance the user configures. It does not persist queries or results, use analytics or advertising trackers, create user profiles, or share data with the maintainer. Request data is discarded from memory after the request.
The selected SearXNG instance and the search engines it contacts are independent third parties with their own collection, use, sharing, and retention practices. Review the selected instance's privacy notice before sending sensitive queries. See the complete privacy policy for data-flow and contact details.
Support
Report installation, functionality, security, or privacy issues at https://github.com/danchev/searXNG/issues.
License
AGPL-3.0-or-later. See LICENSE.
Available Tools
1 toolweb_searchSearXNG Web SearchB
Use SearXNG to search the web for information
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query string | |
| engines | No | Search engines, e.g. ['google', 'bing', 'duckduckgo'] | |
| language | No | Search language code (default 'en') | |
| categories | No | Search categories, e.g. ['general', 'images', 'news'] | |
| time_range | No | Time range filter | |
| max_results | No | Maximum number of results to return (default 10) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of disclosing behavior. It merely says 'search the web for information,' which minimally implies a read-only retrieval operation, but it does not disclose return format, result structure, rate limits, or any side effects. This is a significant gap for a tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, making it highly scannable and front-loaded with the action verb 'Use.' However, the phrase 'for information' is somewhat redundant; 'search the web' would suffice, so not every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given six parameters and no output schema, the description should clarify what the tool returns (e.g., search results with URLs and snippets) and any noteworthy behavior. It provides none of that, leaving the agent without enough context to fully understand the tool's response or capabilities beyond parameter names.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, so each parameter (query, engines, language, categories, time_range, max_results) is already documented. The tool description adds no semantic detail beyond the schema, but it doesn't need to since the schema is fully self-descriptive. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('search the web') and the specific tool ('SearXNG'), giving the agent a solid understanding of what the tool does. Although it doesn't distinguish from siblings, no siblings are listed, so this is a clear purpose statement without being a tautology.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies this tool is for web search, but it provides no explicit guidance on when to use it versus alternatives, nor any context about when it would be appropriate. With no sibling tools, the usage context is only implied rather than clearly stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v0.1.2- First observed
web_search
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlapping purposes. The tool's function is singular and clearly defined.
The single tool name 'web_search' follows a clean snake_case verb_noun pattern. There are no conflicting naming conventions to create inconsistency.
The server exposes only one tool, which feels thin even though web search is its core purpose. It is borderline: sufficient for a narrow scope, but lacking any supporting operations or additional configurability.
For the stated domain of web search via SearXNG, the single tool fully covers the core operation. There are no obvious missing capabilities within the server's narrow scope.
Maintenance
Related MCP Connectors
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Web search and page-reading for AI agents. One-click OAuth connect, or a Caesar API key.
Real-time web search, reasoning, and research through Perplexity's API
Serper MCP — wraps the Serper Google Search API (serper.dev)
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides web search capabilities using SearxNG, allowing AI assistants like Claude to search the web with a privacy-respecting metasearch engine.111MIT
- FlicenseAqualityDmaintenanceProvides web search capabilities to Claude AI using the Anthropic API, allowing LLMs to access up-to-date information from the web with customizable domain filtering.148-
- FlicenseNot gradedqualityDmaintenanceEnables web search and content scraping from multiple engines via a local SearXNG instance, allowing AI assistants to retrieve and extract web content.1-
- AlicenseAqualityCmaintenanceProvides DuckDuckGo web search and site fetching tools for Claude Desktop, enabling up to 10 search results and text content extraction from URLs.2MIT