HN Who is hiring
Search and compare Hacker News Who is hiring posts as structured job data
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About HN Who is hiring
HN Who is hiring is an open-source MCP server for hiring and recruiting. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add hn-hiring-mcp -- npx -y hn-hiring-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"hn-hiring-mcp": {
"command": "npx",
"args": [
"-y",
"hn-hiring-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hn-hiring-mcp": {
"command": "npx",
"args": [
"-y",
"hn-hiring-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hn-hiring-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hn-hiring-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hn-hiring-mcp": {
"command": "npx",
"args": [
"-y",
"hn-hiring-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hn-hiring-mcp": {
"command": "npx",
"args": [
"-y",
"hn-hiring-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
HN_HIRING_MCP_CACHE_DIRDirectory for the response cache (default ~/.cache/hn-hiring-mcp; "off" disables the disk cache)
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Open source
Free, MIT licensed
HN Who is hiring 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.
