Hosco Hospitality Jobs

Semantic + structured search over Hosco hospitality jobs. Mirrors the smart filtering and ranking from hosco-v2: hard-excludes private/expired/inactive postings, supports visibility/promotion/external filters, configurable language matching (subset/any/all), and the v2 "suggested" ordering (relevance → Hosco-native → VIP → freshness). Returns ranked matches with relevance scores.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Natural-language search (e.g. \"sommelier in Paris fine dining\"). When provided, ranks by semantic similarity. When omitted, returns latest jobs filtered + sorted by the structured options.",
      "type": "string"
    },
    "country": {
      "description": "ISO-3166 alpha-2 country code, e.g. FR, GB, ES.",
      "type": "string"
    },
    "city": {
      "description": "City name (exact match against hosco_location.locality).",
      "type": "string"
    },
    "department": {
      "description": "Hosco category code, e.g. f-b-kitchen, housekeeping, sommelier, reception.",
      "type": "string"
    },
    "content_language": {
      "description": "Language code the job ad itself is written in (auto-detected), e.g. \"en\", \"fr\". Use this to only show postings the candidate can actually read — unrelated to the languages filter below.",
      "type": "string"
    },
    "contract_type": {
      "description": "One of: internship (students only), professional (professionals only), open (both).",
      "type": "string"
    },
    "experience_years_max": {
      "description": "Maximum years of experience the candidate has — only show jobs requiring less than or equal to this.",
      "type": "integer"
    },
    "languages": {
      "description": "Candidate language codes, e.g. [\"en\",\"fr\"]. Matched against the job's mandatory fluency requirement (\"Require fluency in\" in hosco-v2), not the language the ad is written in. Combined with languages_mode.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "languages_mode": {
      "description": "How to interpret `languages`: \"all\" (job must require every code; default), \"any\" (job requires at least one of them), \"subset\" (job's required languages must all be in the provided list — i.e. the candidate speaks them all).",
      "type": "string"
    },
    "visibilities": {
      "description": "Visibility tiers to include: public, targeted, lite, prime (private is never returned on this public surface).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "promotion_types": {
      "description": "Filter to specific promotion statuses: 0=disabled, 1=prime, 2=lite-basic, 4=lite-full. Status 3 (private) is always excluded.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "only_external": {
      "description": "Only return jobs sourced from external aggregators.",
      "type": "boolean"
    },
    "hide_external": {
      "description": "Hide jobs sourced from external aggregators (Hosco-native only).",
      "type": "boolean"
    },
    "posted_after": {
      "description": "ISO date; only return jobs published on or after this date.",
      "type": "string"
    },
    "sort": {
      "description": "Ordering: \"suggested\" (default — relevance, then Hosco-native, then VIP, then freshness), \"posted\" (newest activation date), \"update_date\" (most recently updated), \"title\" (alphabetical).",
      "type": "string"
    },
    "limit": {
      "description": "Page size (1–50, default 10).",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    },
    "offset": {
      "description": "Pagination offset (default 0).",
      "minimum": 0,
      "type": "integer"
    }
  }
}

List the most recently published Hosco jobs, paginated. Use this when no semantic search is needed — for natural-language search, use the search jobs tool instead.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Page size (1–50, default 10).",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    },
    "offset": {
      "description": "Pagination offset (default 0).",
      "minimum": 0,
      "type": "integer"
    }
  }
}

Fetch the full details of a single Hosco job by its slug or numeric id. Use this after a search/list result to retrieve the full description, requirements, benefits, and all other available fields.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The job slug (preferred lookup key — present in search/list results).",
      "type": "string"
    },
    "id": {
      "description": "The numeric job id. Provide either slug or id.",
      "type": "integer"
    }
  }
}

Search Hosco's catalogue of hospitality courses and training programmes (bartending, culinary, hospitality management, languages, revenue management and more). Supports a free-text query plus filters for category, language, learning type and price. Hidden and deleted courses are never returned. Every result carries a canonical `url`.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over course titles and descriptions, e.g. \"cocktail\", \"revenue management\", \"sommelier\".",
      "type": "string"
    },
    "categories": {
      "description": "Course category codes, e.g. [\"bartending\"], [\"culinary\",\"pastry\"]. Known codes: culinary, pastry, cruises, oenology, hospitality-management, sales-and-marketing, event-management, languages, revenue-management, reception, bartending, food-and-beverages, spa, tourism, business-skills.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "languages": {
      "description": "Language codes the course is taught in, e.g. [\"en\"], [\"es\",\"fr\"].",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "learning_types": {
      "description": "Delivery: \"campus\" (in person), \"online\", or \"both\".",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "min_price": {
      "description": "Minimum price in the course's own currency. Use 0 with max_price 0 for free courses.",
      "minimum": 0,
      "type": "integer"
    },
    "max_price": {
      "description": "Maximum price in the course's own currency.",
      "minimum": 0,
      "type": "integer"
    },
    "sort": {
      "description": "Order by \"price\" or \"duration\". Omit for the catalogue's default relevance order.",
      "type": "string"
    },
    "order": {
      "description": "\"asc\" or \"desc\" (default), used with sort.",
      "type": "string"
    },
    "locale": {
      "description": "Language for the returned course links: en (default), es, fr or it. Match the language the member is writing in.",
      "type": "string"
    },
    "limit": {
      "description": "Page size (1–50, default 10).",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    },
    "offset": {
      "description": "Pagination offset (default 0).",
      "minimum": 0,
      "type": "integer"
    }
  }
}

Fetch the full details of a single Hosco course by its slug. Use this after a search result to retrieve the full description, programme details, provider, price, duration, delivery type and languages.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The course slug, exactly as returned by the search tool.",
      "type": "string"
    },
    "locale": {
      "description": "Language for the returned course link: en (default), es, fr or it.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}