Skip to main content

Multi-provider web search MCP server with intelligent auto-routing (Serper, Tavily, Querit, Exa, Perplexity, You.com, SearXNG)

Project description

🔍 web-search-plus-mcp

PyPI version Python 3.10+ MCP License: MIT

Multi-provider web search MCP server with intelligent auto-routing.

A Model Context Protocol server that gives AI assistants access to 7 search providers with intelligent auto-routing. Analyzes query intent and picks the best provider automatically — no manual switching needed. Install, configure your keys, and go.

✨ Features

  • Intelligent auto-routing — analyzes query intent and picks the best provider automatically
  • 7 search providers — use one or all, graceful fallback if any key is missing
  • Zero install option — run instantly with uvx web-search-plus-mcp
  • MCP-native — works with Claude Desktop, NanoBot, and any MCP-compatible host

🔎 Supported Providers

Provider Best for Free tier
Serper (Google) Facts, news, shopping, local businesses 2,500 queries/month
Tavily Deep research, analysis, explanations 1,000 queries/month
Querit Multi-lingual AI search with rich metadata and real-time info 1,000 queries/month
Exa (Neural) Semantic discovery, finding similar content 1,000 queries/month
Perplexity AI-synthesized answers with citations Via API key
You.com Real-time RAG, LLM-ready snippets Limited free tier
SearXNG Privacy-first, self-hosted, $0 cost Free (self-hosted)

🧠 Auto-Routing Examples

Query Routed to Why
"iPhone 16 Pro price" Serper Shopping intent detected
"how does TCP/IP work" Tavily Research/explanation intent
"latest multilingual EV market updates" Querit Real-time AI search
"companies like Stripe" Exa Discovery/semantic intent
"what is quantum computing" Perplexity Direct answer intent

🚀 Quick Start

# Run instantly with uvx (no install needed)
uvx web-search-plus-mcp

# Or install globally with pip
pip install web-search-plus-mcp
web-search-plus-mcp

⚙️ Claude Desktop Config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "web-search-plus": {
      "command": "uvx",
      "args": ["web-search-plus-mcp"],
      "env": {
        "SERPER_API_KEY": "your_serper_key",
        "TAVILY_API_KEY": "your_tavily_key",
        "QUERIT_API_KEY": "your_querit_key",
        "EXA_API_KEY": "your_exa_key",
        "PERPLEXITY_API_KEY": "your_perplexity_key",
        "YOU_API_KEY": "your_you_key",
        "SEARXNG_BASE_URL": "https://your-searxng-instance.example.com"
      }
    }
  }
}

🤖 NanoBot Config

Add to your NanoBot config.json under mcp_servers:

{
  "mcp_servers": [
    {
      "name": "web-search-plus",
      "command": "uvx",
      "args": ["web-search-plus-mcp"],
      "env": {
        "SERPER_API_KEY": "your_serper_key",
        "TAVILY_API_KEY": "your_tavily_key",
        "QUERIT_API_KEY": "your_querit_key",
        "EXA_API_KEY": "your_exa_key",
        "PERPLEXITY_API_KEY": "your_perplexity_key",
        "YOU_API_KEY": "your_you_key",
        "SEARXNG_BASE_URL": "https://your-searxng-instance.example.com"
      }
    }
  ]
}

🔑 Environment Variables

Variable Provider Sign up
SERPER_API_KEY Serper (Google) console.serper.dev
TAVILY_API_KEY Tavily tavily.com
QUERIT_API_KEY Querit querit.ai
EXA_API_KEY Exa exa.ai
PERPLEXITY_API_KEY Perplexity docs.perplexity.ai
YOU_API_KEY You.com you.com/api
SEARXNG_BASE_URL SearXNG (self-hosted) docs.searxng.org

At least one provider is required. More providers = better routing coverage. SearXNG needs no API key — just point SEARXNG_BASE_URL at your self-hosted instance.

You can also drop a .env file next to the server:

SERPER_API_KEY=xxx
TAVILY_API_KEY=xxx
QUERIT_API_KEY=xxx
EXA_API_KEY=xxx
PERPLEXITY_API_KEY=xxx
YOU_API_KEY=xxx
SEARXNG_BASE_URL=https://your-searxng-instance.example.com

🛠 Tool Reference

web_search

Parameter Type Default Description
query string required Search query
provider string "auto" Force a provider: auto, serper, tavily, querit, exa, perplexity, you, searxng
count integer 5 Number of results to return

Credits

Built on the web-search-plus routing logic — a multi-provider search skill for OpenClaw with intelligent auto-routing.

License

MIT © 2026 robbyczgw-cla

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

web_search_plus_mcp-0.1.1.tar.gz (30.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

web_search_plus_mcp-0.1.1-py3-none-any.whl (32.5 kB view details)

Uploaded Python 3

File details

Details for the file web_search_plus_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: web_search_plus_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 30.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for web_search_plus_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 21ec8a5cd6d8f0282f83ce9f0e758981955244e468c57ca2cb478e0f1e79f67f
MD5 f90471c1208a4566a057fb6cd5db1b43
BLAKE2b-256 6b4591a3ad691e28c712064b89fbdff9fe50e76cbf86ed4e79a8dfde230e30ed

See more details on using hashes here.

File details

Details for the file web_search_plus_mcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for web_search_plus_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f25f629c6c9348ebaaeb2235def3ba92b5279251ee73ac1ee7c21fffa8cbf98f
MD5 3bf28c398bce91b6e0ff630e59303a88
BLAKE2b-256 ed95bd074d32859b07d83cf5682f5c44af51f109b0c1feb02fd3453ccd8b5d8d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page