markswendsen-code

@striderlabs/mcp-hertz

Community markswendsen-code
Updated

MCP connector for hertz

@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

MCP Server ยท Populars

MCP Server ยท New