Hipcamp MCP tools

MCP tool hipcamp_list_listings

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.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_list_listings",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_list_bookings

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_list_bookings",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_list_booking_requests

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_list_booking_requests",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_get_booking

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_get_booking",
    "arguments": {
      "booking_id": "booking_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
  },
  "isError": false
}

MCP tool hipcamp_get_calendar

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_get_calendar",
    "arguments": {
      "listing_id": "listing_8c41d2",
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_list_messages

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_list_messages",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_list_reviews

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_list_reviews",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_list_payouts

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_list_payouts",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "payouts": [
      {
        "payout_id": "po_7731",
        "date": "2026-10-06",
        "amount": 170,
        "currency": "USD",
        "status": "paid",
        "bookings": [
          "bk_89990",
          "bk_90012"
        ]
      }
    ]
  },
  "isError": false
}

MCP tool hipcamp_block_dates

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_block_dates",
    "arguments": {
      "listing_id": "listing_8c41d2",
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "listing_id": "lst_48211",
    "site_id": "site_meadow",
    "from": "2027-08-14",
    "to": "2027-08-18",
    "reason": "Maintenance",
    "nights_blocked": 5
  },
  "isError": false
}

MCP tool hipcamp_unblock_dates

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

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_unblock_dates",
    "arguments": {
      "listing_id": "listing_8c41d2",
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "listing_id": "lst_48211",
    "site_id": "site_meadow",
    "from": "2027-08-14",
    "to": "2027-08-18",
    "nights_opened": 5
  },
  "isError": false
}

MCP tool hipcamp_update_pricing

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_update_pricing",
    "arguments": {
      "listing_id": "lst_48211",
      "site_id": "site_meadow",
      "from": "2027-07-01",
      "to": "2027-07-31",
      "nightly_price": 55,
      "weekdays": [
        "fri",
        "sat"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "listing_id": "lst_48211",
    "site_id": "site_meadow",
    "nights_updated": 10,
    "nightly_price": 55,
    "currency": "USD"
  },
  "isError": false
}

MCP tool hipcamp_accept_booking_request

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_accept_booking_request",
    "arguments": {
      "booking_id": "bk_90217",
      "message": "Welcome, Jon! Late arrival is fine; the gate code comes the day before."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_id": "bk_90217",
    "status": "confirmed",
    "site": "Meadow",
    "arrival": "2026-10-23",
    "departure": "2026-10-25",
    "total": 90,
    "currency": "USD"
  },
  "isError": false
}

MCP tool hipcamp_decline_booking_request

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_decline_booking_request",
    "arguments": {
      "booking_id": "booking_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_id": "bk_90218",
    "status": "declined",
    "camper_charged": false
  },
  "isError": false
}

MCP tool hipcamp_send_message

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_send_message",
    "arguments": {
      "conversation_id": "cv_33170",
      "body": "Hi Maya, take the second gate after the red barn; Meadow is the flat spot by the creek. Firewood is $8 a bundle at the shed."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "cv_33170",
    "message_id": "msg_88410",
    "sent_at": "2026-10-11T09:05:00Z"
  },
  "isError": false
}

MCP tool hipcamp_respond_to_review

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.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hipcamp_respond_to_review",
    "arguments": {
      "review_id": "rv_5521",
      "visibility": "private",
      "body": "Thank you, Maya! So glad the creek was running for you. Come back in spring."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "review_id": "rv_5521",
    "visibility": "public",
    "posted_at": "2026-10-11T09:12:00Z"
  },
  "isError": false
}