get_suggestions
Generate autocomplete suggestions for search queries to discover related terms and improve query formulation.
Instructions
Get search suggestions/autocomplete for a query prefix.
This tool provides search suggestions based on a partial query, similar to autocomplete functionality in search engines. Useful for discovering related searches or expanding on a topic.
Use this when you need to:
Get autocomplete suggestions for a search
Discover related search terms
Help users formulate better search queries
Explore variations of a search topic
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The query prefix to get suggestions for | |
| language | No | Language code for suggestions (default: 'en') | en |
Implementation Reference
- src/searxng_mcp_server/server.py:215-229 (handler)MCP server tool handler for get_suggestions: extracts arguments, calls client.get_suggestions, formats and returns JSON response as TextContent
elif name == "get_suggestions": suggestions = await client.get_suggestions( query=arguments["query"], language=arguments.get("language", "en"), ) return [ TextContent( type="text", text=json.dumps( {"query": arguments["query"], "suggestions": suggestions}, indent=2, ), ) ] - SearXNGClient.get_suggestions: makes HTTP GET to /autocomplete endpoint with query and language params, returns list of suggestions from JSON response
async def get_suggestions( self, query: str, language: str = "en", ) -> List[str]: """Get search suggestions for a query prefix. Args: query: The query prefix language: Language code for suggestions Returns: List of suggestion strings Raises: httpx.HTTPError: If the request fails """ url = urljoin(self.base_url, "/autocomplete") params = { "q": query, "language": language, } response = await self.client.get(url, params=params) response.raise_for_status() # Autocomplete returns a simple list return response.json() - src/searxng_mcp_server/server.py:107-135 (registration)Registration of get_suggestions tool in list_tools(): defines name, description, and inputSchema
Tool( name="get_suggestions", description="""Get search suggestions/autocomplete for a query prefix. This tool provides search suggestions based on a partial query, similar to autocomplete functionality in search engines. Useful for discovering related searches or expanding on a topic. Use this when you need to: - Get autocomplete suggestions for a search - Discover related search terms - Help users formulate better search queries - Explore variations of a search topic""", inputSchema={ "type": "object", "properties": { "query": { "type": "string", "description": "The query prefix to get suggestions for", }, "language": { "type": "string", "description": "Language code for suggestions (default: 'en')", "default": "en", }, }, "required": ["query"], }, ), - Input schema definition for get_suggestions tool: requires 'query', optional 'language' with defaults
inputSchema={ "type": "object", "properties": { "query": { "type": "string", "description": "The query prefix to get suggestions for", }, "language": { "type": "string", "description": "Language code for suggestions (default: 'en')", "default": "en", }, }, "required": ["query"], },