Hosthub MCP by usefulapi

Read rentals, channels, rates and calendar events; create, change and delete bookings in Hosthub.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
89%
이름 품질
76%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (3)

  • LOWTool 'hosthub_get_rate_plan_daily_rates' name length outside 3-30 rangehosthub_get_rate_plan_daily_rates에서
  • LOWTool 'hosthub_list_calendar_event_notes' name length outside 3-30 rangehosthub_list_calendar_event_notes에서
  • LOWTool 'hosthub_add_calendar_event_note' name length outside 3-30 rangehosthub_add_calendar_event_note에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,849토큰 (도구 정의)
~1.2 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.23%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 16개