Skip to content

searxng-mcp

A privacy-respecting metasearch API + MCP Server (with an optional A2A agent) for the agent-utilities ecosystem — query the web across many search engines through one deterministic tool surface.

Official documentation

This site is the canonical reference for searxng-mcp, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

searxng-mcp wraps a SearXNG metasearch instance with a typed, deterministic MCP tool surface, and ships an optional Pydantic-AI agent server for autonomous and conversational use. It provides:

  • A web_search MCP tool — a single, well-documented search action that accepts a query, optional categories, engines, language, and pagination, and returns SearXNG's JSON result set.
  • An optional A2A agent server (searxng-agent console script) that exposes the search capability over the Agent Control Protocol and an Agent Web UI.
  • Zero-credential operation — point it at any SearXNG instance, or let it select a public instance automatically; results degrade to a clear error rather than raising when an instance is unreachable.

Explore the documentation

  • Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
  • Usage — the web_search tool, the Python API, and the console scripts.
  • Backing Platform — deploy SearXNG with Docker.
  • Overview — the ecosystem role and the standardized package pattern.
  • Concepts — the CONCEPT:SRX-* registry.

Quick start

pip install "searxng-mcp[mcp]"
searxng-mcp                       # stdio MCP server (default transport)

Point it at a SearXNG instance and run an HTTP server:

export SEARXNG_URL=http://localhost:8080
searxng-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, DNS).