SearXNG Search

NPM · MCP-SEARXNG · SCANNED AUG 3

MCP server for SearXNG — privacy-respecting web search with pagination, URL reading

Available components

+71 this week 78 78 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (120 of 121), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (120 of 121), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to ihor-sokoliuk/mcp-searxng). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 2 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability78

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1191 tokens (~198/item across 6 items; 4 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management14

Stability check failed: the tool surface changed between 1.12.0 and 1.14.0: 0 tool removals, 1 breaking changes, 0 additions. See how to fix → Fail

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · mcp-searxng

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add ihor-sokoliuk-mcp-searxng -- npx -y mcp-searxng

# add to Codex CLI

codex mcp add ihor-sokoliuk-mcp-searxng -- npx -y mcp-searxng

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ihor-sokoliuk-mcp-searxng": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-searxng"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add ihor-sokoliuk-mcp-searxng --command npx --arg -y --arg mcp-searxng

# ~/.hermes/config.yaml

mcp_servers:
  ihor-sokoliuk-mcp-searxng:
    command: "npx"
    args: ["-y", "mcp-searxng"]

// mcp.json

{
  "mcpServers": {
    "ihor-sokoliuk-mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +53
- Stability: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: ihor-sokoliuk/mcp-searxng security
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
1 Aug 26 −8
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 +27
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: unverified functional
- First check of Schema quality: fail functional
- First check of Schema quality: fail functional
- Package version: 1.12.1 → 1.13.0 functional
30 Jul 26 −2
- Dependency health: partial → unverified ▼ functional
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
29 Jul 26 0
- Package version: 1.12.0 → 1.12.1 functional
28 Jul 26 +1

No change was recorded against any check on this day. Supply Chain Security went from 1 to 4.
27 Jul 26 7

First indexed and scored.

Show 6 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: ihor-sokoliuk/mcp-searxng
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/ihor-sokoliuk/mcp-searxng/.github/workflows/npm-publish.yml@refs/tags/v1.14.0
Rekor log index:: 2309845504
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:6496841ef8cbba091da508d29c20a1c0243112b6e77ce6f712c9832dd66e008fb86c444427b5588ad430fa59610017d1b0ab2428c6ccc2a34b829abfb
Discovery method:: attestation_endpoint

Dependencies 120 packages

120 packages in the resolved dependency tree · 119 deprecated · 32 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 4 exposed · ~1,162 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

searxng_instance_info ~114

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

Input Output Examples

Name	Type	Req	Description
category	string	—	Filter categories and engines to a single category name.
includeDisabled	boolean	—	Include disabled engine names when includeEngines is true.
includeEngines	boolean	—	Include enabled engine names in the response.
refresh	boolean	—	Bypass the process cache and fetch fresh /config data.

No output schema declared.

No examples provided.

searxng_search_suggestions ~80

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

Input Output Examples

Name	Type	Req	Description
language	string	—	Language code for suggestions (e.g., 'en', 'fr', 'de') or 'all'. Default: all.
query	string	yes	Partial or complete query to autocomplete.

No output schema declared.

No examples provided.

searxng_web_search ~594

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`.

Input Output Examples

Name	Type	Req	Description
categories	string	—	Comma-separated SearXNG categories. Live /config capabilities are aggregated across reachable instances; prefer searxng_instance_info categories.common for consistent multi-instance results. Values i…
engines	string	—	Comma-separated SearXNG engine names to query (e.g. 'google,bing,ddg'). Live /config capabilities are aggregated across reachable instances; prefer searxng_instance_info engines.common.enabled for co…
language	string	—	Language code for search results (e.g., 'en', 'fr', 'de'). Default is instance-dependent.
min_score	number	—	Minimum relevance score threshold from 0.0 to 1.0. Results below this score are filtered out.
num_results	number	—	Maximum number of results to return (1-20). Operator cap SEARXNG_MAX_RESULTS applies as a ceiling.
pageno	integer	—	Search page number (starts at 1)
query	string	yes	The search query string. This is the required parameter name — use exactly `query`, not `prompt` or `q`.
response_format	string	—	Response format: formatted text for agents or raw JSON for programmatic clients. If omitted, SEARXNG_DEFAULT_RESPONSE_FORMAT applies; if unset or invalid, text is used. An explicit response_format al…
safesearch	string	—	Safe search filter level (0: None, 1: Moderate, 2: Strict)
time_range	string	—	Time range of search (day, week, month, year)

No output schema declared.

No examples provided.

web_url_read ~374

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.

Input Output Examples

Name	Type	Req	Description
maxLength	number	—	Maximum number of characters to return
paragraphRange	string	—	Return specific paragraph ranges (e.g., '1-5', '3', '10-')
readHeadings	boolean	—	Return only a list of headings instead of full content
section	string	—	Extract content under a specific heading (searches for heading text)
startChar	number	—	Starting character position for content extraction (default: 0)
url	string	yes	URL

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug