Skip to content
SearXNG MCP Server

SearXNG MCP Server

by Ihor Sokoliuk
2 views
MIT
Repository Docs npm
Featured Web & Search
searchweb-searchsearxngprivacyself-hosted

Summary

Private, self-hosted web search for AI assistants via SearXNG, with pagination, filters, and URL-to-markdown reading.

Features

  • searxng_web_search with pagination, time filters, language and safe-search
  • searxng_search_suggestions for autocomplete-style query refinement
  • searxng_instance_info to inspect available engines/categories
  • web_url_read fetches and converts a page to markdown

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "SearXNG MCP Server" tools will be available.
{
  "mcpServers": {
    "searxng-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "https://your-searxng-instance.example.com"
      }
    }
  }
}

Description

This server bridges any MCP client to a self-hosted SearXNG meta-search instance, giving agents privacy-respecting web search instead of relying on a vendor search API. It exposes four tools: searxng_web_search for querying with pagination, time-range, language, and safe-search controls; searxng_search_suggestions for autocomplete-style query refinement; searxng_instance_info to introspect which search engines and categories the connected SearXNG instance has enabled; and web_url_read, which fetches a URL and converts it to clean markdown so an agent can read a result page without a browser.

Because SearXNG aggregates dozens of underlying search engines without tracking, this is a good fit for teams or individuals who want search results without sending every query to a single third-party provider. It runs as a small stdio process that talks to a SearXNG deployment you already run, or connects to a Docker image, configured via a single SEARXNG_URL environment variable. It is one of the most established community search MCP servers, with hundreds of commits, OpenSSF badges, and over a thousand GitHub stars, making it a solid default recommendation for anyone standing up private web search for Claude, Cursor, or other MCP clients.

Related MCP Servers

MCP: Hugging Face

by Hugging Face

New

Official Hugging Face MCP server: search models, datasets, Spaces and papers on the Hub, read repository files, and call Gradio apps as agent tools.

Developer ToolsWeb & Search
1 views

MCP: Apify Actors

by Apify

Featured

Apify's official MCP server — turn thousands of ready-made scrapers into tools your assistant can call.

Web & Search

MCP: Browserbase

by Browserbase

Featured

Browserbase's official MCP server — cloud browser automation with Stagehand's natural-language actions.

Web & Search
1 views

MCP: X MCP Server

by X Corp.

New

X's official hosted MCP server: search the full post archive, resolve users, read timelines and trends, manage bookmarks and draft articles from any MCP client.

Web & Search
Browse all MCP servers →