@striderlabs/mcp-zipcar 1.0.0

package/README.md

@@ -0,0 +1,136 @@
+# @striderlabs/mcp-zipcar
+
+A Model Context Protocol (MCP) server for automating Zipcar car sharing tasks via stealth browser automation using [patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_cars` | Find available Zipcars near a location for a given time period |
+| `get_car_details` | Get vehicle info: type, features, seating, fuel, hourly/daily rates |
+| `reserve_car` | Book a Zipcar for a specific time slot (requires login) |
+| `extend_reservation` | Add time to an existing reservation |
+| `end_trip` | End an active rental session and get a trip summary |
+| `get_reservation_history` | View past and upcoming reservations |
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+### With Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "zipcar": {
+      "command": "npx",
+      "args": ["-y", "@striderlabs/mcp-zipcar"]
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "zipcar": {
+      "command": "striderlabs-mcp-zipcar"
+    }
+  }
+}
+```
+
+### With Claude Code
+
+```bash
+claude mcp add zipcar -- npx -y @striderlabs/mcp-zipcar
+```
+
+## Authentication
+
+Tools that require authentication (`reserve_car`, `extend_reservation`, `end_trip`, `get_reservation_history`) require you to be logged in to Zipcar in a browser session. The server shares a persistent browser context across requests within the same session.
+
+If not logged in, you will receive an `auth_required` response with instructions to log in manually.
+
+## Tool Examples
+
+### Search for cars
+
+```json
+{
+  "tool": "search_cars",
+  "arguments": {
+    "location": "Brooklyn, NY",
+    "start_time": "2025-08-15T09:00:00",
+    "end_time": "2025-08-15T13:00:00"
+  }
+}
+```
+
+### Reserve a car
+
+```json
+{
+  "tool": "reserve_car",
+  "arguments": {
+    "car_id": "car-12345",
+    "start_time": "2025-08-15T09:00:00",
+    "end_time": "2025-08-15T13:00:00",
+    "plan": "hourly"
+  }
+}
+```
+
+### Get reservation history
+
+```json
+{
+  "tool": "get_reservation_history",
+  "arguments": {
+    "filter": "upcoming",
+    "limit": 10
+  }
+}
+```
+
+### Extend a reservation
+
+```json
+{
+  "tool": "extend_reservation",
+  "arguments": {
+    "reservation_id": "res-98765",
+    "new_end_time": "2025-08-15T15:00:00"
+  }
+}
+```
+
+### End a trip
+
+```json
+{
+  "tool": "end_trip",
+  "arguments": {
+    "reservation_id": "res-98765"
+  }
+}
+```
+
+## Notes
+
+- Browser automation targets zipcar.com and may break if Zipcar updates their website structure.
+- Patchright is used for stealth browser automation to avoid bot detection.
+- A headless Chromium instance is launched on first tool call and reused for the session.
+
+## License
+
+MIT — Strider Labs <hello@striderlabs.ai>

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}