Skip to content
MCP server

SearXNG Search

MCP server for web search and page reading through a SearXNG instance

Runs locallyActively maintainedStatus and history

The repository was last updated yesterday and is published under MIT.

Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
GitHub stars
1.4K
Last commit
1 day ago
Language
TypeScript

About SearXNG Search

SearXNG Search is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

This MCP server connects AI assistants to a SearXNG search instance. It offers web search with pagination and filters, reading of web pages, structured text and PDF text, and discovery of the instance's capabilities.

It does not install SearXNG; you need an instance with JSON search enabled, either self-run or trusted. It runs locally over stdio via npx or Docker, or as a Streamable HTTP service with bearer or OAuth protection. Privacy depends on the SearXNG deployment you choose.

It is for developers who want search in Claude, Cursor and similar clients without a paid search API.

Install

Run in a terminal

claude mcp add mcp-searxng --env SEARXNG_URL='<SEARXNG_URL>' --env AUTH_USERNAME='<AUTH_USERNAME>' --env AUTH_PASSWORD='<AUTH_PASSWORD>' -- npx -y mcp-searxng

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-searxng": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "<SEARXNG_URL>",
        "AUTH_USERNAME": "<AUTH_USERNAME>",
        "AUTH_PASSWORD": "<AUTH_PASSWORD>"
      }
    }
  }
}

Configuration

  • SEARXNG_URLURL of your SearXNG instanceRequired
  • AUTH_USERNAMELegacy global SearXNG Basic Auth username
  • AUTH_PASSWORDLegacy global SearXNG Basic Auth password

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

searxng_web_search
Search the web through SearXNG
searxng_instance_info
Report instance capabilities
searxng_search_suggestions
Get query suggestions

What it does

Paginated search
Web search with filters and direct answers.
URL reading
Reads HTML, text and bounded PDF content.
Instance discovery
Reports instance capabilities and query suggestions.
Flexible transports
Local stdio or Streamable HTTP.
Resilience options
Optional failover, caching, proxies and HTML fallback.

Good for

  • Give an assistant web search without a vendor API key
  • Read a page's content during research
  • Use a self-hosted private search backend
  • Run a shared HTTP search service for a team

Pricing

Open source

MIT licensed; requires your own SearXNG instance

Prices change. Check npmjs.com before you buy.

SearXNG Search FAQ

What do I need first?

A SearXNG instance with JSON search enabled; the server does not install one.

Does it need a paid search API key?

No, but you operate or choose the SearXNG instance.

Is it private?

Privacy depends on the SearXNG deployment; a public instance may log queries.

Is SearXNG Search free?

Yes. SearXNG Search is open source, so you can use and self-host it for free.

How do I add SearXNG Search to Claude Code?

Run this command in your terminal: claude mcp add mcp-searxng --env SEARXNG_URL='<SEARXNG_URL>' --env AUTH_USERNAME='<AUTH_USERNAME>' --env AUTH_PASSWORD='<AUTH_PASSWORD>' -- npx -y mcp-searxng

What are the best alternatives to SearXNG Search?

The closest alternatives to SearXNG Search are Scrapling MCP Server, Firecrawl MCP Server, NeuralVerge, AI-Powered directory and Shopify MCP Server (any store).

Alternatives to SearXNG Search

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  4. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce