@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