🔍 web-search-plus-mcp
Multi-provider web search, URL extraction, and optional cited answers for MCP clients.
web-search-plus-mcp is the standalone MCP packaging of Web Search Plus. It gives Claude Desktop, Cursor, NanoBot, Hermes native MCP, and other MCP-compatible hosts the same provider family used by the Hermes/OpenClaw Web Search Plus tools.
Version note: web-search-plus-mcp uses its own MCP package version (0.5.1) while tracking the Web Search Plus engine family (v1.9.x). The Hermes plugin is versioned separately as hermes-web-search-plus v1.9.x.
✨ Features
- 11 search providers — Serper, Brave, Tavily, Exa, Querit, Linkup, Firecrawl, native Perplexity, Kilo Perplexity, You.com, SearXNG
- 5 extract providers — Linkup, Firecrawl, Tavily, Exa, You.com
- Optional beta
web_answer— cited source-backed briefs when you explicitly want synthesis instead of raw results - Intelligent auto-routing — scores query intent and picks a provider automatically
- Quality reports — optional routing/result diagnostics
- Research mode — opt-in multi-provider search + top-source extraction with a time budget
- Onboarding CLI —
status,list,setup, and persistent routingconfighelpers for MCP env/config wiring - Zero-install run —
uvx web-search-plus-mcp - MCP-native — stdio server exposing
web_search,web_extract, and opt-inweb_answer
🚀 Quick Start
# Run the MCP server instantly with uvx
uvx web-search-plus-mcp
# Or install globally
pip install web-search-plus-mcp
web-search-plus-mcp
At least one provider credential is required for search. Extraction needs at least one extraction-capable provider key.
🧭 Easier onboarding
Check configured providers:
web-search-plus-mcp status
List providers or presets:
web-search-plus-mcp list providers
web-search-plus-mcp list presets
Write a starter .env template and print a canonical MCP stdio snippet:
web-search-plus-mcp setup --preset starter
The recommended starter preset is Tavily + Linkup + Brave. It gives a practical baseline for search, extraction, and cited-answer experiments without wiring every provider on day one.
Add --enable-answer if you want the generated .env and snippet to opt into the beta web_answer tool:
web-search-plus-mcp setup --preset starter --enable-answer
status returns a non-zero exit code when no search provider is configured, which makes it usable as a config check in scripts.
Persistent routing preferences live in config.json rather than .env:
web-search-plus-mcp config show
web-search-plus-mcp config set-default brave # strict fixed-provider mode
web-search-plus-mcp config set-routing on # restore auto-routing
web-search-plus-mcp config set-priority tavily,linkup,brave
web-search-plus-mcp config set-fallback tavily
web-search-plus-mcp config disable perplexity
web-search-plus-mcp config enable perplexity
web-search-plus-mcp config disable kilo-perplexity
web-search-plus-mcp config set-threshold 0.45
web-search-plus-mcp config reset --yes
Use --config-path /path/to/config.json or WEB_SEARCH_PLUS_CONFIG=/path/to/config.json for isolated MCP host installs. Provider secrets stay in environment variables; routing behavior stays in config.json.
Other presets:
minimal— Brave onlylean— Tavily + Linkupstarter— Tavily + Linkup + Braveall— every supported provider env var
⚙️ MCP host config
Canonical stdio snippet for Claude Desktop, Cursor, NanoBot, or Hermes native MCP:
{
"mcpServers": {
"web-search-plus": {
"command": "uvx",
"args": ["web-search-plus-mcp"],
"env": {
"LINKUP_API_KEY": "your_linkup_key",
"TAVILY_API_KEY": "your_tavily_key",
"BRAVE_API_KEY": "your_brave_key"
}
}
}
}
WSP_ENABLE_WEB_ANSWER=1 is optional. Without it, the MCP server exposes only the stable web_search and web_extract tools.
Common places to paste this snippet:
- Claude Desktop macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop Windows:
%APPDATA%\\Claude\\claude_desktop_config.json - Claude Desktop Linux:
~/.config/Claude/claude_desktop_config.json - Cursor: project/user MCP config using the same
mcpServersshape - Hermes native MCP:
~/.hermes/config.yamlundermcp_serverswith equivalent command/env fields
You can also place a .env file next to the package/project with the same variables.
🔎 Search Providers
- Serper — Google-style facts, news, shopping, local queries
- Brave — general-purpose independent web index
- Tavily — research and analysis
- Exa — semantic discovery, similarity, deep/deep-reasoning synthesis
- Querit — multilingual, real-time AI search
- Linkup — source-backed grounding/citations
- Firecrawl — web search plus scrape-ready content
- Perplexity — native Perplexity API direct synthesized answers (
PERPLEXITY_API_KEY,sonar-pro) - Kilo Perplexity — Perplexity via Kilo gateway (
KILOCODE_API_KEY,perplexity/sonar-pro) - You.com — LLM-ready real-time snippets
- SearXNG — privacy-first self-hosted meta-search
📄 Extract Providers
- Linkup — recommended first choice for clean markdown and low cost
- Firecrawl — robust scrape fallback, useful for JS-heavy/blocked pages
- Tavily — extraction/content API
- Exa — contents API
- You.com — LLM-ready snippets/content where available
🛠 MCP Tool Reference
This MCP server exposes web_search and web_extract by default. It exposes web_answer only when WSP_ENABLE_WEB_ANSWER=1 is set.
The Hermes plugin exposes the same capability as web_search_plus, web_extract_plus, and web_answer_plus; the names differ because MCP and Hermes use different tool surfaces.
web_search
Use for source discovery, current events, prices, weather, sports lineups, schedules, and whenever you want the raw search landscape first.
Parameters:
query— required search queryprovider—auto,serper,brave,tavily,exa,querit,linkup,firecrawl,perplexity,kilo-perplexity,you,searxngcount— results to return, default5, max20depth— Exa depth:normal,deep,deep-reasoningtime_range—hour,day,week,month,yearinclude_domains/exclude_domains— domain allow/deny listsmode—normalorresearchquality_report— include routing/result diagnosticsresearch_time_budget— best-effort wall-clock budget for research mode
Example MCP arguments:
{
"query": "latest Hermes Agent release",
"provider": "linkup",
"count": 5,
"quality_report": true
}
web_extract
Parameters:
urls— required list of URLsprovider—auto,firecrawl,linkup,tavily,exa,youformat—markdownorhtmlinclude_images— include image metadata when supportedinclude_raw_html— include raw HTML when supportedrender_js— render JavaScript before extraction when supported
Example MCP arguments:
{
"urls": ["https://example.com"],
"provider": "linkup",
"format": "markdown"
}
web_answer optional beta
Use when you specifically want a short cited synthesis. Do not use it as a default replacement for web_search.
web_answer is slower than web_search because it searches, selects sources, and may extract top URLs. Its freshness default is none to avoid over-triggering recency filters on evergreen questions.
Parameters:
query— required question/topicmode—quickordeep, defaultquicksources— citation-ready source target, default3, max10freshness—none,auto,day,week,month,year, defaultnonemax_extracts— top URLs to extract, default2, max5output—answer,brief,sources, orjson
Enable it:
{
"env": {
"WSP_ENABLE_WEB_ANSWER": "1",
"LINKUP_API_KEY": "your_linkup_key",
"TAVILY_API_KEY": "your_tavily_key"
}
}
Example MCP arguments:
{
"query": "What changed in Hermes Agent's latest release?",
"mode": "quick",
"sources": 3,
"freshness": "none"
}
🧠 Auto-Routing Examples
iPhone 16 Pro price→ Serper/Brave shopping-style searchhow does TCP/IP work→ Tavily research-style searchlatest multilingual EV market updates→ Querit/Linkup real-time/source-backed searchcompanies like Stripe→ Exa discovery searchwhat is quantum computing→ Perplexity/You.com direct-answer style searchprivacy focused search results→ SearXNG when configured
Credits
Built on the Web Search Plus routing logic originally developed for OpenClaw/Clawhub and later ported to Hermes as hermes-web-search-plus.
License
MIT © 2026 robbyczgw-cla
Metadata
Release files for web-search-plus-mcp 0.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| web_search_plus_mcp-0.5.1.tar.gz | 948.4 kB | Without provenance | Details for web_search_plus_mcp-0.5.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| web_search_plus_mcp-0.5.1-py3-none-any.whl | Python 3 | none | any | Details for web_search_plus_mcp-0.5.1-py3-none-any.whl |
Total release size: 1.0 MB
Release files / web_search_plus_mcp-0.5.1.tar.gz
| Download URL | web_search_plus_mcp-0.5.1.tar.gz |
|---|---|
| Size | 948.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
55af81e9d9ba0f843decb6385fc4ebe2517257544ef8dcb6485fdb2cc6cb927f
|
|
BLAKE2b-256 checksum How to use checksums |
066fcda88ce164f3e42fafb04205bfc06f064c8640d877911cb76c337a08d8b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / web_search_plus_mcp-0.5.1-py3-none-any.whl
| Download URL | web_search_plus_mcp-0.5.1-py3-none-any.whl |
|---|---|
| Size | 51.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b32f79c9f55b16093b72bea2fbe8d25d98d1e1b7a58822ad400fc978cf47f675
|
|
BLAKE2b-256 checksum How to use checksums |
14899aaddf518fe96f360fc075a8c25deb61ad8a829f290b4c0cf9860e780376
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for web-search-plus-mcp 0.5.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.