Knuckles-Team/searxng-mcp

## CLI or API | MCP
> Documentation — Installation, deployment, usage across the MCP tool, Python API,
> and console scripts, and guidance for provisioning the SearXNG instance are
> maintained in the official documentation.
## Overview
Searxng Mcp is a production-grade Agent and Model Context Protocol (MCP) server designed to interface directly with SearXNG Search Engine MCP Server for Agentic AI!.
## Key Features
Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
Native Telemetry & Tracing: Out-of-the-box OpenTelemetry exports and native Langfuse tracing.
## CLI or API
This agent wraps the SearXNG Search Engine MCP Server for Agentic AI! API. The operator can interact with it programmatically or via its integrated execution entrypoints.
Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.
## MCP
This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.
### Available MCP Tools
The table below is auto-generated from the MCP server — do not edit by hand.
#### Condensed action-routed tools (MCPTOOLMODE=condensed)
| MCP Tool | Toggle Env Var | Description |
| searxngingestsearch | KGTOOL | Run a SearXNG search and natively ingest its results into epistemic-graph. |
| searxngsearchapp | SEARCHAPPTOOL | Launch an interactive SearXNG search-UI app: a query box, category filters, and a clickable results list, backed by the existing websearch tool through the host-mediated MCP Apps bridge. Use this when a human should see and interact with search results visually rather than read raw JSON. Does NOT drive a browser or render arbitrary web pages -- only this search workflow. |
| searxngsettings | CONFIGTOOL | Read/edit the EMBEDDED SearXNG instance's settings.yml |
| websearch | — | Perform a web search using a privacy-respecting SearXNG metasearch instance. |
4 action-routed tool(s) · 0 verbose 1:1 tool(s). Each is enabled unless its TOOL toggle is set false; MCPTOOLMODE selects the surface (intent default — the six verb-tools, granular set loaded on demand · condensed action-routed · verbose 1:1 · both). Auto-generated — do not edit.
Detailed tool schemas, parameter shapes, and validation constraints are preserved in docs/usage.md.
### Dynamic Tool Selection & Visibility
This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows the operator to restrict the set of exposed tools to prevent blowing up the LLM's context window.
The operator can configure tool filtering via multiple input channels:
CLI Arguments: Pass --tools or --toolsets (or their disabled counterparts --disabled-tools and --disabled-toolsets) during startup.
Environment Variables: Define standard environment variables:
MCPENABLEDTOOLS / MCPDISABLEDTOOLS
MCPENABLEDTAGS / MCPDISABLEDTAGS
HTTP SSE Request Headers: Pass custom headers during transport initialization: