Skip to main content
Glama
vinas1

mcp-searxng

by vinas1

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BYPARR_URLNoURL of the Byparr instance for browser solver support.
SEARXNG_URLYesThe URL of your SearXNG instance (or semicolon-separated list of interchangeable replicas). This is the only required variable.
MCP_HTTP_HOSTNoHost/interface to bind for HTTP transport. Defaults to 127.0.0.1.
MCP_HTTP_PORTNoPort for HTTP transport mode. Set to use HTTP instead of STDIO.
SEARXNG_FANOUTNoWhen true, queries all healthy replicas in parallel and merges results.
MCP_HTTP_HARDENNoWhen true, enables hardened mode for HTTP transport.
FLARESOLVERR_URLNoURL of the FlareSolverr instance for browser solver support.
MCP_HTTP_STATELESSNoWhen true, enables stateless HTTP mode.
SEARXNG_LITE_TOOLSNoWhen true, uses minimal tool schemas for local models.
SEARXNG_MAX_RESULTSNoOperator ceiling for maximum number of results (1-20).
MCP_HTTP_TRUST_PROXYNoWhen true, trusts proxy headers for rate limiting and logging.
SEARXNG_HTML_FALLBACKNoWhen true, falls back to HTML parsing for instances that reject format=json.
SEARXNG_MAX_RESULT_CHARSNoTruncates result content in compact and full text/JSON responses.
SEARXNG_DEFAULT_RESPONSE_FORMATNoDefault response format for search calls: 'text' or 'json'.
URL_READ_MAX_CONTENT_LENGTH_BYTESNoMaximum content length in bytes for URL reading, also caps PDF input and extracted text.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}
logging
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
searxng_web_searchA

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_URL configuration. Use pageno to paginate results; combine time_range and language to narrow scope. To read the full text of a result URL, follow up with web_url_read.

searxng_search_suggestionsA

Returns autocomplete suggestions from the configured SearXNG instance. Use this to refine vague or partial queries before searching.

searxng_instance_infoA

Discovers capabilities from all reachable configured SearXNG instances via /config, including categories.common/available, engines.common/available, defaults, locales, and plugins.

web_url_readA

Fetches a URL and returns readable content as markdown. Content-type aware: HTML is converted to markdown; JSON is pretty-printed; plain text, YAML, TOML, and XML are returned as fenced readable text. PDF text extraction is supported with bounded input, output, page count, time, concurrency, and memory; OCR is not supported. Binary, media, archive, and octet-stream downloads other than PDFs are intentionally rejected instead of being returned as raw bytes. When the operator configures browser solvers, mcp-searxng attempts FlareSolverr first and then Byparr only after a busy or transient-unavailable acquisition; cache hits bypass acquisition and a final busy or unavailable provider uses one uncached direct-fetch fallback. 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 — set readHeadings: true to list all headings (mutually exclusive with other filtering params). Returns an error string if the URL is unreachable or content cannot be extracted. Use after searxng_web_search to read the full content of individual result URLs.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Server ConfigurationCurrent server configuration and environment variables
Usage GuideHow to use the MCP SearXNG server effectively

Latest Blog Posts

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/vinas1/mcp-searxng'

If you have feedback or need assistance with the MCP directory API, please join our Discord server