Hosthub MCP by usefulapi

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

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
89%
Naming quality
76%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (3)

  • LOWTool 'hosthub_get_rate_plan_daily_rates' name length outside 3-30 rangein hosthub_get_rate_plan_daily_rates
  • LOWTool 'hosthub_list_calendar_event_notes' name length outside 3-30 rangein hosthub_list_calendar_event_notes
  • LOWTool 'hosthub_add_calendar_event_note' name length outside 3-30 rangein hosthub_add_calendar_event_note

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,849Tokens (tool definitions)
~1.2 KBTypical response size
Significant attention impact (2.23% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "hosthub": {
      "url": "https://hosthub.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://hosthub.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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}.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

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

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools