health_check
Verify the SearXNG search instance is operational and accessible. Use this tool to diagnose connection issues and ensure the search service is available before performing web searches.
Instructions
Check the health status of the SearXNG instance.
This tool verifies that the SearXNG instance is running and accessible. Useful for diagnostics and ensuring the search service is operational before performing searches.
Use this when you need to:
Verify the SearXNG instance is accessible
Diagnose connection issues
Check service availability before searching
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Input Schema (JSON Schema)
{
"properties": {},
"type": "object"
}
Implementation Reference
- src/searxng_mcp_server/server.py:136-151 (registration)Registration of the 'health_check' tool in the list_tools handler, including its schema (empty input) and description.Tool( name="health_check", description="""Check the health status of the SearXNG instance. This tool verifies that the SearXNG instance is running and accessible. Useful for diagnostics and ensuring the search service is operational before performing searches. Use this when you need to: - Verify the SearXNG instance is accessible - Diagnose connection issues - Check service availability before searching""", inputSchema={ "type": "object", "properties": {}, }, ),
- src/searxng_mcp_server/server.py:231-238 (handler)MCP server tool handler for 'health_check': calls client.health_check() and returns the result as JSON-formatted TextContent.elif name == "health_check": health = await client.health_check() return [ TextContent( type="text", text=json.dumps(health, indent=2), ) ]
- src/searxng_mcp_server/client.py:163-183 (handler)Core implementation of health_check in SearXNGClient: performs GET request to /healthz endpoint and returns status dictionary.async def health_check(self) -> Dict[str, Any]: """Check the health status of the SearXNG instance. Returns: Dictionary containing health status information Raises: httpx.HTTPError: If the request fails """ url = urljoin(self.base_url, "/healthz") try: response = await self.client.get(url) response.raise_for_status() return {"status": "ok", "message": "SearXNG instance is healthy"} except httpx.HTTPError as e: return { "status": "error", "message": f"Health check failed: {str(e)}", }