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

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": "your@email.com",
        "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": "your@email.com",
        "WAG_PASSWORD": "yourpassword"
      }
    }
  }
}

Tools

search_walkers

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

Input:

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:

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

schedule_recurring

Set up a recurring walk schedule. Requires authentication.

Input:

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:

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:

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:

Output: Confirmation that the review was submitted.

get_pet_report

Retrieve the post-walk report card. Requires authentication.

Input:

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