name: searxng
version: "1.0.0"
description: SearXNG MCP server for private web search and URL-to-markdown reading
packageName: "mcp-searxng"
transport: STDIO
repositoryUrl: https://github.com/ihor-sokoliuk/mcp-searxng
# Readiness reads SearXNG's /config, which proves the instance answers without
# fanning out to its engines. A searxng_web_search probe is a real search every
# interval (1,440/day at 60s): it burns API-key engines (braveapi, kagi) and
# feeds the IP blocks scraping engines put on the instance.
healthCheck:
  tool: searxng_instance_info
env:
  - name: SEARXNG_URL
    description: >-
      SearXNG instance URL, or ';'-separated replicas
      (e.g. http://mcpctl-searxng:8080). The instance must list `json` under
      `search.formats` — see stack/searxng/settings.yml.
    required: true
  - name: SEARXNG_DEFAULT_RESPONSE_FORMAT
    description: Result shape when a call omits response_format — "text" or "json"
    required: false
    defaultValue: "text"
  - name: SEARXNG_HTML_FALLBACK
    description: Scrape the HTML result page when the JSON API is unavailable
    required: false
    defaultValue: "false"