Agent Skills ​

Install the accommodation search skill to give your AI coding agent access to live travel inventory from Booking.com, Vrbo, Expedia, and Hotels.com.

Install ​

One command to add the skill to your project:

bash
mkdir -p .claude/skills/accommodation-search && curl -sL {{API_BASE_URL}}/.well-known/agent-skills/accommodation-search/SKILL.md -o .claude/skills/accommodation-search/SKILL.md
bash
mkdir -p .agents/skills/accommodation-search && curl -sL {{API_BASE_URL}}/.well-known/agent-skills/accommodation-search/SKILL.md -o .agents/skills/accommodation-search/SKILL.md
bash
mkdir -p ~/.agents/skills/accommodation-search && curl -sL {{API_BASE_URL}}/.well-known/agent-skills/accommodation-search/SKILL.md -o ~/.agents/skills/accommodation-search/SKILL.md

After installing, your agent will automatically use this skill when tasks involve finding hotels, comparing lodging, or checking availability.

Search live travel inventory for hotels and vacation rentals with real-time availability and pricing. Connects to the Direct Travel API via MCP or REST.

View SKILL.md content
markdown
---
name: accommodation-search
description: Search live travel inventory for hotels and vacation rentals. Use when a task involves finding accommodation, comparing lodging options, or checking hotel availability and pricing.
---

# Accommodation Search

Search across multiple travel providers (Booking.com, Vrbo, Expedia, Hotels.com) for hotels and vacation rentals with real-time availability and pricing.

## Connecting via MCP

The recommended way for agents to use this skill is through the MCP server.

**Endpoint:** `{{API_BASE_URL}}/mcp`

### Configuration

```json
{
  "mcpServers": {
    "stay22-travel": {
      "url": "{{API_BASE_URL}}/mcp?key=YOUR_API_KEY"
    }
  }
}
```

An API key is optional for demo access (limited to 5 requests/minute). Get a key at {{API_BASE_URL}}/docs/ for higher limits.

## Tool: search_accommodations

Search for accommodations by location with filters for dates, guests, price, and ratings.

### Location (one required)

| Parameter | Type | Description |
|-----------|------|-------------|
| `address` | string | Place name or address (e.g., "Eiffel Tower", "Paris, France") |
| `lat` + `lng` | number | Center point coordinates. Optional `radius` in meters (default 10000) |
| `nelat` + `nelng` + `swlat` + `swlng` | number | Bounding box corners for map-based search |
| `hotelids` | string | Comma-separated accommodation IDs for direct lookup |

### Filters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `provider` | string | — | Required. One of: `booking`, `vrbo`, `expedia`, `hotelscom` |
| `checkin` | string | +90 days | Check-in date (YYYY-MM-DD) |
| `checkout` | string | +93 days | Check-out date (YYYY-MM-DD) |
| `adults` | number | 2 | Number of adults |
| `children` | number | 0 | Number of children |
| `rooms` | number | 1 | Number of rooms |
| `type` | string | both | `hotel` or `rental` |
| `min` | number | 0 | Min per-night price (USD) |
| `max` | number | 1000 | Max per-night price (USD) |
| `currency` | string | USD | Display currency (ISO 4217) |
| `minstarrating` | number | — | Min hotel star rating (0-5) |
| `minguestrating` | number | — | Min guest review rating (0-10) |
| `limit` | number | 10 | Max results (1-100) |
| `lang` | string | en | Language code (ISO 639-1) |

### Response

Each result contains:

- **id**, **name**, **type** (hotel, apartment, villa, etc.)
- **location**: address, coordinates, distance from search center
- **rating**: guest rating (0-10), hotel stars (1-5), review count
- **price**: total for the entire stay including taxes
- **capacity**: guests, bedrooms, beds, bathrooms
- **policies**: instant booking, free cancellation
- **media**: thumbnail image, provider logo
- **links**: booking URL, detail page

### Example prompts

- "Find hotels near the Eiffel Tower for 2 adults, checking in March 15"
- "Search for vacation rentals in Barcelona under $150/night"
- "Compare Booking.com hotels near Times Square with at least 4 stars"

## REST API fallback

If MCP is unavailable, the same data is accessible via HTTP:

```
GET {{API_BASE_URL}}/v1/accommodations?provider=booking&address=Paris
```

Pass `x-api-key` header or `key` query parameter for authentication. Full OpenAPI spec at {{API_BASE_URL}}/openapi.json.

## Rate limits

| Tier | Limit |
|------|-------|
| Demo (no key) | 5 requests/minute |
| Authenticated | 100 requests/minute |