What can you do with this server?

One-line summary: Serpex MCP gives AI agents web search (with optional inline page content) and clean markdown/HTML extraction of known URLs, backed by the Serpex API and requiring a SERPEX_API_KEY. * Web search (serpex_search): run ranked web searches via Serpex's own engine, with results from Google, Bing, DuckDuckGo, Brave, Yahoo, and Yandex. * Search querying: pass a required query q (up to 500 characters). * Engine selection: choose an engine via engine (auto, google, bing, duckduckgo, brave, yahoo, yandex; default auto). * Freshness filtering: narrow results by time with time_range (all, day, week, month, year). * Structured results: get consistent JSON with status (success/no_results), total_results, credits_used, and per-result data. * Optional inline page content (README): set include_content: true to also fetch top results' pages as markdown, with content_results (exactly 5 or 10); failures return content_error. * Page extraction (README): serpex_extract turns 1–10 known absolute http(s) URLs into clean markdown (or HTML via format), returning per-URL success/error plus credits_used (can take up to ~1 minute). * Client integration (README): works with Claude Desktop, Jan AI, and any MCP-compatible client, runnable via npx serpex-mcp or a global/local install.

Which integrations are available for this server?

Provides web search capabilities through Brave's search engine, accessible via the Serpex API with support for time-based filtering and structured JSON results Enables web search functionality through DuckDuckGo's search engine, accessible via the Serpex API with support for time-based filtering and structured JSON results Provides web search capabilities through Google's search engine, accessible via the Serpex API with support for time-based filtering and structured JSON results

How do I use Serpex MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Serpex MCP find recent articles about quantum computing breakthroughs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Serpex MCP

npm version License: MIT

A Model Context Protocol (MCP) server that gives AI agents web search and page extraction through Serpex. Serpex is a web search API and extract API for AI agents. Search returns ranked web results, optionally with page content as markdown; Extract turns known URLs into clean markdown. Serpex runs its own search engine.

Features

✅ Web Search: Ranked web results, nothing to configure
✅ Page Content: Optionally fetch the top results' pages as markdown in the same call
✅ Structured Results: Clean, consistent JSON responses
✅ Easy Integration: Works with Claude Desktop, Jan AI, and any MCP-compatible client

Related MCP server: Serper Search and Scrape MCP Server

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 with Serpex. Optionally fetches full page content (markdown) for the top results inline with the search — best-effort, so check each result for content vs content_error.

Parameters:

q (required): Search query string (max 500 characters)
include_content (optional, boolean): Also fetch full page content (markdown) for the top results. Best-effort — pages that can't be extracted return content_error instead. Default: false.
content_results (optional, 5 | 10): Number of top results to fetch content for, when include_content is true. Must be exactly 5 or 10. Default: 5.

Example:

{
  "q": "artificial intelligence trends 2025",
  "include_content": true,
  "content_results": 5
}

Response (JSON, as tool output text) includes status (success or no_results), total_results, credits_used, a message when nothing was found, content_requested / content_delivered counts and, per result, content on success or content_error on failure — both keys are omitted when content wasn't requested.

`serpex_extract`

Extract the content of known web pages as clean markdown (or HTML).

Parameters:

urls (required): 1 to 10 absolute http(s) URLs.
format (optional, markdown | html): Output format. Default: markdown.

Example:

{
  "urls": ["https://example.com/pricing"],
  "format": "markdown"
}

Response (JSON, as tool output text) includes successful, failed, credits_used and, per URL, success plus markdown / html, or error when the page could not be extracted. Extract calls can take up to about a minute, so the server waits up to 100 s.

Getting Your API Key

Visit serpex.dev
Sign up for a free account
Get your API key from the dashboard
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

Available Tools

1 tool

serpex_searchB

Search the web using Serpex API. Returns structured search results from multiple engines (Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex).

ParametersJSON Schema

Name	Required	Description
`q`	Yes	Search query (max 500 characters)
`engine`	No	Search engine (default: auto)
`time_range`	No	Filter by time range

TDQS

B3.2/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions the API and return type (structured results from multiple engines), but fails to disclose critical traits such as rate limits, authentication needs, error handling, or pagination. For a search tool with no annotation coverage, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the core purpose ('Search the web using Serpex API') and adds necessary detail ('Returns structured search results from multiple engines'). Every word earns its place with no redundancy or waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a search API tool with no annotations and no output schema, the description is incomplete. It lacks information on response format, error cases, rate limits, and authentication requirements. While the input schema is well-covered, the overall context for effective tool use is insufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with all parameters well-documented in the input schema (e.g., query max length, engine options, time range enums). The description adds no additional parameter semantics beyond what the schema provides, so it meets the baseline of 3 for high schema coverage without compensating value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Search the web') and resource ('using Serpex API'), specifying it returns structured results from multiple engines. It's specific about the verb and resource, but since there are no sibling tools, it doesn't need to distinguish from alternatives, making it clear but not requiring sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for web searching with structured results from multiple engines, but provides no explicit guidance on when to use this tool versus alternatives (e.g., other search methods or APIs). Since there are no sibling tools, it doesn't need to differentiate, but it lacks context on optimal use cases or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

1 tool updateNov 17, 2025
- First observedserpex_search

Deploy Server

Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

TDQS

B3.3/5.0

Scored 2026-04-18 08:20 across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool has a clear and distinct purpose: searching the web using the Serpex API.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect. The tool name 'serpex_search' follows a clear and logical pattern, combining the server name with the action.

Tool Count2/5

A single tool is too few for a web search server, as it lacks essential operations like filtering results, handling pagination, or accessing specific search engines individually. This minimal set limits functionality and may cause agent failures in complex tasks.

Completeness2/5

The tool surface is severely incomplete for a web search domain. While the search tool exists, there are significant gaps such as no ability to refine searches, manage result formats, or perform advanced queries, which are common in search APIs.

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Reddit Discussion

Related Servers

Related MCP Connectors

Search1API AOAuth
io.github.superagents-lab
Web search, agentic search, news, page retrieval, sitemaps, and trending topics through Search1API.
Search Browser Automation
1173
Litescrape A
com.litescrape
Google, Bing, DuckDuckGo and Google Maps search results, free without an API key.
Search Browser Automation
101
seltz-ai-seltz-mcpOAuth
ai.seltz
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Search Browser Automation Web Scraping
2
agentsearch-mcp A
io.github.IsaiahDupree
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
Search RAG Systems Browser Automation
31

Related MCP Servers

Web Search MCP Server
Search Browser Automation Web Scraping
vishalkg
F
license
Not graded
quality
D
maintenance
Enables web search across multiple search engines (DuckDuckGo, Bing, Startpage) with parallel execution and result deduplication. Also provides web page content extraction capabilities.
Updated 3 months ago (2026-07-07 21:39 UTC)
2
-
Serper Search and Scrape MCP
Search Web Scraping Browser Automation
tahaswx
A
license
B
quality
D
maintenance
Enables web search via Serper API with advanced search operators and webpage scraping capabilities to extract content in plain text or markdown format.
Updated 2 years ago (2025-03-13 00:28 UTC)
2
1,865 npm
MIT
MCP MixSearch
Search Browser Automation Web Scraping
geosp
A
license
A
quality
D
maintenance
Enables advanced web search across multiple search engines (Brave, DuckDuckGo, Google, Bing, Yandex) with intelligent backend selection, full content extraction, and advanced filtering by time, language, geography, and content type.
Updated a year ago (2025-11-09 08:48 UTC)
3
MIT
SerpApi MCP Server
Search Browser Automation
MCP-Mirror
F
license
Not graded
quality
Not graded
maintenance
Enables searching across multiple search engines (Google, Bing, YouTube, DuckDuckGo, etc.) and retrieving parsed search results via SerpApi integration.
Updated a year ago (2025-06-25 18:17 UTC)
-

Serpex MCP

Features

Installation

Quick Start (npx - Recommended)

Global Installation

Local Installation

Usage

With Claude Desktop

With Other MCP Clients

Standalone

Available Tools

serpex_search

serpex_extract

Getting Your API Key

API Information

Development

Build from Source

Run Tests

License

Links

Available Tools

TDQS

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Web Search MCP Server

Serper Search and Scrape MCP

MCP MixSearch

SerpApi MCP Server

Appeared in Searches

`serpex_search`

`serpex_extract`