Serpex MCP


A Model Context Protocol (MCP) server that provides multi-engine web search capabilities through the Serpex API. Search across Google, Bing, DuckDuckGo, Brave, Yahoo, and Yandex with automatic engine routing and structured JSON results.

Features

✅ Multi-Engine Support: Access 6 search engines (Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex)
✅ Auto Routing: Automatically selects the best available search engine
✅ Time Filtering: Filter results by day, week, month, or year
✅ Structured Results: Clean, consistent JSON responses
✅ Fast & Reliable: Built-in captcha handling and proxy rotation
✅ Easy Integration: Works with Claude Desktop, Jan AI, and any MCP-compatible client

Installation

$3

No installation needed! Use npx to run directly:

``bash
npx serpex-mcp
`

$3

`bash
npm install -g serpex-mcp
`

$3

`bash
npm install serpex-mcp
`

Usage

$3

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

$3

Any MCP-compatible client can use this server. Configure it with:

- Command: npx
- Arguments: -y serpex-mcp
- Environment: SERPEX_API_KEY=your-key

$3

`bash
export SERPEX_API_KEY="your-api-key-here"
serpex-mcp
`

Available Tools

$3

Search the web using Serpex multi-engine API.

Parameters:
- q (required): Search query string
- engine (optional): Choose search engine
- auto (default) - Automatically selects best engine
- google, bing, duckduckgo, brave, yahoo, yandex
- time_range (optional): Filter by time
- all (default), day, week, month, year

Example:
`javascript
{
"q": "artificial intelligence trends 2025",
"engine": "google",
"time_range": "month"
}
`

Getting Your API Key

1. Visit serpex.dev
2. Sign up for a free account
3. Get your API key from the dashboard
4. Use it in the SERPEX_API_KEY environment variable

API Information

- Base URL: https://api.serpex.dev
- Documentation: https://serpex.dev/docs
- Pricing: Free tier available, affordable paid plans

Development

$3

`bash
git clone https://github.com/divyeshradadiya/serpex-mcp.git
cd serpex-mcp
pnpm install
pnpm build
`

$3

`bash
export SERPEX_API_KEY="your-key-here"
pnpm test
``

License

MIT

Links

- Serpex Website
- Serpex Documentation
- Model Context Protocol
- MCP Specification