Developer Tools

Control your job feeds
from code or AI

YubHub gives you two ways to access your job data programmatically: a REST API for traditional integrations, and an MCP server that lets AI assistants manage your feeds directly.

Get started free Jump to MCP setup

REST API

Traditional HTTP API with JSON responses. Manage feeds, list jobs, trigger runs, and access enriched job data from any language or platform.

  • ✓ Full CRUD on feeds and jobs
  • ✓ Bearer token authentication
  • ✓ JSON responses with enriched job data
  • ✓ Schedule management and usage stats
Learn more ↓

MCP Server

Connect YubHub to AI assistants like Claude Desktop, Cursor, or VS Code. Manage your entire job feed pipeline through natural conversation.

  • ✓ Works with Claude Desktop, Cursor, VS Code
  • ✓ Create feeds and trigger runs by asking
  • ✓ Browse and analyse enriched job data
  • ✓ One-line install via npx
Learn more ↓

MCP Server

The Model Context Protocol lets AI assistants use tools directly. With the YubHub MCP server, you can manage your job feeds through natural conversation in any MCP-compatible client.

What you can do from Claude Desktop

Create and manage feeds

"Create a feed for Mercedes F1 careers at careers.mercedesamgf1.com"

Trigger job discovery

"Run the Mercedes feed and show me the results when it's done"

Browse enriched jobs

"List all jobs from feed X that are remote engineering roles"

View feed stats and schedules

"Show me all my feeds and their job counts"

Update feed settings

"Change the Mercedes feed to refresh daily instead of weekly"

Retry failed jobs

"Retry all failed jobs on my Greenhouse feed"

Quick install

No installation needed. Run it directly via npx:

npx -y @houtini/yubhub

Add this to your MCP client configuration (Claude Desktop, Cursor, or VS Code): 

{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": ["-y", "@houtini/yubhub"],
      "env": {
        "YUBHUB_USER_ID": "your_user_id",
        "YUBHUB_API_KEY": "yh_your_api_key"
      }
    }
  }
}

Your User ID and API key are available in your API settings (requires Pro Publisher plan).

GitHub npm package

REST API

A straightforward JSON API for managing feeds, listing enriched jobs, and triggering discovery runs. Authenticate with a Bearer token and you're ready to go.

Endpoints

GET /api/feeds
POST /api/feeds
GET /api/feeds/:id/jobs
POST /api/feeds/:id/run
GET /api/feeds/:id/schedule
GET /api/account

Authentication

Pass your API key as a Bearer token in the Authorization header:

Authorization: Bearer yh_your_api_key

Example: list your feeds

curl https://api.yubhub.co/api/feeds \
  -H "Authorization: Bearer yh_your_api_key"
Full API documentation → Get your API key

Available on Pro Publisher

API and MCP access is included with the Pro Publisher plan. Start with a free account and upgrade when you're ready for programmatic access.

View pricing →