home / mcp / web scout mcp server

Web Scout MCP Server

A powerful MCP server extension providing web search and content extraction capabilities. Integrates DuckDuckGo search functionality and URL content extraction into your MCP environment, enabling AI assistants to search the web and extract webpage content programmatically.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pinkpixel-dev-web-scout-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/web-scout-mcp@latest"
      ],
      "env": {
        "WEB_SCOUT_DISABLE_AUTOSTART": "1"
      }
    }
  }
}

You are running the Web Scout MCP Server, which provides a focused web search capability using DuckDuckGo and clean content extraction. It supports parallel processing for multiple URLs, smart memory management, and safeguards against API blocks, making it useful for building search-enabled apps and MCP clients.

How to use

You will run the server alongside your MCP client. Start the server in stdio mode and connect via your MCP client configuration. The server exposes tools for web searching and page content extraction, enabling you to perform searches and retrieve readable text from URLs in a scalable way. When integrated with clients like Claude Desktop or Cursor, you can execute searches and fetch extracted content as part of your workflow.

How to install

Prerequisites: make sure you have Node.js version 18.0.0 or newer installed on your system. You also need npm or yarn to manage packages.

Install the server globally so you can run it from anywhere:

npm install -g @pinkpixel/web-scout-mcp

If you prefer to install it locally in a project, run:

npm install @pinkpixel/web-scout-mcp

If you are integrating with a client that uses the Smithery installer, you can install it for a specific client automatically with:

npx -y @smithery/cli install @pinkpixel-dev/web-scout-mcp --client claude

To run the server after installation, use the standard command:

web-scout-mcp

Client configuration and examples

Connect this MCP server to your MCP client by adding an MCP server entry in your client configuration. Use the provided stdio command so the client can launch the server as a local process.

{
  "mcpServers": {
    "web_scout": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/web-scout-mcp@latest"
      ]
    }
  }
}

Environment variables

Set the WEB_SCOUT_DISABLE_AUTOSTART environment variable to 1 when embedding the package and creating the server programmatically. By default, starting the published entrypoint (for example via node dist/index.js or npx @pinkpixel/web-scout-mcp) will bootstrap the stdio transport automatically.

Available tools

DuckDuckGoWebSearch

Initiates a web search query using DuckDuckGo and returns a structured list of findings with titles, URLs, and snippets.

UrlContentExtractor

Fetches and extracts clean, readable content from web pages, stripping scripts, styles, and navigation to produce readable text.