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
| Argument | Type | Required | Meaning |
|---|---|---|---|
make | string | Yes | The make, for example Honda. |
model | string | Yes | The model, for example Civic. |
year | integer | With zip | Narrows trims, drivetrains and fuels to this model year. |
trim | string | No | Narrows drivetrains and fuels to this trim. With zip, a trim to look for. |
zip | string | No | The buyer's five-digit ZIP code. With it and year, you get one yes or no for cars near the buyer. |
radius | integer | No | With zip: miles from her ZIP code, from 1 to 100. The default is 100. |
drivetrain | string | No | With zip: a drivetrain to look for. |
fuel | string | No | With zip: a fuel type to look for. |
exteriorColor | string | No | With zip: the buyer's own words. Give interiorColor too. |
interiorColor | string | No | With 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:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "see_car_choices",
"arguments": {
"make": "Honda",
"model": "Civic",
"year": 2024,
"zip": "94103"
}
}
}Related
See cars near the buyer, This connection's access and limits.
Last updated