See cars near the buyer

see_cars_near_buyer: up to five cars listed near a ZIP code.

Who can use it

A connected assistant on an account that was granted it. It is listed only for such an account; for any other it answers as if it does not exist. Sign in with OAuth. See Authentication.

Arguments

Argument	Type	Required	Meaning
`make`	string	Yes	The make, for example Kia.
`model`	string	Yes	The model, for example Telluride.
`zip`	string	Yes	The buyer's five-digit ZIP code.
`year`	integer	No	A model year. Left out, the search covers every model year.
`radius`	integer	No	Miles from her ZIP code, from 1 to 100. With no radius, the search starts at 50 miles and widens to 100 when fewer than five cars match.
`trim`	string	No	A trim to look for.
`drivetrain`	string	No	A drivetrain to look for.
`fuel`	string	No	A fuel type to look for.
`exteriorColor`	string	No	The buyer's own words. A color family, such as White or Gray, matches more cars than a dealer's color name.
`interiorColor`	string	No	The buyer's own words. A color family, such as Black or Gray, matches more cars than a dealer's color name.
`condition`	string	No	`new` or `used`. When given, it applies to every model year. Left out, the search covers new cars when no model year is given or the model year is the current one or later, and both new and used cars for an older model year.

What it returns

Each match has a handle, a label that names the car (the color, model year, model and trim, the miles to the nearest 100, and the listed price before taxes and dealer fees), and the exterior and interior color. The label never names a dealership. A part of the label the listing does not have is left out. The list does not say how many cars there are, and a listing does not mean the car is still for sale. A handle is valid for a limited time, for this buyer only; pass it as listingId to requests_preview or requests_submit.

On an account that was granted new-car requests, a match also has condition: new or used. It is there only when the listing says exactly one of those. A match with no condition goes to the one dealership that lists it.

Errors

A call the tool cannot do answers with isError: true and a body of the form { "error": { "code": "...", "message": "..." } }. Branch on error.code; the codes are on the Errors page. A missing or no longer valid token gets a sign-in challenge instead: a JSON-RPC error with code -32001 and a WWW-Authenticate header. See Authentication.

Example

A tools/call request to https://www.ridekick.com/api/mcp:

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "see_cars_near_buyer",
    "arguments": {
      "make": "Kia",
      "model": "Telluride",
      "zip": "94103",
      "year": 2024
    }
  }
}

Send requests to dealerships, See the choices for a car.

Last updated October 10, 2026