# bartonguestier1725-collab/scout-mcp [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/bartonguestier1725-collab/scout-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 24  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bartonguestier1725-collab-scout-mcp

## Description
Multi-source search across code registries (GitHub, npm, PyPI), academic indexes (arXiv, Semantic Scholar), social platforms (HN, Reddit, X), and community blogs (Dev.to, Hashnode, Qiita, Zenn). Parallel fetch with structured JSON output. npx -y scout-cli.

## Tools
Capabilities this server exposes over MCP:

- **hackernews_search** — Stories, comments, polls
- **github_search** — Repositories by keyword
- **github_repo_info** — Single repo details
- **npm_search** — Packages
- **pypi_search** — Python packages
- **producthunt_search** — Products by topic
- **x_search** — AI-powered via xAI Grok (requires `XAI_API_KEY`)
- **devto_search** — Articles
- **hashnode_search** — Articles (GraphQL)
- **lobsters_search** — Stories
- **stackexchange_search** — Q&A across all sites
- **arxiv_search** — Academic papers
- **reddit_search** — Posts and comments
- **youtube_search** — Videos (requires `YOUTUBE_API_KEY`)
- **zenn_search** — Japanese tech articles
- **qiita_search** — Japanese tech articles
- **semantic_scholar_search** — Academic papers
- **lemmy_search** — Fediverse posts
- **gitlab_search** — Projects
- **bazaar_search** — x402 API directory
- **scout_report** — Parallel search across selected sources

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "scout-mcp": {
    "command": "npx",
    "args": ["-y","scout-cli"],
    "env": {
      "XAI_API_KEY": "",
      "GITHUB_TOKEN": "",
      "YOUTUBE_API_KEY": "",
      "PH_CLIENT_ID": "",
      "PH_CLIENT_SECRET": "",
      "REDDIT_CLIENT_ID": "",
      "REDDIT_CLIENT_SECRET": "",
      "QIITA_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `XAI_API_KEY`, `GITHUB_TOKEN`, `YOUTUBE_API_KEY`, `PH_CLIENT_ID`, `PH_CLIENT_SECRET`, `REDDIT_CLIENT_ID`, `REDDIT_CLIENT_SECRET`, `QIITA_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# scout-mcp

An MCP server that searches 21 platforms in parallel and returns structured JSON. Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-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

| Tool | Source | Notes |
|------|--------|-------|
| `hackernews_search` | Hacker News (Algolia) | Stories, comments, polls |
| `github_search` | GitHub | Repositories by keyword |
| `github_repo_info` | GitHub | Single repo details |
| `npm_search` | npm Registry | Packages |
| `pypi_search` | PyPI | Python packages |
| `producthunt_search` | Product Hunt | Products by topic |
| `x_search` | X / Twitter | AI-powered via xAI Grok (requires `XAI_API_KEY`) |
| `devto_search` | Dev.to | Articles |
| `hashnode_search` | Hashnode | Articles (GraphQL) |
| `lobsters_search` | Lobste.rs | Stories |
| `stackexchange_search` | StackExchange | Q&A across all sites |
| `arxiv_search` | ArXiv | Academic papers |
| `reddit_search` | Reddit | Posts and comments |
| `youtube_search` | YouTube | Videos (requires `YOUTUBE_API_KEY`) |
| `zenn_search` | Zenn | Japanese tech articles |
| `qiita_search` | Qiita | Japanese tech articles |
| `semantic_scholar_search` | Semantic Scholar | Academic papers |
| `lemmy_search` | Lemmy | Fediverse posts |
| `gitlab_search` | GitLab | Projects |
| `bazaar_search` | x402 Bazaar | x402 API directory |
| `scout_report` | Multi-source | Parallel search across selected sources |

## Quick start

### Claude Desktop / VS Code / Cline

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

Add to your MCP client config:

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

### Docker

```bash
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.

| Variable | Required | Description |
|----------|----------|-------------|
| `XAI_API_KEY` | For `x_search` | xAI API key for X/Twitter search |
| `GITHUB_TOKEN` | Recommended | Raises GitHub rate limit |
| `YOUTUBE_API_KEY` | For `youtube_search` | YouTube Data API v3 key |
| `PH_CLIENT_ID` / `PH_CLIENT_SECRET` | For `producthunt_search` | Product Hunt API credentials |
| `REDDIT_CLIENT_ID` / `REDDIT_CLIENT_SECRET` | For `reddit_search` | Reddit API credentials |
| `QIITA_TOKEN` | Optional | Raises Qiita rate limit |
| `S2_API_KEY` | Optional | Semantic Scholar dedicated rate limit |
| `SE_API_KEY` | Optional | StackExchange dedicated rate limit |

## 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](https://x402.org) (USDC micropayments on Base). This mode uses the same tool implementations but exposes them as REST endpoints with payment middleware.

## License

MIT