Hosthub MCP by usefulapi
Read rentals, channels, rates and calendar events; create, change and delete bookings in Hosthub.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- LOWhosthub_get_rate_plan_daily_rates에서
- LOWhosthub_list_calendar_event_notes에서
- LOWhosthub_add_calendar_event_note에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"hosthub": {
"url": "https://hosthub.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://hosthub.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (16)
🟢hosthub_list_rentals
List the rentals (vacation properties) on the account. Each has id, name, city, country, currency, time_zone, and check-in and checkout times. Hosthub API: GET /rentals.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_get_rental(rental_id)
Get one rental (property) by id: address, currency, time zone, check-in and checkout times, guest capacity, unit count, and preparation days. Hosthub API: GET /rentals/{rentalId}.
입력 스키마
{
"type": "object",
"properties": {
"rental_id": {
"type": "string",
"minLength": 1,
"description": "The rental id (from a list or get tool)."
}
},
"required": [
"rental_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_list_rental_channels(rental_id, cursor_gt, cursor_lt)
List the sales channels (for example Airbnb or Booking.com) connected to one rental. Pages with cursor_gt or cursor_lt. Hosthub API: GET /rentals/{rentalId}/channels.
입력 스키마
{
"type": "object",
"properties": {
"rental_id": {
"type": "string",
"minLength": 1,
"description": "The rental id (from a list or get tool)."
},
"cursor_gt": {
"description": "Next-page cursor (cursor_gt from navigation.next).",
"type": "string"
},
"cursor_lt": {
"description": "Previous-page cursor (cursor_lt from navigation.previous).",
"type": "string"
}
},
"required": [
"rental_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_list_rate_plans(rental_id)
List the rate plans of one rental, with id, name, whether it is the default, and its status (active or inactive). Hosthub API: GET /rentals/{rentalId}/rate-plans.
입력 스키마
{
"type": "object",
"properties": {
"rental_id": {
"type": "string",
"minLength": 1,
"description": "The rental id (from a list or get tool)."
}
},
"required": [
"rental_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_get_rate_plan(rate_plan_id)
Get one rate plan by its encoded id: name, default flag, status, and URL. Hosthub API: GET /rate-plans/{encodedId}.
입력 스키마
{
"type": "object",
"properties": {
"rate_plan_id": {
"type": "string",
"minLength": 1,
"description": "The rate plan id (from a list or get tool)."
}
},
"required": [
"rate_plan_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_get_rate_plan_daily_rates(rate_plan_id)
Get the daily rates of one rate plan: the price per night for each date the API holds. Hosthub API: GET /rate-plans/{encodedId}/rates.
입력 스키마
{
"type": "object",
"properties": {
"rate_plan_id": {
"type": "string",
"minLength": 1,
"description": "The rate plan id (from a list or get tool)."
}
},
"required": [
"rate_plan_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_list_users
List the users of the account (owners and team members) with id, name, email, status, and team role. Hosthub API: GET /users.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_get_user(user_id)
Get one user by id: name, email, phone number, status, and team role. Hosthub API: GET /users/{userId}.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"minLength": 1,
"description": "The user id (from a list or get tool)."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_list_team_members(role_id, rental_id)
List team members with their roles. Filter by role id or rental id. Hosthub API: GET /team-members.
입력 스키마
{
"type": "object",
"properties": {
"role_id": {
"description": "Only members with this role id (role_id_eq).",
"type": "string"
},
"rental_id": {
"description": "Only members with access to this rental id (rental_id_eq).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_list_calendar_events(rental_id, updated_gt, updated_gte, created_gt, created_gte, ...)
List calendar events (bookings and holds). With rental_id, list only that rental; without it, list across all rentals. Filter by updated or created integers and visibility. Pages with cursor_gt or cursor_lt. Hosthub API: GET /calendar-events or GET /rentals/{rentalId}/calendar-events.
입력 스키마
{
"type": "object",
"properties": {
"rental_id": {
"description": "Only events of this rental id. Omit for all rentals.",
"type": "string"
},
"updated_gt": {
"description": "Only items with an updated value above this integer (integer filter, as the API documents it).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"updated_gte": {
"description": "Only items with an updated value at or above this integer (integer filter, as the API documents it).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"created_gt": {
"description": "Only items with a created value above this integer (integer filter, as the API documents it).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"created_gte": {
"description": "Only items with a created value at or above this integer (integer filter, as the API documents it).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"is_visible": {
"description": "Visibility filter: all, true, or false.",
"type": "string",
"enum": [
"all",
"true",
"false"
]
},
"cursor_gt": {
"description": "Next-page cursor (cursor_gt from navigation.next).",
"type": "string"
},
"cursor_lt": {
"description": "Previous-page cursor (cursor_lt from navigation.previous).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_get_calendar_event(calendar_event_id)
Get one calendar event (booking or hold) by id: type, dates, rental and unit, guest details, and money fields. Hosthub API: GET /calendar-events/{calendarEventId}.
입력 스키마
{
"type": "object",
"properties": {
"calendar_event_id": {
"type": "string",
"minLength": 1,
"description": "The calendar event id (from a list or get tool)."
}
},
"required": [
"calendar_event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hosthub_list_calendar_event_notes(calendar_event_id)
List the internal notes on one calendar event. Hosthub API: GET /calendar-events/{calendarEventId}/notes.
입력 스키마
{
"type": "object",
"properties": {
"calendar_event_id": {
"type": "string",
"minLength": 1,
"description": "The calendar event id (from a list or get tool)."
}
},
"required": [
"calendar_event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hosthub_create_calendar_event(rental_id, type, date_from, date_to, check_in_time, ...)
Create a booking or a hold (a blocked period) for one rental. A booking needs guest details; a hold needs hold_reason. This changes live availability on every connected channel. Hosthub API: POST /rentals/{rentalId}/calendar-events.
입력 스키마
{
"type": "object",
"properties": {
"rental_id": {
"type": "string",
"minLength": 1,
"description": "The rental id (from a list or get tool)."
},
"type": {
"type": "string",
"enum": [
"Booking",
"Hold"
],
"description": "Booking for a guest stay, or Hold to block the dates."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First night, yyyy-mm-dd."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out date, yyyy-mm-dd."
},
"check_in_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Local time, HH:MM."
},
"check_out_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Local time, HH:MM."
},
"guest_name": {
"type": "string"
},
"guest_adults": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"guest_children": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"guest_email": {
"type": "string"
},
"guest_phone": {
"type": "string"
},
"guest_city": {
"type": "string"
},
"hold_reason": {
"description": "Reason for a Hold.",
"type": "string",
"enum": [
"housekeeping",
"repairs",
"personal_use",
"other"
]
},
"title": {
"description": "Title shown in the calendar.",
"type": "string"
},
"notes": {
"type": "string"
}
},
"required": [
"rental_id",
"type",
"date_from",
"date_to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hosthub_update_calendar_event(calendar_event_id, date_from, date_to, check_in_time, check_out_time, ...)
Change the dates, times, guest details, or notes of an existing calendar event. Only the fields you pass change. This can move availability on connected channels. Hosthub API: POST /calendar-events/{calendarEventKey}.
입력 스키마
{
"type": "object",
"properties": {
"calendar_event_id": {
"type": "string",
"minLength": 1,
"description": "The calendar event id (from a list or get tool)."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"check_in_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Local time, HH:MM."
},
"check_out_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Local time, HH:MM."
},
"guest_name": {
"type": "string"
},
"guest_adults": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"guest_children": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"guest_email": {
"type": "string"
},
"guest_phone": {
"type": "string"
},
"notes": {
"type": "string"
}
},
"required": [
"calendar_event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hosthub_delete_calendar_event(calendar_event_id)
Delete one calendar event (booking or hold). This changes availability for its dates. Hosthub API: DELETE /calendar-events/{calendarEventId}.
입력 스키마
{
"type": "object",
"properties": {
"calendar_event_id": {
"type": "string",
"minLength": 1,
"description": "The calendar event id (from a list or get tool)."
}
},
"required": [
"calendar_event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hosthub_add_calendar_event_note(calendar_event_id, content)
Add a note to one calendar event. Hosthub API: POST /calendar-events/{calendarEventId}/notes.
입력 스키마
{
"type": "object",
"properties": {
"calendar_event_id": {
"type": "string",
"minLength": 1,
"description": "The calendar event id (from a list or get tool)."
},
"content": {
"type": "string",
"minLength": 1,
"description": "The note text."
}
},
"required": [
"calendar_event_id",
"content"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거