# HN Who is hiring

> HN Who is hiring is an open-source MCP server for hiring and recruiting. Search and compare Hacker News Who is hiring posts as structured job data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/crayz129/hn-hiring-mcp
- **MCP Registry name:** io.github.Crayz129/hn-hiring-mcp
- **Categories:** [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting)
- **Listing updated:** 2026-11-18

## About

Hacker News job posts in the monthly Ask HN thread are free-form comments, and HN's own API only returns items by id. This server parses each top-level post into fields such as company, roles, location, remote, hybrid or onsite mode, salary, visa sponsorship and technologies, so questions like remote Python roles in Europe that state a salary can actually be answered.

Four read-only tools declare input and output JSON schemas and return clear errors such as INVALID_INPUT or NOT_FOUND. Data comes from the public HN Algolia API, which returns a whole thread of roughly 250 posts per request; requests are spaced at least one second apart, cached in memory and on disk, and threads older than 45 days are kept permanently while the current month refreshes hourly.

Parsing is best-effort, so headline and hn_url are always included for checking. Email addresses in posts are replaced with a placeholder, poster usernames are not returned, and the server does not apply to jobs for you. It needs Node.js 22 or newer and is MIT licensed.

## Features

- **Structured job posts:** Extracts company, roles, location, work mode, salary, visa and technologies.
- **Filtered search:** Filter by text, location, work mode, technologies, salary and visa.
- **Technology trends:** Shows monthly share of posts mentioning each technology.
- **Polite caching:** Spaces requests, caches responses and keeps old threads permanently.
- **Email redaction:** Replaces addresses in posts with a placeholder.
- **Read-only:** No logins, accounts or applying on anyone's behalf.

## Good for

- Find remote Python roles that state a salary
- Check whether demand for a technology is growing
- List jobs offering visa sponsorship in a region
- Read the full text of one interesting post

## Install

### Claude Code (Terminal)

```sh
claude mcp add hn-hiring-mcp -- npx -y hn-hiring-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hn-hiring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hn-hiring-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hn-hiring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hn-hiring-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hn-hiring-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hn-hiring-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hn-hiring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hn-hiring-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hn-hiring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hn-hiring-mcp"
      ]
    }
  }
}
```

## Tools

- `list_hiring_threads`: Lists the latest monthly threads with ids and comment counts
- `search_jobs`: Searches one month's posts with filters and returns compact summaries
- `get_job`: Returns full text and parsed fields of one post
- `hiring_trends`: Per-month technology mention share and work-mode counts

## FAQ

### Where does the data come from?

From the public HN Algolia API.

### Can it apply for jobs?

No. It is read-only; you follow the HN link to apply.

### Are poster usernames returned?

No, and email addresses in posts are replaced with a placeholder.

### What does it need?

Node.js 22 or newer.

### Is HN Who is hiring free?

Yes. HN Who is hiring is open source, so you can use and self-host it for free.

### How do I add HN Who is hiring to Claude Code?

Run this command in your terminal: claude mcp add hn-hiring-mcp -- npx -y hn-hiring-mcp

### What are the best alternatives to HN Who is hiring?

The closest alternatives to HN Who is hiring are Reactive Resume, Joboracle, OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages, Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions and Workday Jobs Scraper & API - All Companies, Last 24 Hours.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Joboracle](https://ai-powered.com/mcp/joboracle): Joboracle is a freemium MCP server for hiring and recruiting.
- [OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages](https://ai-powered.com/mcp/onlinejobs-ph-scraper-apify-philippine-remote-and-va-jobs-wi): OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages is a paid MCP server for web search and scraping.
- [Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions](https://ai-powered.com/mcp/gupy-jobs-scraper-apify-brazil-jobs-with-descriptions): Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions is a freemium MCP server for web search and scraping.
- [Workday Jobs Scraper & API - All Companies, Last 24 Hours](https://ai-powered.com/mcp/workday-jobs-scraper-and-api-all-companies-last-24-hours): Workday Jobs Scraper & API - All Companies, Last 24 Hours is a freemium MCP server for web search and scraping.
- [Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours](https://ai-powered.com/mcp/lever-jobs-scraper-and-api-salary-remote-last-24-hours): Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours is a paid MCP server for web search and scraping.
- [Workable Jobs Scraper & API - All Companies, Remote, 24 Hours](https://ai-powered.com/mcp/workable-jobs-scraper-and-api-all-companies-remote-24-hours): Workable Jobs Scraper & API - All Companies, Remote, 24 Hours is a freemium MCP server for web search and scraping.
- [Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs](https://ai-powered.com/mcp/y-combinator-jobs-scraper-and-api-work-at-a-startup-yc-jobs): Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/hn-who-is-hiring
