SearXNG MCP Server
An MCP server for private web search through your SearXNG instance: search with pagination and filters, page and PDF reading
- 1,359 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The server goes online and reads page and PDF content
- Search results depend on your SearXNG instance
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/searxng-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server goes online and reads page and PDF content
- Search results depend on your SearXNG instance
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent web search through a SearXNG instance you run or trust. It searches with pagination, filters and direct answers, and returns results as text or JSON. Beyond search, it reads HTML and structured page text, extracts bounded text from PDFs and shows headings or selected sections. It runs over local stdio or Streamable HTTP, with optional protection via a static token or OAuth.
Who it is for. For developers and analysts who need private agent web search without a commercial search API.
Good fit when
- You need agent web search through your own SearXNG instance
- You need to read pages and extract text from linked PDFs
- You care about privacy and control over the search backend
Not a fit when
- You have no SearXNG instance and no interest in running one
- You need search in private databases rather than the open web
Example request
Search the web for recent material on this topic and read the first two pagesMCP
- Transport
- stdio, http
- Authentication
- not required
Environment variables
SEARXNG_URLrequired- Base URL of your SearXNG instance
MCP_HTTP_PORT- Port for Streamable HTTP mode, left unset for local stdio
Limitations
The server does not search on its own: it needs a working SearXNG instance whose URL is set via the SEARXNG_URL variable. The npx and npm paths need Node.js 22 or later, and the Docker image needs environment forwarding. PDF text extraction is bounded in size.
How to disable. Remove the server entry from your MCP client config and uninstall the package with npm uninstall -g mcp-searxng.
FAQ
Do I need my own SearXNG instance?
Yes, the server talks to a SearXNG instance you run or trust. Its URL is set in SEARXNG_URL.
Which transports are supported?
Local stdio to run next to the client and Streamable HTTP, with optional token or OAuth protection.
Discussion
No questions or reviews yet.
Related
MCP serversSearXNG AI Kit gives agents web search across 180+ engines through a CLI and an MCP server, with no search API key
MCP server for web search and crawling: SearXNG and You.com plus clean Markdown from pages, sites and logged-in areas
A web search MCP server that gives the agent full page text at once: Stack Overflow answers, GitHub threads, arXiv papers
MCP server for real-time web search: general and vertical search, batch queries and page content extraction
A unified search MCP server: one interface to Tavily, Brave, Kagi, Exa, Linkup, Firecrawl and GitHub search
Web search via DuckDuckGo and page reading for the agent with no API keys, with built-in rate limiting
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| SearXNG MCP Server (this card) | no | not required | 1,359 | |
| browser-search | no | 546 | a web research skill | |
| CoexistAI | no | not required | 531 | a local research MCP server |
| search2ai | no | API key | 1,288 | self-hosted web search gateway for agents |
README in short
The README describes an MCP server that gives an agent private web search through a SearXNG instance. It offers search with pagination and filters, page and PDF reading, instance capability discovery and query suggestions. It installs via npx, global npm or Docker, with the instance URL set in SEARXNG_URL. It runs over stdio and Streamable HTTP. MIT licensed.