home / mcp / searxng mcp server

SearXNG MCP Server

Provides a privacy-respecting SearXNG MCP server with an optional A2A agent to enable web searches and agent-driven workflows.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "knuckles-team-searxng-mcp": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

You can run an MCP server that exposes a privacy-respecting web search interface powered by SearXNG, along with an A2A agent to interact with that MCP server. This setup lets you perform curated web searches and have agents coordinate tasks through a lightweight, configurable MCP infrastructure.

How to use

You use an MCP client to send a search request to the SearXNG MCP server. The server executes the request using SearXNG and returns search results. If you have the A2A component enabled, you can route queries through the A2A server, where agents analyze the request, invoke the MCP tool, and deliver summarized results to you.

How to install

Prerequisites: you should have Python installed on your system. The following steps will install the MCP server, run it in stdio mode for local testing, or run it in HTTP mode for network access.

# Install the MCP package
python -m pip install searxng-mcp

# Run in stdio mode (default, for local testing)
searxng-mcp --transport "stdio"

# Run in HTTP mode (network access)
searxng-mcp --transport "http" --host "0.0.0.0" --port "8000"

Additional configuration and usage notes

You can also interact with the A2A server and the AG-UI if you enable the web interfaces and point them at your MCP server. The default MCP URL for HTTP mode is the host and port you specify, followed by /mcp. For example, if you run on port 8000, the MCP endpoint is http://localhost:8000/mcp.

Security and deployment considerations

Consider enabling authentication for your MCP server when exposing it over a network. The MCP CLI and A2A workflows can be used with various authentication schemes. Review your hosting environment to choose an appropriate method, such as static tokens, JWT, or OAuth proxies, and configure access controls accordingly.

Examples

Example usage patterns include running the MCP server locally for testing, then deploying it behind an authentication proxy for production use. You can start experimenting with the built-in web search tool by issuing queries through the MCP client and verifying the structured responses.

Troubleshooting tips

If the server does not start, check that the Python environment has the required dependencies and that the port you choose is not in use. For HTTP mode, ensure the host address is reachable and that any firewalls allow traffic to the selected port.

Available tools

web_search

Perform web searches using SearXNG with customizable parameters to return relevant web content.