# Ridekick API

> One versioned API returns the out-the-door prices from a buyer's own requests, each with its state, lowest written price first within each trim, with a dealership not named to a connected assistant until the buyer has unlocked or picked it (every locked row is labelled by its car). It reads. It does not contact a dealer, accept an offer or complete a purchase.

Reading uses the buyer's own signed-in Ridekick session. The two read endpoints also accept the access token a buyer gave an assistant she approved. API keys are not available. Every page below is Markdown.

A buyer connects an assistant to Ridekick's MCP server at https://www.ridekick.com/api/mcp, and signs in with OAuth.

## Guides

- [Authentication](https://docs.ridekick.com/authentication.md): How a read signs in: the buyer's own session, or the access token a buyer gave an assistant.
- [Requests](https://docs.ridekick.com/deal-sets.md): A request is one ask to several dealers, with the prices that come back.
- [Errors](https://docs.ridekick.com/errors.md): Every error code, its HTTP status, and whether to retry.
- [Rate limits](https://docs.ridekick.com/rate-limits.md): How many reads and writes are allowed, per buyer, per window.
- [Versioning](https://docs.ridekick.com/versioning.md): The version header, additive changes, and what never to branch on.
- [Connect ChatGPT](https://docs.ridekick.com/connect-chatgpt.md): How a buyer adds Ridekick to ChatGPT by its server address, signs in, and what to say first.
- [Connect Claude](https://docs.ridekick.com/connect-claude.md): How a buyer adds Ridekick to Claude as a custom connector, signs in, and what to say first.
- [Deadlines](https://docs.ridekick.com/deadlines.md): How long a read waits before answering unavailable, and how listing is bounded.

## MCP server

- [MCP server](https://docs.ridekick.com/mcp.md): The address, protocol revisions, sign-in and tool list of the Ridekick MCP server.
- [How Ridekick works](https://docs.ridekick.com/mcp/explain.md): The tool that explains Ridekick and the rules for its tools. It needs no sign-in.
- [List my requests](https://docs.ridekick.com/mcp/deal-sets-list.md): The tool that lists the signed-in buyer's requests, one summary each.
- [Get one request](https://docs.ridekick.com/mcp/deal-sets-get.md): The tool that shows one request in full, with each dealership and its state.
- [See what is new on a request](https://docs.ridekick.com/mcp/whats-new.md): The tool that lists only the requests that changed since a time you pass.
- [Preview a request before sending it](https://docs.ridekick.com/mcp/requests-preview.md): The tool that shows what a send would do and contacts no dealership.
- [Send requests to dealerships](https://docs.ridekick.com/mcp/requests-submit.md): The tool that asks dealerships that list a matching car for a price in writing.
- [See one dealership's offer](https://docs.ridekick.com/mcp/get-price-sheet.md): The tool that shows the price from one dealership the buyer has unlocked or chosen, broken into its parts.
- [See this connection's access and limits](https://docs.ridekick.com/mcp/access-get.md): The tool that shows what this connection may do and how much of its daily limit is used.
- [See the choices for a car](https://docs.ridekick.com/mcp/see-car-choices.md): The tool that lists the years, trims, drivetrains and fuel types Ridekick lists for a model.
- [See cars near the buyer](https://docs.ridekick.com/mcp/see-cars-near-buyer.md): The tool that returns up to five cars listed near a ZIP code.
- [Preview a message to one dealership](https://docs.ridekick.com/mcp/messages-preview.md): The tool that shows the exact message a send would deliver and sends nothing.
- [Send a message to one dealership](https://docs.ridekick.com/mcp/messages-send.md): The tool that sends a previewed message to one dealership.
- [Read one dealership's messages](https://docs.ridekick.com/mcp/messages-list.md): The tool that lists the messages with one dealership, oldest first.

## Reference

- [List requests](https://docs.ridekick.com/reference/list-deal-sets.md): The signed-in buyer's requests, one summary each.
- [Get a request](https://docs.ridekick.com/reference/get-deal-set.md): One request's ranked results.
- [List offers](https://docs.ridekick.com/reference/list-price-checks.md): The buyer's offers, one card for each car. Planned: not callable yet.
- [Send a request](https://docs.ridekick.com/reference/create-requests.md): Send a request for written offers from the buyer's connected assistant. Planned: not open to developers yet.
- [Preview a request](https://docs.ridekick.com/reference/preview-requests.md): Preview a request before it is sent, and get the token every send needs. Planned: not open to developers yet.

## Machine-readable

- [OpenAPI document](https://docs.ridekick.com/openapi.json): The OpenAPI 3.1 document for every endpoint, generated from the contract.