# @striderlabs/mcp-rover

A Model Context Protocol (MCP) connector for [Rover](https://www.rover.com) — the pet services marketplace. Enables AI assistants to search for pet sitters, manage bookings, communicate with sitters, and handle pet profiles through Rover's platform.

## Features

- Search pet sitters by location, service type, and dates
- View detailed sitter profiles with reviews and pricing
- Browse available service types (boarding, walking, drop-in, etc.)
- Request bookings and manage existing ones
- Send and receive messages with sitters
- Manage pet profiles (add, update, list)
- Leave reviews for completed services
- View favorited sitters

## Prerequisites

- Node.js 18+
- A Rover account at [rover.com](https://www.rover.com)
- Playwright browsers installed

## Installation

```bash
npm install @striderlabs/mcp-rover

# Install Playwright browsers (first time only)
npx playwright install chromium
```

## MCP Configuration

Add to your MCP client configuration (e.g., Claude Desktop `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "rover": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-rover"]
    }
  }
}
```

Or if installed globally:

```json
{
  "mcpServers": {
    "rover": {
      "command": "mcp-rover"
    }
  }
}
```

## Available Tools

### Authentication

#### `login`
Log in to your Rover account.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| email | string | Yes | Your Rover email |
| password | string | Yes | Your Rover password |

### Sitter Search

#### `search_sitters`
Search for pet sitters by location and service type.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| location | string | Yes | City, neighborhood, or zip code |
| serviceType | enum | Yes | `boarding`, `house_sitting`, `drop_in`, `doggy_day_care`, `dog_walking` |
| startDate | string | No | YYYY-MM-DD format |
| endDate | string | No | YYYY-MM-DD format |
| petCount | number | No | Number of pets |
| petSize | enum | No | `small`, `medium`, `large`, `giant` |

#### `get_sitter_profile`
Get detailed profile for a sitter including reviews and rates.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| sitterIdOrUrl | string | Yes | Sitter username or full Rover profile URL |

#### `search_services`
List all available service types in a location.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| location | string | Yes | Location to search |

### Bookings

#### `request_booking`
Send a booking request to a sitter. Requires login.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| sitterId | string | Yes | Sitter ID or profile URL |
| serviceType | enum | Yes | Type of service |
| startDate | string | Yes | YYYY-MM-DD |
| endDate | string | Yes | YYYY-MM-DD |
| petIds | string[] | Yes | Array of pet IDs |
| message | string | No | Message to the sitter |

#### `get_bookings`
View all current and past bookings. Requires login.

### Messaging

#### `message_sitter`
Send a message to a sitter. Requires login.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| sitterId | string | Yes | Sitter ID or profile URL |
| message | string | Yes | Message text |

#### `get_messages`
Get message threads. Requires login.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| sitterId | string | No | Filter to a specific sitter thread |

### Pet Management

#### `add_pet_profile`
Add a new pet to your account. Requires login.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | Yes | Pet's name |
| species | enum | Yes | `dog`, `cat`, `other` |
| breed | string | No | Pet's breed |
| age | number | No | Age in years |
| weight | number | No | Weight in pounds |
| size | enum | No | `small`, `medium`, `large`, `giant` |
| temperament | string | No | Personality description |
| specialNeeds | string | No | Medical/care requirements |
| vaccinated | boolean | No | Vaccination status |
| spayedNeutered | boolean | No | Spayed/neutered status |

#### `update_pet_profile`
Update an existing pet profile. Requires login.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| petId | string | Yes | Pet's Rover ID |
| ...fields | — | No | Any fields from `add_pet_profile` |

#### `get_pets`
List all pets on your account. Requires login.

### Reviews & Favorites

#### `leave_review`
Leave a review for a completed service. Requires login.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| bookingId | string | Yes | Booking ID |
| rating | number | Yes | 1–5 stars |
| reviewText | string | Yes | Written review |

#### `get_favorites`
Get your list of favorited sitters. Requires login.

## Usage Examples

```
# Search for dog boarders in Seattle for a week
search_sitters location="Seattle, WA" serviceType="boarding" startDate="2025-06-01" endDate="2025-06-07"

# View a sitter's full profile
get_sitter_profile sitterIdOrUrl="john-d"

# Book a sitter
request_booking sitterId="john-d" serviceType="boarding" startDate="2025-06-01" endDate="2025-06-07" petIds=["pet-123"] message="Hi! My dog Bella is friendly and loves to play."

# Send a message
message_sitter sitterId="john-d" message="Hi, is your place good for large dogs?"
```

## Development

```bash
# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev
```

## Architecture

- **`src/index.ts`** — MCP server entry point. Defines all tools, handles request routing, formats responses.
- **`src/browser.ts`** — Playwright-based browser automation layer. Handles all interactions with rover.com.

The server uses stdio transport for MCP communication and launches a headless Chromium browser to interact with Rover's website.

## Notes

- This connector uses browser automation to interact with Rover's website, as Rover does not provide a public API.
- Login credentials are only used for the current session and are never stored.
- Browser runs in headless mode by default.

## License

MIT