YubHub MCP Server

Turn any careers page into a structured job feed. Straight from Claude, Cursor or any MCP client.

---

Quick start

You'll need a YubHub account first. Head to your account page to grab your User ID and API key (required).

Claude Desktop

Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this block inside "mcpServers":

{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": ["-y", "@houtini/yubhub"],
      "env": {
        "YUBHUB_USER_ID": "your-user-id",
        "YUBHUB_API_KEY": "yh_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. That's it. Ask Claude to "list my YubHub feeds" and you should see your data come back.

Cursor / VS Code

Same idea. Drop the config into your MCP settings and point it at npx -y @houtini/yubhub with the same env vars.

What it does

YubHub watches careers pages. Point it at a company's jobs URL, and it will discover every open role, scrape the listings, enrich them with AI (title normalisation, category tagging, salary extraction, company research) and publish them as an XML feed.

This MCP server gives you full control over that pipeline from inside your AI assistant. Create feeds, trigger runs, check on jobs, view dashboards, browse market stats. No browser tab required.

The pipeline

Careers page URL
  → Discovery (ATS API / sitemap / crawl)
    → Scraping (page content extraction)
      → Enrichment (AI structuring + company research)
        → XML feed (ready for job boards, aggregators, your own site)

Supported ATS platforms include Greenhouse, Lever, Workable, Workday, Oracle HCM, SmartRecruiters, Ashby, Pinpoint, Phenom and more. For platforms with public APIs (Greenhouse, Lever, Workable, Pinpoint), discovery skips scraping entirely and goes straight to enrichment.

Tools

21 tools across four areas.

Feed management

Tool	What it does
list_feeds	Get all your job feeds
create_feed	Create a feed from a careers page URL
get_feed	Feed details including run history and job counts
show_feed_dashboard	Interactive visual dashboard for a single feed
show_all_feeds_dashboard	Overview dashboard with all feeds, stats and XML links
trigger_feed_run	Start job discovery now
update_feed	Change feed name, tag or source URLs
delete_feed	Remove a feed and all its jobs
delete_jobs	Clear all jobs for a feed (keeps the feed)

Scheduling

Tool	What it does
get_feed_schedule	Check auto-run schedule and next run time
enable_feed_auto_run	Turn on automatic runs (default: weekly)
disable_feed_auto_run	Turn off automatic runs

Jobs

Tool	What it does
list_jobs	List jobs for a feed, optionally filtered by status
get_job	Full job details: title, company, location, salary, skills, description
retry_failed_jobs	Re-queue failed jobs for another attempt

Market statistics

Tool	What it does
get_stats_overview	High-level numbers: total jobs, companies, active feeds
get_top_companies	Companies ranked by job count with recent activity
get_categories	Job counts by sector with experience level breakdown
get_top_titles	Most common job titles by volume
get_title_trends	Titles gaining or losing demand (2-week comparison)
get_work_arrangements	Remote vs hybrid vs onsite distribution
get_experience_levels	Entry, mid, senior level distribution

Environment variables

Variable	Required	Description
YUBHUB_USER_ID	Yes	Your YubHub user ID
YUBHUB_API_KEY	Yes	API key from your account page
YUBHUB_ADMIN_API_URL	No	API endpoint (defaults to https://api.yubhub.co)

Example conversation

You: Create a feed for Mercedes F1 careers at https://www.mercedesamgf1.com/careers

Claude: Done. Feed created with ID feed_abc123. Want me to trigger a run?

You: Yes please.

Claude: Discovery started. I'll check back in a couple of minutes.

You: How did it go?

Claude: Found 47 jobs. 42 enriched successfully, 5 still processing. Here's a breakdown by category...

Tip: For best results, provide an example job URL when creating a feed. This helps YubHub identify the URL pattern for job listings on that site, significantly improving discovery accuracy. You can pass it as the optional exampleJobUrl parameter in create_feed.

Development

git clone https://github.com/houtini-ai/yubhub.git
cd yubhub
npm install
npm run build

The server compiles TypeScript to dist/ and runs as a stdio MCP server. Source lives in src/:

src/
├── index.ts                # MCP server, tool definitions and handlers
├── api-client.ts           # REST client for the YubHub API
├── dashboard-generator.ts  # React-based interactive dashboard builder
└── types.ts                # TypeScript interfaces

Running locally

YUBHUB_USER_ID=your-id YUBHUB_API_KEY=yh_your_key node dist/index.js

Or point your MCP client at the built output instead of using npx.

Contributing

Issues and pull requests welcome. If you're adding a tool or changing behaviour, please test against a real YubHub account.

Links

• YubHub — the platform
• Documentation — full docs
• MCP specification — Model Context Protocol

License

MIT — see LICENSE for details.