@striderlabs/mcp-wag

An MCP (Model Context Protocol) connector for Wag 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

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

Or use it directly from the tarball:

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):

{
  "mcpServers": {
    "wag": {
      "command": "mcp-wag",
      "env": {
        "WAG_EMAIL": "[email protected]",
        "WAG_PASSWORD": "yourpassword",
        "WAG_HEADLESS": "true"
      }
    }
  }
}

If you installed from a local path instead of globally:

{
  "mcpServers": {
    "wag": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "WAG_EMAIL": "[email protected]",
        "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

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

npm install
node build.js

Make sure Node.js 18+ is installed.

Playwright browser not found

npx playwright install chromium

License

MIT — Strider Labs

@striderlabs/mcp-wag