Cloudsway Smartsearch

What is Cloudsway Smartsearch?

Cloudsway Smartsearch is an MCP server that integrates the remote Cloudsway Smart Search API, providing web search functionality. It returns structured JSON results and is suitable for the ModelScope MCP platform and compatible clients. It is intended for developers needing programmable web search with pagination, language, and safety controls.

How to use Cloudsway Smartsearch?

After obtaining an API key (SERVER_KEY) from Cloudsway, configure the server by setting the SERVER_KEY environment variable. The server can be run via npx -y @cloudsway-ai/smartsearch with the key provided in the environment. The primary tool is SmartSearch, which accepts parameters: query (required), count, offset, setLang, and safeSearch.

Key features of Cloudsway Smartsearch

• Web search with keyword query support
• Pagination via count and offset parameters
• Language selection with setLang option
• Safety level control (safeSearch with 'Strict' default)
• All results returned in structured JSON format
• Compatible with ModelScope MCP platform

Use cases of Cloudsway Smartsearch

• Retrieving web search results within AI agent workflows
• Building data‑gathering tools with paginated queries
• Integrating safe, language‑specific search into MCP clients
• Automating research tasks with programmatic search

FAQ from Cloudsway Smartsearch

How do I obtain an API key for Cloudsway Smartsearch?

Log in to www.cloudsway.ai or contact [email protected] to get your Endpoint and AccessKey. Combine them as {Endpoint}-{AccessKey} to form the SERVER_KEY.

What parameters does the SmartSearch tool accept?

The tool requires a query string. Optional parameters: count (default 10), offset (default 0), setLang (default 'en'), and safeSearch (default 'Strict').

Is Cloudsway Smartsearch a local or remote service?

It is an MCP server that calls the remote Cloudsway Smart Search API. The server itself runs locally but requires internet access to the API.

What runtime does the server require?

The server is distributed as an npm package; the example configuration uses npx to run it. Node.js must be installed.

Does the server support authentication?

Yes. The SERVER_KEY environment variable (composed of Endpoint and AccessKey) is used for authentication and is required.