Hipcamp API and MCP server

• POST

  list_listings

  Your listings with their sites, status and base nightly price.

  read

  Returns every listing in your host account with its sites. Use listing_id and site_id from each item in the other endpoints. Base price is the price on the site, before any special price you set on single nights.

  POST /api/v1/hipcamp/list_listings

  Input

  No parameters.

  Example response

  {
    "listings": [
      {
        "listing_id": "lst_48211",
        "name": "Willow Creek Farm",
        "status": "live",
        "sites": [
          {
            "site_id": "site_meadow",
            "name": "Meadow",
            "base_price": 45,
            "currency": "USD"
          },
          {
            "site_id": "site_creek",
            "name": "Creekside",
            "base_price": 52,
            "currency": "USD"
          }
        ]
      }
    ]
  }

• POST

  list_bookings

  Confirmed bookings in a date range with camper, site, dates, guests and total.

  read

  Lists confirmed bookings whose arrival falls in the range, soonest arrival first. Booking requests still waiting for your answer are not included; list_booking_requests returns those. Total is what the camper paid for the stay.

  POST /api/v1/hipcamp/list_bookings

  Input

  Input: list_bookings

  Parameter	Type	Description
  from	date	First arrival date. Default: today.
  to	date	Last arrival date. Default: 30 days from today.
  listing_id	string	Only this listing.
  status	enum	upcoming, current, past or cancelled. Default: upcoming.

  Example response

  {
    "bookings": [
      {
        "booking_id": "bk_90105",
        "listing_id": "lst_48211",
        "site": "Meadow",
        "camper": "Maya R.",
        "arrival": "2026-10-16",
        "departure": "2026-10-18",
        "guests": 3,
        "total": 90,
        "currency": "USD",
        "status": "upcoming"
      }
    ]
  }

• POST

  list_booking_requests

  Pending booking requests waiting for your answer, with dates, site and time left to respond.

  read

  Lists requests to book that you have not accepted or declined, soonest expiry first. A request expires 24 hours after it arrives if you do not respond, and expires_at shows when. Pass booking_id to get_booking, accept_booking_request or decline_booking_request.

  POST /api/v1/hipcamp/list_booking_requests

  Input

  Input: list_booking_requests

  Parameter	Type	Description
  listing_id	string	Only this listing.

  Example response

  {
    "requests": [
      {
        "booking_id": "bk_90217",
        "listing_id": "lst_48211",
        "site": "Meadow",
        "camper": "Jon P.",
        "arrival": "2026-10-23",
        "departure": "2026-10-25",
        "guests": 2,
        "expires_at": "2026-10-12T09:14:00Z"
      }
    ]
  }

• POST

  get_booking

  One booking or request: camper, group size, message and price.

  read

  Returns one booking or booking request with the camper's first name, number of guests, the message they sent with the request and the price for the stay. Use it before accepting so your agent reads the camper's note.

  POST /api/v1/hipcamp/get_booking

  Input

  Input: get_booking

  Parameter	Type	Description
  booking_id required	string	Booking ID from list_bookings or list_booking_requests.

  Example response

  {
    "booking_id": "bk_90217",
    "status": "pending_request",
    "site": "Meadow",
    "camper": "Jon P.",
    "arrival": "2026-10-23",
    "departure": "2026-10-25",
    "guests": 2,
    "camper_message": "Two adults and a dog, arriving after 5 pm.",
    "nights": 2,
    "nightly_price": 45,
    "total": 90,
    "currency": "USD"
  }

• POST

  get_calendar

  Availability and nightly price per site and day, including blocked dates.

  read

  Returns one row per site and night with its price and state: available, booked or blocked. Special prices are shown as set; days without one show the base price. Use it before update_pricing to see what a change would touch.

  POST /api/v1/hipcamp/get_calendar

  Input

  Input: get_calendar

  Parameter	Type	Description
  listing_id required	string	Listing ID from list_listings.
  site_id	string	One site of the listing. Default: all sites.
  from required	date	First day.
  to required	date	Last day.

  Example response

  {
    "site_id": "site_meadow",
    "days": [
      {
        "date": "2027-07-02",
        "state": "available",
        "nightly_price": 45,
        "special_price": false
      },
      {
        "date": "2027-07-03",
        "state": "booked",
        "nightly_price": 45,
        "special_price": false
      },
      {
        "date": "2027-07-04",
        "state": "blocked",
        "nightly_price": 45,
        "special_price": false
      }
    ]
  }

• POST

  list_messages

  Inbox conversations with campers, with the last message and its state.

  read

  Lists Inbox conversations, most recent first, with the same filters as the Inbox. Pending conversations include booking requests waiting for your answer. Use conversation_id in send_message.

  POST /api/v1/hipcamp/list_messages

  Input

  Input: list_messages

  Parameter	Type	Description
  filter	enum	unread, pending, future, past or questions. Default: unread.
  booking_id	string	Only the conversation of this booking.

  Example response

  {
    "conversations": [
      {
        "conversation_id": "cv_33170",
        "camper": "Maya R.",
        "booking_id": "bk_90105",
        "last_message": "Which gate is the Meadow site? We arrive Friday.",
        "last_message_at": "2026-10-11T08:02:00Z",
        "unread": true
      }
    ]
  }

• POST

  list_reviews

  Camper reviews of your listings with rating, text, date and your response.

  read

  Lists reviews newest first, each with your public response if you wrote one. Leave responded empty to get all of them, or set it to false to find reviews you have not answered.

  POST /api/v1/hipcamp/list_reviews

  Input

  Input: list_reviews

  Parameter	Type	Description
  listing_id	string	Only this listing.
  since	date	Only reviews on or after this date.
  responded	boolean	false: only reviews without your response.

  Example response

  {
    "reviews": [
      {
        "review_id": "rv_5521",
        "listing_id": "lst_48211",
        "camper": "Maya R.",
        "recommended": true,
        "text": "Quiet site, great creek, easy host.",
        "created_at": "2026-10-08T14:30:00Z",
        "response": null
      }
    ]
  }

• POST

  list_payouts

  Payouts with amount, status, date and the bookings they cover.

  read

  Lists payouts as the Payouts tab shows them, newest first, each with the bookings it covers. A booking is paid after the camper checks out, so recent stays can still be missing.

  POST /api/v1/hipcamp/list_payouts

  Input

  Input: list_payouts

  Parameter	Type	Description
  since	date	Only payouts on or after this date. Default: 90 days ago.

  Example response

  {
    "payouts": [
      {
        "payout_id": "po_7731",
        "date": "2026-10-06",
        "amount": 170,
        "currency": "USD",
        "status": "paid",
        "bookings": [
          "bk_89990",
          "bk_90012"
        ]
      }
    ]
  }

• POST

  block_dates

  Make a site or a whole listing unavailable for a date range.

  write

  Turns off availability for the nights in the range, the same as Bulk Edit in the Calendar. Blocking keeps the property in Hipcamp search. It reaches no one and unblock_dates undoes it, so it runs without asking.

  POST /api/v1/hipcamp/block_dates

  Input

  Input: block_dates

  Parameter	Type	Description
  listing_id required	string	Listing ID from list_listings.
  site_id	string	One site of the listing. Default: all sites.
  from required	date	First blocked night.
  to required	date	Last blocked night.
  reason	string	Closure reason, as offered in Bulk Edit.

  Example response

  {
    "listing_id": "lst_48211",
    "site_id": "site_meadow",
    "from": "2027-08-14",
    "to": "2027-08-18",
    "reason": "Maintenance",
    "nights_blocked": 5
  }

• POST

  unblock_dates

  Open blocked dates again for booking.

  write

  Turns availability back on for the nights in the range. It reaches no one and block_dates undoes it, so it runs without asking.

  POST /api/v1/hipcamp/unblock_dates

  Input

  Input: unblock_dates

  Parameter	Type	Description
  listing_id required	string	Listing ID from list_listings.
  site_id	string	One site of the listing. Default: all sites.
  from required	date	First night to open.
  to required	date	Last night to open.

  Example response

  {
    "listing_id": "lst_48211",
    "site_id": "site_meadow",
    "from": "2027-08-14",
    "to": "2027-08-18",
    "nights_opened": 5
  }

• POST

  update_pricing

  Set a special nightly price for chosen nights.

  write

  Sets a special price for the nights in the range, the same as Bulk Edit in the Calendar. A special price takes precedence over the base price and applies to bookings made after the change; confirmed bookings keep their price. It reaches no one directly and one call undoes it, so it runs without asking.

  POST /api/v1/hipcamp/update_pricing

  Input

  Input: update_pricing

  Parameter	Type	Description
  listing_id required	string	Listing ID from list_listings.
  site_id	string	One site of the listing. Default: all sites.
  from required	date	First night.
  to required	date	Last night.
  nightly_price required	integer	Price per night in the listing currency, whole units.
  weekdays	string[]	Only these days: mon, tue, wed, thu, fri, sat, sun. Default: every day.

  Example response

  {
    "listing_id": "lst_48211",
    "site_id": "site_meadow",
    "nights_updated": 10,
    "nightly_price": 55,
    "currency": "USD"
  }

• POST

  accept_booking_request

  Accept a pending booking request. The camper is notified and charged.

  asks first write

  Accepts the request; Hipcamp then captures the charge it held when the request came in, and the camper is notified. Only requests that have not expired can be accepted. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/hipcamp/accept_booking_request

  Input

  Input: accept_booking_request

  Parameter	Type	Description
  booking_id required	string	Booking ID from list_bookings or list_booking_requests.
  message	string	Optional note to the camper.

  Example response

  {
    "booking_id": "bk_90217",
    "status": "confirmed",
    "site": "Meadow",
    "arrival": "2026-10-23",
    "departure": "2026-10-25",
    "total": 90,
    "currency": "USD"
  }

• POST

  decline_booking_request

  Decline a pending booking request. The camper is notified and not charged.

  asks first write

  Declines the request and notifies the camper. The camper is not charged. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/hipcamp/decline_booking_request

  Input

  Input: decline_booking_request

  Parameter	Type	Description
  booking_id required	string	Booking ID from list_bookings or list_booking_requests.
  message	string	Optional note to the camper explaining why.

  Example response

  {
    "booking_id": "bk_90218",
    "status": "declined",
    "camper_charged": false
  }

• POST

  send_message

  Send a message to a camper in an existing conversation.

  asks first write

  Posts a message in an Inbox conversation under your host name and returns its ID. Start from a conversation_id returned by list_messages. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/hipcamp/send_message

  Input

  Input: send_message

  Parameter	Type	Description
  conversation_id required	string	Conversation ID from list_messages.
  body required	string	Message text.

  Example response

  {
    "conversation_id": "cv_33170",
    "message_id": "msg_88410",
    "sent_at": "2026-10-11T09:05:00Z"
  }

• POST

  respond_to_review

  Respond to a camper review, publicly or as a private message.

  asks first write

  Posts your response under the review, or sends it to the camper as a private message. A public response appears under your name for future campers. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/hipcamp/respond_to_review

  Input

  Input: respond_to_review

  Parameter	Type	Description
  review_id required	string	Review ID from list_reviews.
  body required	string	Response text.
  visibility	enum	public or private. Default: public.

  Example response

  {
    "review_id": "rv_5521",
    "visibility": "public",
    "posted_at": "2026-10-11T09:12:00Z"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.