# Uplisting — how to use (mcp.ai)

Connect your Uplisting account and use 10 tools for scheduling and booking straight from your AI agent. Connect with your own API key. Uplisting is a vacation rental property management platform for managing properties, availability, bookings, calendars, and webhooks.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_uplisting?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `uplisting_create_webhook`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/uplisting`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/uplisting/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/uplisting/create/webhook` — Register a public callback URL for one booking or property event and return the new webhook ID.
  - body: { event: string, target_url: string }
- `POST https://api.mcp.ai/api/uplisting/delete/webhook` — Permanently remove one Uplisting webhook subscription by its ID. This is destructive and stops future event deliveries to that subscription.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/uplisting/get/calendar` — Return up to 12 months of daily availability, rates, and stay restrictions for one property.
  - body: { to_date?: string, from_date?: string, property_id: string }
- `POST https://api.mcp.ai/api/uplisting/get/current/account` — Return the name and stable UID of the Uplisting account connected by the current API key.
- `POST https://api.mcp.ai/api/uplisting/get/property` — Return one Uplisting property by ID with the related resources supplied by the API.
  - body: { property_id: string }
- `POST https://api.mcp.ai/api/uplisting/list/bookings` — Return one explicitly selected 0-based page of bookings for a property and optional date range, with total and total-page metadata.
  - body: { page?: integer, to_date?: string, per_page?: integer, from_date?: string, property_id: string }
- `POST https://api.mcp.ai/api/uplisting/list/properties` — Return all properties in the connected Uplisting account, including the related resources supplied by the API.
- `POST https://api.mcp.ai/api/uplisting/list/webhooks` — Return the webhook subscriptions registered for the connected Uplisting account.
- `POST https://api.mcp.ai/api/uplisting/search/availability` — Find Uplisting properties available for optional stay dates, guest count, city, and nightly price bounds.
  - body: { city?: string, check_in?: string, check_out?: string, max_price?: number, min_price?: number, number_of_guests?: integer }
- `POST https://api.mcp.ai/api/uplisting/update/calendar` — Asynchronously change availability, rates, or stay restrictions for dated days or date ranges on one property. HTTP 202 only means the update was accepted; it may take several minutes to propagate. Us
  - body: { days: object[], property_id: string, notification_url?: string }

## Example prompts
- "What can I do in Uplisting?"
- "Show me a summary of my Uplisting account"

## More
- Page: https://mcp.ai/uplisting
- Agent spec (llms.txt): https://mcp.ai/uplisting/llms.txt
- Postman collection: https://mcp.ai/uplisting/postman.json