MCP Server

serpex-mcp is an MCP (Model Context Protocol) server that exposes Serpex search as a tool for AI agents. Once configured, agents like Claude can call serpex_search directly to perform live web research without leaving their context window.

Package: serpex-mcp on npm — v1.0.2

What the MCP Server Provides

The server exposes one tool:

• serpex_search — search the web and get structured JSON results with titles, URLs, and snippets

AI agents call this tool the same way they call any function. The results come back as structured JSON that the agent can reason over directly.

Setup with Claude Desktop

Add the following to your Claude Desktop configuration file.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving. The serpex_search tool will appear in the tool list automatically.

Setup with Other MCP Clients

Any MCP-compatible client (Cursor, Windsurf, Continue, etc.) can use the same configuration pattern:

• Command: npx
• Arguments: -y serpex-mcp
• Environment variable: SERPEX_API_KEY=sk_your_api_key

Available Tool: serpex_search

Input Schema

Example Tool Call

{
  "q": "artificial intelligence trends 2025",
  "engine": "auto",
  "time_range": "month"
}

Example Response

The tool returns a JSON string with the search results:

{
  "query": "artificial intelligence trends 2025",
  "engines": ["duckduckgo"],
  "total_results": 10,
  "results": [
    {
      "title": "AI Trends to Watch in 2025",
      "url": "https://example.com/ai-trends",
      "snippet": "The most significant AI developments of 2025 include...",
      "position": 1,
      "engine": "duckduckgo"
    }
  ],
  "suggestions": []
}

Standalone Usage

You can also run the MCP server directly from the command line for testing or custom integrations:

export SERPEX_API_KEY="sk_your_api_key"
npx serpex-mcp

The server communicates over stdio using the MCP protocol.

Getting an API Key

1. Sign up at serpex.dev
2. Go to your dashboard
3. Create an API key from the API Keys section
4. Set it as SERPEX_API_KEY in the MCP server config

Links

• npm package
• Model Context Protocol
• Search API Reference