Skip to content
ridekickDevelopersv1 · 2026-10-13

See the choices for a car

see_car_choices: the years, trim levels, drivetrains and fuel types Ridekick lists for one make and model.

Who can use it

Any connected assistant. It reads nothing about the buyer. It is listed only where it is turned on. Sign in with OAuth. See Authentication.

Arguments

ArgumentTypeRequiredMeaning
makestringYesThe make, for example Honda.
modelstringYesThe model, for example Civic.
yearintegerWith zipNarrows trims, drivetrains and fuels to this model year.
trimstringNoNarrows drivetrains and fuels to this trim. With zip, a trim to look for.
zipstringNoThe buyer's five-digit ZIP code. With it and year, you get one yes or no for cars near the buyer.
radiusintegerNoWith zip: miles from her ZIP code, from 1 to 100. The default is 100.
drivetrainstringNoWith zip: a drivetrain to look for.
fuelstringNoWith zip: a fuel type to look for.
exteriorColorstringNoWith zip: the buyer's own words. Give interiorColor too.
interiorColorstringNoWith zip: the buyer's own words. Give exteriorColor too.

What it returns

The choices we list for the model. They carry no dollar amounts, colors or options, and they do not say whether a car is for sale near the buyer. With zip and year you get one yes or no, carsNearby, for whether a car like the one described is listed near the buyer. That answer has no count, dealership, town, distance or dollar amount, and it is not a promise that a car is for sale. If found is false, we list no such make and model: ask the buyer to check the spelling. Each connection can ask a limited number of times a day.

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_car_choices",
    "arguments": {
      "make": "Honda",
      "model": "Civic",
      "year": 2024,
      "zip": "94103"
    }
  }
}

See cars near the buyer, This connection's access and limits.

Last updated