Serpex MCP

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

Quick Start (npx - Recommended)

No installation needed! Use npx to run directly:

npx serpex-mcp

Global Installation

npm install -g serpex-mcp

Local Installation

npm install serpex-mcp

Usage

With Claude Desktop

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

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

With Other MCP Clients

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

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

Standalone

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

Available Tools

serpex_search

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:

{
  "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

Build from Source

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

Run Tests

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

License

MIT

Links

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