# MCP VRBO

MCP server for searching VRBO vacation rental listings using browser automation.

## Overview

This server provides VRBO search capabilities by leveraging `mcp-browser` for browser automation. Unlike the Airbnb MCP which uses embedded JSON extraction, VRBO requires full browser rendering to access listing data.

**Port:** 3046
**URL:** https://mcp-vrbo.local.jbmurphy.com

## Architecture

```
mcp-vrbo (3042) --> mcp-browser (3020) --> browser-pool --> LXC browsers
```

The server:
1. Receives search/listing requests
2. Calls mcp-browser to navigate to VRBO pages
3. Executes JavaScript to extract listing data from the DOM
4. Returns structured property information

## Tools

| Tool | Description |
|------|-------------|
| `vrbo_search` | Search VRBO listings with filters (location, dates, guests, price range, bedrooms) |
| `vrbo_listing_details` | Get detailed information about a specific VRBO property |

## Usage

### Search for listings

```bash
curl -X POST https://mcp-vrbo.local.jbmurphy.com/mcp/call_tool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "vrbo_search",
    "arguments": {
      "location": "New York",
      "checkin": "2025-03-01",
      "checkout": "2025-03-05",
      "adults": 2,
      "min_bedrooms": 2
    }
  }'
```

### Get listing details

```bash
curl -X POST https://mcp-vrbo.local.jbmurphy.com/mcp/call_tool \
  -H "Content-Type: application/json" \
  -d '{
    "name": "vrbo_listing_details",
    "arguments": {
      "id": "4515867"
    }
  }'
```

## Search Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `location` | string | Required. City, state, or region to search |
| `checkin` | string | Check-in date (YYYY-MM-DD) |
| `checkout` | string | Check-out date (YYYY-MM-DD) |
| `adults` | number | Number of adults (default: 2) |
| `children` | number | Number of children (default: 0) |
| `min_bedrooms` | number | Minimum number of bedrooms |
| `min_bathrooms` | number | Minimum number of bathrooms |
| `min_price` | number | Minimum price per night |
| `max_price` | number | Maximum price per night |

## Response Format

```json
{
  "searchUrl": "https://www.vrbo.com/search?destination=...",
  "location": "New York",
  "totalAvailable": "300+",
  "returnedCount": 17,
  "properties": [
    {
      "id": "4515867",
      "name": "Spacious apartment in Brooklyn",
      "url": "https://www.vrbo.com/4515867",
      "price": "$1,181",
      "priceNumeric": 1181,
      "rating": 9.4,
      "reviews": 10,
      "propertyType": "Apartment",
      "sleeps": 16,
      "bedrooms": 4,
      "bathrooms": "3+",
      "neighborhood": "Brooklyn"
    }
  ]
}
```

## Dependencies

- `mcp-browser` - Browser automation service (must be running)
- `browser-pool` - LXC browser container pool

## Build & Deploy

```bash
# Build locally
docker-compose up -d --build

# Or via main docker-compose
cd .. && docker-compose up -d --build mcp-vrbo
```

## Technical Notes

- VRBO uses React and loads data dynamically via GraphQL
- Data extraction is done by parsing the rendered DOM, not embedded JSON
- The browser pool handles anti-bot measures through real browser instances
- Slower than Airbnb scraping (~3-5 seconds per search) due to full page rendering

## Comparison: Airbnb vs VRBO

| Aspect | mcp-airbnb | mcp-vrbo |
|--------|------------|----------|
| Method | Embedded JSON extraction | DOM parsing via browser |
| Speed | Fast (~1 second) | Slower (~3-5 seconds) |
| Browser required | No | Yes (via mcp-browser) |
| Reliability | May break on JSON structure changes | May break on DOM changes |