← Back to all apps

Overview

Tools Available2
DeveloperCarGurus, Inc.
CategoryShopping

Find, buy, and research cars

Available Tools

CarGurus provides 2 tools that can be used to interact with its services.

Vehicle-listing-detail

vehicle-listing-detail
Full Description

Fetch detailed information for a specific vehicle listing by ID.

This tool retrieves comprehensive details about a vehicle including:

  • Basic information (year, make, model, price, mileage)
  • Vehicle specifications (engine, transmission, drivetrain, fuel economy)
  • Complete list of features and options
  • Safety ratings and features (NHTSA ratings, airbags, etc.)
  • Interior and exterior colors
  • Multiple images with various sizes
  • Dealer location and rating
  • Vehicle history (owner count, accident count, salvage status)
  • VIN and stock number

Use this tool when you need complete details about a specific vehicle listing that you already have the ID for (e.g., from a search result).

Parameters

Optional
listing_idnumber

The unique ID of a single vehicle listing to fetch details for (use this OR listing_ids)

listing_idsarray

Array of listing IDs to fetch in batch (use this OR listing_id). Results stream back as they complete.

validate_imagesboolean

Whether to validate that listing images are accessible (default: false)

Default: False
zip_codestring

ZIP code to calculate dealer distance from (e.g., "02140")

Vehicle-listing-search

vehicle-listing-search
Full Description

Search for vehicle listings using natural language queries. Results will be displayed in an interactive widget showing vehicle cards.

IMPORTANT: This tool is only available for US (United States) searches. Do not use this tool for searches outside the United States.

ZIP CODE HANDLING:

  • If the user provides a ZIP code in their query (e.g., "cars near 02140" or "vehicles in Boston, MA"), extract and use it.
  • If the user mentions a city or location (e.g., "cars in Seattle" or "vehicles near me"), use the ZIP code at the center of the city.

This tool allows you to search for cars based on natural language descriptions like:

  • "red SUVs under $30k"
  • "certified pre-owned sedans with low mileage"
  • "electric vehicles near Boston"

The search will: 1. Parse your natural language query into structured filters 2. Find matching vehicle listings near the specified ZIP code 3. Return detailed information including prices, descriptions, dealer info, and images

Example queries:

  • "Toyota trucks with 4WD"
  • "luxury sedans under $50,000"
  • "fuel-efficient cars with less than 50k miles"

Note: Just reply to the user when they view the widget. There's no need to describe the content that's already visible in the UI.

Parameters

Required
search_textstring

Natural language search query (e.g., 'red SUVs under $30k')

Optional
num_resultsnumber

Number of listings to return (1-20, default: 20)

Default: 20
validate_imagesboolean

Whether to validate that listing images are accessible (default: false)

Default: False
zip_codestring

US ZIP code to search near (e.g., '02140' for Cambridge, MA). You MUST extract it from the user's query if mentioned, infer it from location context (city/state) if possible, or ask the user: 'What ZIP code should I search near?' if you cannot determine it.