Scout MCP

scout-mcp

An MCP server that searches 21 platforms in parallel and returns structured JSON. Built with the Model Context Protocol SDK.

Connect it to Claude Desktop, VS Code, Cursor, or any MCP client and search code registries, academic papers, social platforms, and tech blogs from a single tool call.

Tools

Quick start

Claude Desktop / VS Code / Cline

git clone https://github.com/bartonguestier1725-collab/scout-mcp.git
cd scout-mcp && npm install && npm run build

Add to your MCP client config:

{
  "mcpServers": {
    "scout": {
      "command": "node",
      "args": ["/absolute/path/to/scout-mcp/build/index.js"]
    }
  }
}

Docker

docker build -t scout-mcp .
docker run -i scout-mcp

The Dockerfile builds a minimal node:24-alpine image that runs the MCP server over stdio.

Configuration

All configuration is via environment variables. Most tools work without any keys. Optional keys unlock additional sources or raise rate limits.

How it works

Each tool makes a direct API call to its source, parses the response, and returns normalized JSON with consistent fields (title, url, source, created_at, etc.). The scout_report tool runs multiple searches in parallel using Promise.allSettled, so one source failing doesn't block the others.

Transport: stdio (standard MCP transport). The server reads JSON-RPC messages from stdin and writes responses to stdout.

HTTP mode

scout-mcp also runs as a paid HTTP API at https://scout.hugen.tokyo via the x402 protocol (USDC micropayments on Base). This mode uses the same tool implementations but exposes them as REST endpoints with payment middleware.

License

MIT