# @striderlabs/mcp-wag

An MCP (Model Context Protocol) connector for [Wag](https://wagwalking.com) dog walking and pet care services. Enables AI assistants like Claude to search for walkers, book walks, check walk status with GPS tracking, view walker profiles, leave reviews, and retrieve pet report cards — all via Playwright browser automation against the live Wag website.

## What It Does

This MCP server wraps the Wag web app using Playwright so any MCP-compatible AI client can:

- Search for available dog walkers, sitters, boarding, or daycare near a location
- Book one-time or recurring walk sessions
- Track an in-progress walk with GPS coordinates
- View full walker profiles (bio, certifications, reviews, pricing, photos)
- Rate and tip a walker after a completed walk
- Retrieve the post-walk report card (photos, potty breaks, behavior notes, route)

## Installation

```bash
npm install -g @striderlabs/mcp-wag
# Install Playwright browser binaries (one-time setup)
npx playwright install chromium
```

Or use it directly from the tarball:

```bash
npm install -g ./striderlabs-mcp-wag-1.0.0.tgz
npx playwright install chromium
```

## Configuration

Set these environment variables before running the server:

| Variable        | Required | Description                                                   |
|-----------------|----------|---------------------------------------------------------------|
| `WAG_EMAIL`     | For auth tools | Your Wag account email address                          |
| `WAG_PASSWORD`  | For auth tools | Your Wag account password                               |
| `WAG_HEADLESS`  | No       | Set to `false` to show the browser window (for debugging)    |

`search_walkers` and `view_walker_profile` do not require credentials. All booking, status, rating, and report tools require `WAG_EMAIL` and `WAG_PASSWORD`.

## Usage with Claude Desktop

Add the following to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "wag": {
      "command": "mcp-wag",
      "env": {
        "WAG_EMAIL": "your@email.com",
        "WAG_PASSWORD": "yourpassword",
        "WAG_HEADLESS": "true"
      }
    }
  }
}
```

If you installed from a local path instead of globally:

```json
{
  "mcpServers": {
    "wag": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "WAG_EMAIL": "your@email.com",
        "WAG_PASSWORD": "yourpassword"
      }
    }
  }
}
```

## Tools

### `search_walkers`

Search for available dog walkers by location, date, and service type.

**Input:**
| Field             | Type                                          | Required | Description                           |
|-------------------|-----------------------------------------------|----------|---------------------------------------|
| `location`        | string                                        | Yes      | City, zip, or full address            |
| `date`            | string                                        | Yes      | Date in YYYY-MM-DD format             |
| `service_type`    | `"walk"` \| `"sitting"` \| `"boarding"` \| `"daycare"` | Yes | Type of service         |
| `duration_minutes`| number                                        | No       | Desired walk duration (20, 30, 60)    |

**Output:** List of walker cards with name, rating, review count, price, availability, and profile URL.

---

### `book_walk`

Book a dog walking session. Requires authentication.

**Input:**
| Field                 | Type   | Required | Description                           |
|-----------------------|--------|----------|---------------------------------------|
| `walker_id`           | string | Yes      | Walker profile slug or ID             |
| `pet_name`            | string | Yes      | Name of your pet                      |
| `date`                | string | Yes      | Date in YYYY-MM-DD format             |
| `time`                | string | Yes      | Start time, e.g. `"10:00 AM"`         |
| `duration_minutes`    | number | Yes      | Duration in minutes                   |
| `service_type`        | string | Yes      | Service type                          |
| `special_instructions`| string | No       | Notes for the walker                  |

**Output:** Booking confirmation with booking ID, confirmation URL, and status message.

---

### `schedule_recurring`

Set up a recurring walk schedule. Requires authentication.

**Input:**
| Field             | Type           | Required | Description                            |
|-------------------|----------------|----------|----------------------------------------|
| `walker_id`       | string         | Yes      | Walker profile slug or ID              |
| `pet_name`        | string         | Yes      | Name of your pet                       |
| `days_of_week`    | string[]       | Yes      | Array of days, e.g. `["monday", "wednesday", "friday"]` |
| `time`            | string         | Yes      | Walk time, e.g. `"9:00 AM"`           |
| `duration_minutes`| number         | Yes      | Duration in minutes                    |
| `service_type`    | string         | Yes      | Service type                           |

**Output:** Confirmation of recurring schedule submission.

---

### `get_walk_status`

Check the status of a booking and get GPS tracking if in progress. Requires authentication.

**Input:**
| Field        | Type   | Required | Description      |
|--------------|--------|----------|------------------|
| `booking_id` | string | Yes      | Your booking ID  |

**Output:** Status, walker name, pet name, start/end times, distance walked, live GPS coordinates (if available).

---

### `view_walker_profile`

View a walker's full public profile. No authentication required.

**Input:**
| Field       | Type   | Required | Description               |
|-------------|--------|----------|---------------------------|
| `walker_id` | string | Yes      | Walker profile slug or ID |

**Output:** Full profile including bio, location, rating, review count, pricing per service, certifications, services offered, photos, member since date, repeat client rate, response rate, and up to 5 recent reviews.

---

### `rate_walker`

Submit a star rating and written review after a completed walk. Optionally add a tip. Requires authentication.

**Input:**
| Field        | Type   | Required | Description                      |
|--------------|--------|----------|----------------------------------|
| `booking_id` | string | Yes      | Booking ID of the completed walk |
| `rating`     | number | Yes      | Star rating 1–5                  |
| `review`     | string | Yes      | Written review text              |
| `tip_amount` | number | No       | Tip in dollars, e.g. `5.00`     |

**Output:** Confirmation that the review was submitted.

---

### `get_pet_report`

Retrieve the post-walk report card. Requires authentication.

**Input:**
| Field        | Type   | Required | Description      |
|--------------|--------|----------|------------------|
| `booking_id` | string | Yes      | Your booking ID  |

**Output:** Full report card with walker name, pet name, walk date, duration, distance, steps, average pace, calories burned, potty breaks logged, behavior tags, walker notes, whether a route map is available, and walk photos.

---

## Example Prompts

Once connected to Claude Desktop, you can use natural language:

- *"Find dog walkers near 90210 for next Saturday for a 30-minute walk"*
- *"Show me the profile and reviews for walker john-smith-123"*
- *"Book a walk with walker sarah-jones-456 for my dog Max on 2025-04-15 at 9 AM for 30 minutes"*
- *"Set up recurring Monday/Wednesday/Friday walks at 8 AM with walker tom-brown-789"*
- *"What's the status of my booking ABC123? Is the walker close?"*
- *"Leave a 5-star review for booking XYZ789 saying 'Luna had a great time!' and add a $5 tip"*
- *"Get the report card for booking DEF456 — did Bella have any potty breaks?"*

## Building from Source

```bash
git clone https://github.com/markswendsen-code/mcp-wag.git
cd mcp-wag
npm install
npm run build
# Output: dist/index.js
```

## Troubleshooting

**"WAG_EMAIL and WAG_PASSWORD environment variables are required"**
Set these in your shell or in the MCP server config's `env` block.

**Login fails / redirected to login page**
- Verify your credentials by logging in to wagwalking.com manually.
- Set `WAG_HEADLESS=false` to watch the browser and diagnose the issue.
- Wag may require completing a CAPTCHA on first login from a new browser.

**No walkers found in search results**
- The Wag website structure may have changed. Try setting `WAG_HEADLESS=false` to inspect.
- Try a more specific location (full city + state, or zip code).
- Ensure Playwright Chromium is installed: `npx playwright install chromium`.

**Build fails**
```bash
npm install
node build.js
```
Make sure Node.js 18+ is installed.

**Playwright browser not found**
```bash
npx playwright install chromium
```

## License

MIT — Strider Labs