---
title: "Search bikes for sale"
method: GET
path: "/api/mcp/search"
tags: ["MCP API"]
---

# Search bikes for sale

`GET /api/mcp/search`

## Request

- Base URL: `https://www.cyclesite.co.uk`
- URL: `https://www.cyclesite.co.uk/api/mcp/search`
- Auth: none required

Search active bike listings. Returns up to 5 results with attribution. No authentication required. Rate limited: 20 requests per minute.

## Query parameters

- `brand` string: Bike brand (case-insensitive)
- `category` string: Bike category (road, mtb, gravel, hybrid, ebike, etc.)
- `city` string: UK city (case-insensitive)
- `minPrice` number, nullable: Minimum price in GBP
- `maxPrice` number, nullable: Maximum price in GBP
- `condition` string: Condition (Excellent, Very_Good, Good, Fair, Poor, For_Parts)
- `limit` number, nullable: Max results (1-5, default 5)

## Response `200`

Search results

- object
  - `attribution` string, required
  - `listings` object[], required
    - `brand` string, nullable, required
    - `city` string, nullable, required
    - `condition` string, nullable, required
    - `model` string, nullable, required
    - `priceGbp` number, nullable, required
    - `title` string, required
    - `url` string, nullable, required
    - `year` number, nullable, required
  - `resultsCount` number, required

## Other responses

- `429`: Rate limited

---

[API](https://skmtc.dev/cyclesite/apis/cyclesite-public-api.md) · [All operations](https://skmtc.dev/cyclesite/apis/cyclesite-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cyclesite/apis/cyclesite-public-api/revisions/a0dc604cce71?raw)