Summary
Connects Claude to SearXNG search engines through a single search() function that takes queries and returns web results. You can point it at any SearXNG instance by setting the SEARXNG_URL environment variable, defaulting to localhost:8080. Install via uvx or clone locally. Useful when you need Claude to search the web through a privacy-focused, self-hosted search interface rather than relying on built-in search capabilities. The server wraps SearXNG's search API into MCP protocol, letting you integrate decentralized search into agentic workflows.
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
MCP-searxng
An MCP server for connecting agentic systems to search systems via searXNG.
Tools
Search the web with SearXNG
Prompts
search(query: str) -> f"Searching for {query} using searXNG"
Usage
via uvx
- configure your client JSON like
{
"mcpServers": {
"searxng": {
"command": "uvx",
"args": [
"mcp-searxng"
]
}
}
}
via git clone
- Add the server to claude desktop (the entrypoint is main.py)
Clone the repo and add this JSON to claude desktop
you can run this server with uvx mcp-searxng, or use a local copy of the repo
{
"mcpServers": {
"searxng": {
"command": "uv",
"args": [
"--project",
"/absoloute/path/to/MCP-searxng/",
"run",
"/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
]
}
}
}
you will need to change the paths to match your environment
Custom SearXNG URL
-
set the environment variable
SEARXNG_URLto the URL of the searxng server (default ishttp://localhost:8080) -
run your MCP client and you should be able to search the web with searxng
Note: if you are using claude desktop make sure to kill the process (task manager or equivalent) before running the server again
Featured
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
