Serpex

Provides multi-engine web search across six engines via a single MCP server with auto routing and structured results.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "divyeshradadiya-serpex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "serpex-mcp"
      ],
      "env": {
        "SERPEX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can query multiple search engines through a single MCP server, getting structured results from Google, Bing, DuckDuckGo, Brave, Yahoo, and Yandex. This makes it easy to compare sources, filter results by time, and integrate search into your own tools or workflows.

How to use

Set up a local or remote MCP client to connect to the Serpex multi-engine search MCP server. You’ll configure the client to run the Serpex MCP server executable and provide an API key for authentication. Once connected, you can issue search requests that go through the best available search engine and receive consistent JSON results.

How to install

Prerequisites you need before installing: Node.js and npm or pnpm.

# Quick Start (no install required): use npx to run directly
npx serpex-mcp

# Global installation (optional)
npm install -g serpex-mcp

# Local installation (preferred if you manage dependencies per-project)
npm install serpex-mcp

Additional setup and usage notes

Configure your MCP client to connect to the Serpex MCP server as shown in the configuration example. You will typically provide the MCP command, arguments, and your API key in the environment so the server can authorize requests.

{
  "mcpServers": {
    "serpex": {
      "command": "npx",
      "args": ["-y", "serpex-mcp"],
      "env": {
        "SERPEX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Security and API keys

Protect your API key and limit its scope to trusted clients. Store the key securely in your environment and do not commit it to source control. Use different keys for development and production environments.

Troubleshooting

If you encounter rate limits or captcha challenges, the Serpex MCP server includes built-in handling and proxy rotation to keep queries flowing. Ensure your API key is valid and that your network configuration allows outbound requests to the Serpex API and the underlying search engines.

Examples of common usage

Search across a specific engine and constrain results by time range using your MCP client configuration. The system will route the query to the best available engine and return structured results.

Available tools

serpex_search

Tool that queries the Serpex multi-engine API to perform web searches across six engines and returns results in a structured JSON format.