Overview
Features
Web search with advanced filters
Provides pagination, language, freshness, and site filtering to refine results for MCP clients.
Structured JSON output
Returns a JSON payload suitable for downstream processing with fields like queryContext and webPages.value[].
MCP-compatible deployment
Server is designed for MCP deployment with a dedicated service configuration example.
Configurable input parameters
Tool accepts query, count, offset, setLang, freshness, and sites with sensible defaults.
Rich response metadata
Includes datePublished, dateLastCrawled, siteName, thumbnailUrl, and score for each result.
API key management
Obtain Endpoint and AccessKey from Cloudsway and set as SERVER_KEY in environment.
Deployment details and entry point
Entry file located at src/smartsearch/smartsearch.py; ensure SERVER_KEY is provided.
Example MCP service configuration
Shows an example JSON configuration using npx @cloudsway-ai/smartsearch with SERVER_KEY.




