# YubHub

> YubHub is a freemium MCP server for hiring and recruiting. Job-feed builder for AI assistants: create feeds from careers pages, query enriched jobs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19.99 a month
- **Platforms:** CLI, API
- **Website:** https://yubhub.co/developers/
- **Repository:** https://github.com/houtini-ai/yubhub
- **MCP Registry name:** io.github.houtini-ai/yubhub
- **Categories:** hiring and recruiting
- **Listing updated:** 2026-11-15

## About

YubHub turns an employer's careers page into a structured job feed, and this npm package puts that pipeline inside Claude Desktop, Cursor or VS Code. Discovery uses the ATS API where one exists (Greenhouse, Lever, Workable, Pinpoint skip scraping), otherwise a sitemap or crawl, then AI enrichment adds title normalisation, categories, salary extraction and company research before publishing XML and JSON feeds.

The README lists 23 tools in four groups: feed management, scheduling, jobs and market statistics. The statistics tools read open endpoints, so you can ask which cities are hiring most without an account. Everything else needs a YubHub user ID and an API key from the Pro Publisher plan.

On the site, YubHub reports 118,475 enriched roles from 2,849 employers and 30+ public read-only data endpoints.

## Features

- **Feed creation:** Create a feed from a careers page URL and trigger discovery runs.
- **Scheduling:** Check, enable or disable automatic runs, weekly by default.
- **Job browsing:** List jobs by status, open one for salary, skills and description, retry failures.
- **AI enrichment:** Normalised titles, categories, salary extraction and company research.
- **Market statistics:** Open stats read straight into chat as tables, no feed needed.
- **Dashboards:** Visual dashboards for one feed or all feeds with XML links.

## Good for

- Build a job feed for a company's careers site
- Retry failed jobs on a Greenhouse feed
- Switch a feed from weekly to daily refresh
- Ask which cities or titles are in demand
- Feed a niche job board with enriched listings

## Install

### Claude Code (Terminal)

```sh
claude mcp add yubhub --env YUBHUB_USER_ID='<YUBHUB_USER_ID>' --env YUBHUB_API_KEY='<YUBHUB_API_KEY>' -- npx -y @houtini/yubhub
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/yubhub"
      ],
      "env": {
        "YUBHUB_USER_ID": "<YUBHUB_USER_ID>",
        "YUBHUB_API_KEY": "<YUBHUB_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/yubhub"
      ],
      "env": {
        "YUBHUB_USER_ID": "<YUBHUB_USER_ID>",
        "YUBHUB_API_KEY": "<YUBHUB_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "yubhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@houtini/yubhub"
      ],
      "env": {
        "YUBHUB_USER_ID": "<YUBHUB_USER_ID>",
        "YUBHUB_API_KEY": "<YUBHUB_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/yubhub"
      ],
      "env": {
        "YUBHUB_USER_ID": "<YUBHUB_USER_ID>",
        "YUBHUB_API_KEY": "<YUBHUB_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/yubhub"
      ],
      "env": {
        "YUBHUB_USER_ID": "<YUBHUB_USER_ID>",
        "YUBHUB_API_KEY": "<YUBHUB_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_feeds`: Get all your job feeds
- `create_feed`: Create a feed from a careers page URL
- `get_feed`: Feed details with run history and job counts
- `show_feed_dashboard`: Interactive dashboard for one feed
- `show_all_feeds_dashboard`: Overview dashboard of all feeds
- `trigger_feed_run`: Start job discovery now
- `update_feed`: Change feed name, tag or source URLs
- `delete_feed`: Remove a feed and its jobs
- `delete_jobs`: Clear a feed's jobs but keep the feed
- `get_feed_schedule`: Check auto-run schedule and next run
- `enable_feed_auto_run`: Turn on automatic runs
- `disable_feed_auto_run`: Turn off automatic runs
- `list_jobs`: List jobs for a feed, optionally by status
- `get_job`: Full job details
- `retry_failed_jobs`: Re-queue failed jobs

## FAQ

### What plan do I need?

Pro Publisher, which includes REST and MCP access, for the account tools.

### How is it installed?

Run npx -y @houtini/yubhub with YUBHUB_USER_ID and YUBHUB_API_KEY set.

### Is there a free tier?

Yes, 50 jobs a month with feeds only; API and MCP need Pro Publisher.

### Which ATS platforms are supported?

Greenhouse, Lever, Workable, Workday, Oracle HCM, SmartRecruiters, Ashby, Pinpoint, Phenom and more.

### Is YubHub free?

YubHub has a free plan, with paid plans for more usage or features. Paid plans start at $19.99 a month.

### How do I add YubHub to Claude Code?

Run this command in your terminal: claude mcp add yubhub --env YUBHUB_USER_ID='<YUBHUB_USER_ID>' --env YUBHUB_API_KEY='<YUBHUB_API_KEY>' -- npx -y @houtini/yubhub

### What are the best alternatives to YubHub?

The closest alternatives to YubHub are Reactive Resume, HeyRole, Nectar Jobs, TeamedUp Intelligence — China & APAC Salary Data and AI Scouts.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [HeyRole](https://ai-powered.com/mcp/heyrole): HeyRole is a free MCP server for hiring and recruiting.
- [Nectar Jobs](https://ai-powered.com/mcp/nectar-jobs): Nectar Jobs is a free MCP server for hiring and recruiting.
- [TeamedUp Intelligence — China & APAC Salary Data](https://ai-powered.com/mcp/teamedup-intelligence-china-and-apac-salary-data): TeamedUp Intelligence — China & APAC Salary Data is a freemium MCP server for hiring and recruiting.
- [AI Scouts](https://ai-powered.com/mcp/ai-scouts): AI Scouts is a freemium MCP server for productivity.
- [Spanish Top Tech Companies](https://ai-powered.com/mcp/spanish-top-tech-companies): Spanish Top Tech Companies is a free MCP server for hiring and recruiting.
- [Anshul Panigrahi Portfolio](https://ai-powered.com/mcp/anshul-panigrahi-portfolio): Anshul Panigrahi Portfolio is a free MCP server for hiring and recruiting.
- [WFH Alert Jobs](https://ai-powered.com/mcp/wfh-alert-jobs): WFH Alert Jobs is a free MCP server for hiring and recruiting.

---
Source: https://ai-powered.com/mcp/yubhub
