{
  "$schema": "https://spec.modelcontextprotocol.io/schema/draft/2025-06-18/mcp.json",
  "name": "yubhub-mcp",
  "version": "2.3.3",
  "title": "YubHub",
  "description": "MCP server for YubHub. Discover, enrich and publish jobs from career pages. Manage feeds, monitor pipelines and view market stats through Claude, Cursor or any MCP client.",
  "vendor": {
    "name": "Houtini",
    "url": "https://houtini.com"
  },
  "homepage": "https://yubhub.co",
  "documentation": "https://yubhub.co/developers",
  "repository": "https://github.com/houtini-ai/yubhub",
  "license": "MIT",
  "install": {
    "npm": "@houtini/yubhub",
    "bin": "yubhub-mcp",
    "claude_desktop": {
      "mcpServers": {
        "yubhub": {
          "command": "npx",
          "args": ["-y", "@houtini/yubhub"],
          "env": {
            "YUBHUB_API_URL": "https://api.yubhub.co",
            "YUBHUB_API_KEY": "your-yh_-prefixed-api-key"
          }
        }
      }
    }
  },
  "authentication": {
    "type": "api_key",
    "description": "YubHub API key prefixed yh_ (available to api_pro plan subscribers). Generate one in the YubHub dashboard at https://yubhub.co/dashboard.",
    "location": "env",
    "key": "YUBHUB_API_KEY"
  },
  "transport": {
    "type": "stdio",
    "protocol": "mcp",
    "sdk": "@modelcontextprotocol/sdk"
  },
  "capabilities": {
    "tools": true,
    "resources": false,
    "prompts": false
  },
  "tools": [
    { "name": "list_feeds", "description": "Get all your job feeds" },
    { "name": "create_feed", "description": "Create a new job feed for monitoring career pages" },
    { "name": "get_feed", "description": "Get detailed information about a specific feed including statistics" },
    { "name": "show_feed_dashboard", "description": "Display an interactive dashboard for monitoring a job feed" },
    { "name": "show_all_feeds_dashboard", "description": "Display a comprehensive dashboard showing all feeds with stats, sortable columns, and XML feed links" },
    { "name": "trigger_feed_run", "description": "Start job discovery for a specific feed" },
    { "name": "update_feed", "description": "Update a feed's name, tag, or source URLs" },
    { "name": "delete_feed", "description": "Delete a feed and all associated jobs" },
    { "name": "delete_jobs", "description": "Delete all jobs for a specific feed" },
    { "name": "get_feed_schedule", "description": "Get the automatic run schedule configuration for a feed" },
    { "name": "enable_feed_auto_run", "description": "Enable automatic weekly runs for a feed" },
    { "name": "disable_feed_auto_run", "description": "Disable automatic runs for a feed" },
    { "name": "list_jobs", "description": "Get all jobs for a specific feed, optionally filtered by status" },
    { "name": "get_job", "description": "Get detailed information about a specific job" },
    { "name": "retry_failed_jobs", "description": "Retry failed jobs for a feed" },
    { "name": "get_stats_overview", "description": "Get high-level statistics: total enriched jobs, companies, and active feeds" },
    { "name": "get_top_companies", "description": "Get top companies by enriched job count, with recent activity (last 7d and 30d)" },
    { "name": "get_categories", "description": "Get job counts by category/sector with experience level breakdown" },
    { "name": "get_top_titles", "description": "Get the most common job titles by volume (top 30)" },
    { "name": "get_title_trends", "description": "Get titles gaining or losing demand, comparing last 2 weeks vs prior 2 weeks" },
    { "name": "get_work_arrangements", "description": "Get work arrangement distribution (remote, hybrid, onsite)" },
    { "name": "get_experience_levels", "description": "Get experience level distribution (entry, mid, senior)" }
  ],
  "resources": [
    {
      "uri": "https://api.yubhub.co/",
      "name": "YubHub REST API",
      "description": "Direct HTTP access to the same data. See the OpenAPI spec."
    },
    {
      "uri": "https://yubhub.co/.well-known/openapi.yaml",
      "name": "OpenAPI specification",
      "description": "Machine-readable description of the REST API"
    },
    {
      "uri": "https://feeds.yubhub.co/",
      "name": "XML feed index",
      "description": "Per-feed XML endpoints for third-party job boards"
    }
  ]
}