Home

Web Search MCP

web-search-mcp is a FastMCP server providing web search, content extraction, and research tools for LLM clients. It implements the Model Context Protocol (MCP) to give LLMs access to real-time web information across multiple free data sources.

Quick Start

Prerequisites

• Python and uv for dependency management

Installation

git clone https://github.com/sydasif/web-search-mcp.git
cd web-search-mcp
uv sync

Running the Server

uv run web-search-mcp

Or via uvx without cloning (configure in your MCP client):

{
  "mcpServers": {
    "web-search-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/sydasif/web-search-mcp.git",
        "web-search-mcp"
      ]
    }
  }
}

Permanent Install (Faster Startup)

uv tool install git+https://github.com/sydasif/web-search-mcp.git
uv tool upgrade web-search-mcp  # update later

Claude Code Plugin

Install the plugin (skills + MCP tools) directly from this repo:

/plugin marketplace add sydasif/web-search-mcp
/plugin install web-search@sydasif-web-search-mcp
/reload-plugins

Once installed, use via namespaced commands:

• /web-search:research — multi-source web research across 7 platforms
• /web-search:debug — structured error debugging with external evidence

Core Capabilities

• Web Search: Fast, raw search results via DuckDuckGo and exa mco end points, plus domain-scoped documentation search.
• Content Extraction: Clean text extraction from URLs with multiple output formats.
• Academic Research: arXiv paper search across all scientific categories.
• Community Signal: Reddit search for real-user experiences and discussions.
• Tech Discourse: Hacker News search for developer opinions and startup discussions.
• Code Discussions: GitHub Issues and PRs search across repositories.
• Real-time Discourse: X/Twitter search for breaking news and community reactions.
• AI Research: Deep research and page analysis via Groq GPT-OSS and Compound systems.
• Developer Tools: Package registry lookups (npm, PyPI, crates.io, Go), error message analysis, technology comparison.

Sources at a Glance

Source	Tools	Auth
DuckDuckGo	search_web, fetch_web_page	None
Exa AI	search_exa	Optional EXA_API_KEY
Reddit	search_reddit	None
Hacker News	search_hackernews	None
GitHub	search_github, get_github_issue	Optional token or gh CLI
Wikipedia	search_wikipedia	None
arXiv	search_arxiv	None
X/Twitter	search_x	AUTH_TOKEN + CT0
Groq	groq_search, groq_analyze	GROQ_API_KEY
Developer	get_package_info, search_packages, analyze_error, compare_technologies	None

---

Architecture | Tools | Tools-Status | Development | Configuration | Plugin