@striderlabs/mcp-hertz

A Model Context Protocol (MCP) connector for the Hertz car rental service. This connector enables AI assistants (such as Claude) to search for vehicles, manage reservations, look up locations, retrieve rental policies, and check Gold Plus Rewards loyalty status — all through Hertz's website via headless browser automation.

Overview

This connector uses Playwright to drive a headless Chromium browser against hertz.com. It exposes 10 MCP tools that cover the full car rental workflow:

• Search available vehicles
• Get detailed vehicle and rate information
• Find nearby Hertz locations
• Create, view, modify, and cancel reservations
• Retrieve rental policies and insurance options
• Add optional extras (GPS, child seats, etc.)
• Check Gold Plus Rewards loyalty status

Prerequisites

• Node.js 18 or higher
• npm 9 or higher
• Internet access to reach hertz.com

Installation

From the package directory

npm install
npx playwright install chromium
npm run build

As a global CLI

npm install -g @striderlabs/mcp-hertz
npx playwright install chromium

Configuration

No API keys or environment variables are required. The connector uses public-facing Hertz web pages. Network access to https://www.hertz.com must be available from the host running the connector.

Optional environment variables that may influence Playwright behavior:

| Variable | Description | |---|---| | PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH | Path to a custom Chromium binary | | HTTP_PROXY / HTTPS_PROXY | Proxy server for outbound requests |

Running the Server

# Development (TypeScript source)
npm run dev

# Production (compiled)
npm run build
npm start

The server communicates over stdio using the MCP protocol and is designed to be launched by an MCP host such as Claude Desktop.

Claude Desktop Configuration

Add the following to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "hertz": {
      "command": "node",
      "args": ["/path/to/mcp-hertz/dist/index.js"]
    }
  }
}

Or, if installed globally:

{
  "mcpServers": {
    "hertz": {
      "command": "mcp-hertz"
    }
  }
}

Tools

1. search_vehicles

Search for available Hertz vehicles at a given location and date range.

| Parameter | Type | Required | Description | |---|---|---|---| | pickup_location | string | Yes | City name, airport code (e.g. LAX), or address | | dropoff_location | string | No | Return location if different from pickup | | pickup_date | string | Yes | ISO date YYYY-MM-DD | | pickup_time | string | Yes | 24-hour time HH:MM | | dropoff_date | string | Yes | ISO date YYYY-MM-DD | | dropoff_time | string | Yes | 24-hour time HH:MM | | vehicle_class | enum | No | Economy, Compact, Midsize, Standard, Fullsize, Premium, Luxury, SUV, Van, Truck | | driver_age | number | No | Driver age in years (default: 25) | | discount_code | string | No | Promotional or discount code |

Returns: Array of VehicleResult objects with make/model, class, transmission, passengers, bags, daily rate, total rate, features, and availability.

2. get_vehicle_details

Retrieve detailed information and rate breakdown for a specific vehicle.

| Parameter | Type | Required | Description | |---|---|---|---| | vehicle_id | string | Yes | Vehicle ID from search_vehicles results | | rate_code | string | No | Rate code for specific pricing |

Returns: VehicleResult extended with rate_details (base rate, taxes, total, cancellation policy).

3. get_locations

Find Hertz rental locations near a city, airport, or set of coordinates.

| Parameter | Type | Required | Description | |---|---|---|---| | query | string | Yes | City name, airport code (e.g. ORD), or street address | | type | enum | No | airport, city, or all (default: all) | | latitude | number | No | Latitude for proximity search | | longitude | number | No | Longitude for proximity search | | radius_miles | number | No | Search radius in miles (default: 25) |

Returns: Array of Location objects with name, address, city, state, phone, hours, and airport info.

4. create_reservation

Create a new Hertz rental reservation.

| Parameter | Type | Required | Description | |---|---|---|---| | vehicle_id | string | Yes | Vehicle ID from search results | | rate_code | string | No | Rate code for pricing | | pickup_location_id | string | Yes | Location ID for pickup | | dropoff_location_id | string | No | Location ID for return (defaults to pickup) | | pickup_datetime | string | Yes | ISO datetime e.g. 2025-06-15T10:00:00 | | dropoff_datetime | string | Yes | ISO datetime e.g. 2025-06-20T10:00:00 | | driver_first_name | string | Yes | Driver's first name | | driver_last_name | string | Yes | Driver's last name | | driver_email | string | Yes | Driver's email address | | driver_phone | string | Yes | Driver's phone number | | driver_age | number | No | Driver age in years | | discount_code | string | No | Promotional or discount code | | cdp_number | string | No | Corporate Discount Program number | | loyalty_number | string | No | Hertz Gold Plus Rewards member number |

Returns: Reservation object with confirmation number, status, vehicle, locations, dates, driver info, and total cost.

5. get_reservation

Look up an existing reservation by confirmation number and last name.

| Parameter | Type | Required | Description | |---|---|---|---| | confirmation_number | string | Yes | Hertz confirmation number | | last_name | string | Yes | Driver's last name as on the reservation |

Returns: Reservation object.

6. modify_reservation

Modify an existing reservation (dates, locations, or vehicle class).

| Parameter | Type | Required | Description | |---|---|---|---| | confirmation_number | string | Yes | Hertz confirmation number | | last_name | string | Yes | Driver's last name | | new_pickup_datetime | string | No | New pickup date/time in ISO format | | new_dropoff_datetime | string | No | New dropoff date/time in ISO format | | new_pickup_location_id | string | No | New pickup location ID | | new_dropoff_location_id | string | No | New dropoff location ID | | new_vehicle_class | enum | No | New vehicle class preference |

Returns: Updated Reservation object.

7. cancel_reservation

Cancel an existing reservation. Free cancellation is available up to 24 hours before the scheduled pickup.

| Parameter | Type | Required | Description | |---|---|---|---| | confirmation_number | string | Yes | Hertz confirmation number | | last_name | string | Yes | Driver's last name | | reason | string | No | Optional reason for cancellation |

Returns: Object with success boolean, message, and confirmation_number.

8. get_rental_policies

Retrieve Hertz rental policies, insurance options, and fee information.

| Parameter | Type | Required | Description | |---|---|---|---| | location_id | string | No | Location ID for location-specific policies | | vehicle_class | enum | No | Vehicle class for class-specific notes | | country | string | No | Country code (default: US) |

Returns: Policy object including minimum age requirements, fuel policy, mileage policy, insurance options, cancellation terms, accepted payment methods, and Gold Plus Rewards information.

9. add_extras

Add optional extras to an existing reservation.

| Parameter | Type | Required | Description | |---|---|---|---| | confirmation_number | string | Yes | Hertz confirmation number | | last_name | string | Yes | Driver's last name | | extras | array | Yes | Array of { extra_id, quantity } objects |

Available extra_id values:

| ID | Name | Pricing | |---|---|---| | gps | Hertz NeverLost GPS | $12.99/day | | child_seat | Child Safety Seat | $13.99/day | | booster_seat | Booster Seat | $9.99/day | | additional_driver | Additional Driver | $13.99/day | | rsa_plus | Roadside Assistance Plus | $5.99/day | | wifi | Wi-Fi Hotspot | $10.99/day | | sirius_xm | SiriusXM Satellite Radio | $8.99 flat | | ski_rack | Ski Rack | $29.99 flat | | prepaid_fuel | Prepaid Fuel Option | $45.00 flat |

Returns: Object with updated extras list and new total cost.

10. get_loyalty_status

Check Hertz Gold Plus Rewards loyalty status including tier, points balance, year-to-date rentals, and free day certificates.

| Parameter | Type | Required | Description | |---|---|---|---| | member_id | string | No | Gold Plus Rewards member ID | | email | string | No | Email address on the account | | pin | string | Yes | Gold Plus Rewards PIN or password |

Note: Either member_id or email must be provided along with pin.

Returns: LoyaltyStatus object with member ID, name, tier (Gold / Five Star / President's Circle / Platinum), points balance, rentals year-to-date, and free day certificate count.

Notes on Browser Automation

• The connector launches a headless Chromium browser via Playwright for each tool call and closes it upon completion.
• Playwright Chromium must be installed separately with npx playwright install chromium.
• Each tool call makes a real network request to hertz.com. Response times depend on site performance (typically 5–30 seconds).
• Hertz's website uses heavy JavaScript rendering. The connector waits for networkidle state before extracting data.
• If the live site returns no parseable DOM data (e.g. due to a site redesign or anti-bot measures), several tools fall back to structured placeholder responses so that the calling agent can continue reasoning.
• Do not use this connector to make real reservations with real payment information without understanding the full booking flow and Hertz's terms of service.

License

MIT