# io.github.Tomalarrrr/cyclesite-mcp-server (remote · www.cyclesite.co.uk)

Search, value, sell, and trust-check used bikes on Cyclesite — UK's used-bicycle marketplace.

- Trust score: 71/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `www.cyclesite.co.uk`: 71/100 (this document), [markdown](https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/api-mcp-server.md), [page](https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/api-mcp-server)
- npm · `cyclesite-mcp-server`: 30/100, [markdown](https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/cyclesite-mcp-server.md), [page](https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/cyclesite-mcp-server)

## Channel facts

- Endpoint: `https://www.cyclesite.co.uk/api/mcp-server`
- Transports: `streamable-http`
- Auth: `none`
- Version: `2.4.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 28 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 4322 tokens (~102/item across 42 items; 34 tools + 8 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 85/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 48% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http tomalarrrr-cyclesite-mcp-server https://www.cyclesite.co.uk/api/mcp-server
```

### Codex

```toml
[mcp_servers.tomalarrrr-cyclesite-mcp-server]
url = "https://www.cyclesite.co.uk/api/mcp-server"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tomalarrrr-cyclesite-mcp-server": {
      "type": "remote",
      "url": "https://www.cyclesite.co.uk/api/mcp-server",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add tomalarrrr-cyclesite-mcp-server --url https://www.cyclesite.co.uk/api/mcp-server --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  tomalarrrr-cyclesite-mcp-server:
    url: "https://www.cyclesite.co.uk/api/mcp-server"
```

### Other

```json
{
  "mcpServers": {
    "tomalarrrr-cyclesite-mcp-server": {
      "type": "http",
      "url": "https://www.cyclesite.co.uk/api/mcp-server"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 69, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 68, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 66, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 66)

First indexed and scored.

## MCP tools (34)

### `search_bikes` (~161 tokens)

Search live UK used-bike listings on Cyclesite (the UK's used bicycle marketplace). Filter by brand, category, city, price range, and condition. Returns up to 5 active listings with specs and listing URLs. Live data — refreshed continuously as new bikes are listed. Example queries: 'a Trek Domane in Manchester under £2,000', 'gravel bike, very good condition, near Bristol'.

Input parameters:

- `brand` (string): Bike brand (e.g. Trek, Specialized, Canyon).
- `category` (string): Bike category.
- `city` (string): UK city.
- `condition` (string): Condition rating.
- `maxPrice` (number): Maximum price in GBP.
- `minPrice` (number): Minimum price in GBP.

Output parameters:

- `attribution` (string): Citation string — include verbatim when surfacing data.
- `listings` (array)
- `resultsCount` (number)

### `get_recent_listings` (~112 tokens)

What's new on Cyclesite right now — up to 10 of the freshest active UK listings, refreshed every 15 minutes. Use when the user asks 'what's new today?' or 'any new road bikes this week?' rather than for a specific filter. Optional category + maxPrice filters. Live data.

Input parameters:

- `category` (string)
- `limit` (number): How many listings to return (1-10, default 10).
- `maxPrice` (number): Maximum price in GBP.

Output parameters:

- `attribution` (string): Citation string — include verbatim when surfacing data.
- `listings` (array)
- `resultsCount` (number)

### `get_listing_detail` (~107 tokens)

Full details for a specific bike listing on Cyclesite — specs, condition, frame number presence, photos, delivery, seller's city. Provide the URL slug returned by search_bikes or get_recent_listings. Example: after the user says 'tell me more about that 2022 Trek Domane', call this with the slug from the prior result.

Input parameters:

- `slug` (string, required): Listing URL slug (e.g. "used-trek-domane-sl-6-2022").

### `find_similar_listings` (~78 tokens)

Given a Cyclesite listing slug, return up to 5 similar active listings (same category, ±25% price, same brand or frame size weighted higher). Use when the user is interested in one bike and wants alternatives. Example: 'show me bikes like that one'.

Input parameters:

- `slug` (string, required): Source listing URL slug.

Output parameters:

- `attribution` (string): Citation string — include verbatim when surfacing data.
- `listings` (array)
- `resultsCount` (number)

### `search_by_location` (~165 tokens)

Find Cyclesite listings within a radius of a UK location (lat/lng). Radius capped at 50 miles. Returns up to 10 listings ordered by distance. Live UK marketplace data. Example: 'used bikes within 25 miles of LE10 0AA' (geocode the postcode first, then call this).

Input parameters:

- `category` (string)
- `lat` (number, required): Latitude (UK only, 49.5–61.0).
- `limit` (number): 1-10, default 5.
- `lng` (number, required): Longitude (UK only, -8.5–2.0).
- `maxPrice` (number)
- `radiusMiles` (number): Search radius in miles (1-50, default 25).

Output parameters:

- `attribution` (string): Citation string — include verbatim when surfacing data.
- `listings` (array)
- `resultsCount` (number)

### `recommend_bike_for_budget` (~165 tokens)

Curated picks from Cyclesite's live UK inventory for a budget and intent. Prefers higher-engagement listings. Returns up to 5 picks with a one-line rationale each. Example queries: 'a road bike for £1,500 for weekend rides', 'best e-MTB I can buy under £3,000', 'commuter bike in London under £400'.

Input parameters:

- `budgetGbp` (number, required): Maximum budget in GBP.
- `category` (string)
- `city` (string): UK city to focus on (optional).
- `limit` (number): 1-10, default 5.
- `useCase` (string): Free-text intent (e.g. "commuting", "weekend trail", "first road bike").

### `list_brands` (~134 tokens)

Paginated UK bike-brand catalogue from Cyclesite, ordered by stock level. Use to validate a brand name, surface options to a user, or paginate the catalogue. Stock counts are returned as bands (none / 1-5 / 6-25 / 26-100 / 100+) — Cyclesite doesn't expose precise per-brand inventory. Example: 'what brands of e-bike are available?'.

Input parameters:

- `limit` (number): 1-50, default 25.
- `offset` (number): 0-500.
- `q` (string): Optional search filter (case-insensitive contains).

Output parameters:

- `attribution` (string): Citation string — include verbatim when surfacing data.
- `brands` (array)
- `hasMore` (boolean)
- `limit` (number)
- `offset` (number)
- `total` (number)

### `list_models_for_brand` (~122 tokens)

Models for a brand on Cyclesite (paginated). Returns model names, year ranges, in-stock flag. Example: "what Trek road bikes are available?" → list_brands(q:"Trek") → list_models_for_brand(brandSlug:"trek", category:"road").

Input parameters:

- `brandSlug` (string, required): Brand slug from list_brands (lowercase, hyphenated).
- `category` (string)
- `limit` (number): 1-50, default 25.
- `offset` (number): 0-500.

### `get_model_info` (~72 tokens)

Cyclesite catalogue entry for a brand+model: category, year range, AI-generated description, key specs, market summary. Reference data — refreshed when models are added or specs change. Example: 'tell me about the Specialized Allez'.

Input parameters:

- `brand` (string, required)
- `model` (string, required)

### `get_spec_sheet` (~102 tokens)

Aggregated spec sheet for a brand+model[+year], derived from Cyclesite's live UK inventory plus the catalogue record. Returns the most-common frame material, wheel size, groupset, brakes, weight, and (for e-bikes) motor and battery specs. Example: 'what groupset does a Canyon Endurace usually have?'.

Input parameters:

- `brand` (string, required)
- `model` (string, required)
- `year` (number)

### `compare_bikes` (~78 tokens)

Side-by-side comparison of up to 3 bikes (each by brand+model[+year]). Returns spec sheets and valuations together so the user can pick. Reuses get_spec_sheet + get_valuation server-side. Example: 'compare a Trek Domane SL 6 against a Specialized Roubaix Comp'.

Input parameters:

- `bikes` (array, required)

### `get_size_guide` (~96 tokens)

Frame-size recommendation for a rider's height and bike category, sourced from Cyclesite's real UK listings (riders' declared heights against frame sizes they bought). Falls back to industry-standard charts when the dataset is thin. Example: 'I'm 178cm — what road-bike size do I need?'.

Input parameters:

- `category` (string)
- `heightCm` (number, required): Rider height in centimetres (120-220).

### `get_valuation` (~107 tokens)

What a used UK bike is worth right now, Cyclesite's flagship tool. Returns median, range, a measured price-by-model-year curve, confidence level, and comparable active listings. Sourced from real UK market prices, the last-advertised asking prices bikes are listed for (not confirmed sale prices), refreshed nightly. Example: 'what's a 2022 Trek Domane SL 6 worth?'.

Input parameters:

- `brand` (string, required)
- `model` (string, required)

Output parameters:

- `activeListings` (number)
- `attribution` (string): Citation string — include verbatim when surfacing data.
- `avgDaysToSell` (number)
- `basis` (string)
- `citationUrls` (object)
- `conditionBreakdown` (object)
- `confidence` (string)
- `maxPriceGbp` (number): Price in GBP.
- `medianPriceGbp` (number): Price in GBP.
- `minPriceGbp` (number): Price in GBP.
- `priceByModelYear` (array)
- `priceTrend` (string)
- `retention` (object|null)
- `sampleSize` (number)
- `summary` (string): One-sentence summary safe to quote verbatim.
- `url` (string)

### `suggest_listing_price` (~98 tokens)

For a seller about to list: suggested ask, floor, and ceiling for their bike's brand+model[+condition] on the UK market. Same measured UK used-price data as get_valuation but framed as seller guidance. Example: 'I'm selling a 2021 Specialized Allez in good condition — what should I ask?'.

Input parameters:

- `brand` (string, required)
- `condition` (string)
- `model` (string, required)

### `get_market_index` (~70 tokens)

Current UK used-bike market prices by category, from Cyclesite's nightly index. Returns median + range per category (road, mtb, gravel, e-bike, etc.). Example: 'how does the UK used-bike market look right now?'. Refreshed nightly from real UK market prices.

### `get_market_health` (~73 tokens)

Buyer's-vs-seller's market signal for the UK used-bike market — should the user buy or sell now? Composite indicator from days-to-sell, asking-vs-sold-price spread, and inventory levels. Example: 'is now a good time to buy a road bike?'. Refreshed nightly.

### `get_depreciation` (~81 tokens)

Brands ranked by how well (or poorly) they hold their value, from Cyclesite's measured UK used-price data. Returns top N brands by % retained vs new RRP. Example: 'which bike brands hold their value best?'.

Input parameters:

- `limit` (number): 1-20, default 10.
- `sort` (string)

### `get_price_trends` (~72 tokens)

UK used-bike price trends over the last N months by category, from Cyclesite's index series. Example: 'how have road-bike prices changed in 2026?'. Monthly data, refreshed at month-end.

Input parameters:

- `category` (string)
- `months` (number): 1-24.

### `grade_listing_quality` (~95 tokens)

Categorical quality grade for a Cyclesite listing (excellent / good / fair / weak) plus up to 2 wins and 2 flags. Helps a buyer assess trustworthiness; helps a seller self-audit. Example: 'is this listing trustworthy?' (provide the slug). Note: returns the *categorical* judgement only, not the underlying score (intentional to avoid gaming).

Input parameters:

- `slug` (string, required)

### `draft_listing` (~158 tokens)

Sell-side helper: turn a seller's raw facts into a polished Cyclesite listing draft (title, description, suggested price, photo plan). Does NOT publish — for actual publication use publish_listing (requires OAuth). Useful for previewing what a listing would look like. Example: 'help me draft a listing for my 2021 Specialized Allez, very good condition, in Bristol'.

Input parameters:

- `brand` (string, required)
- `city` (string)
- `condition` (string)
- `frameSize` (string)
- `groupset` (string)
- `knownIssues` (string): Honest declaration of any issues.
- `model` (string, required)
- `willShip` (boolean)
- `year` (number)

### `check_stolen` (~98 tokens)

Check if a UK bicycle is reported stolen by serial number. Cyclesite aggregates lookups across UK stolen-bike databases — the unique data we own. Per-serial rate-limited (3/hour) to prevent enumeration. Example: 'is the bike with serial WTU123456 reported stolen?'. Live data — cross-references multiple registries on every call.

Input parameters:

- `serial` (string, required): Frame/serial number (4-50 chars).

Output parameters:

- `action` (string)
- `attribution` (string): Citation string — include verbatim when surfacing data.
- `checkedAt` (string)
- `confidence` (number)
- `confidenceLabel` (string)
- `message` (string)
- `sourcesChecked` (integer)
- `status` (string)
- `url` (string)

### `report_stolen` (~78 tokens)

Step-by-step guidance for reporting a stolen UK bike: police, insurance, listing alerts. Returns a 5-step checklist plus the official Cyclesite report URL. Example: 'my bike was just stolen, what do I do?'.

Input parameters:

- `brand` (string)
- `model` (string)
- `serial` (string)

### `get_buying_guide` (~118 tokens)

Search Cyclesite's expert buying guides (24+ articles by cycling-journalism authors). Returns up to 3 matching guides with title, excerpt, difficulty, reading time, and URL. Use for educational queries that don't need live inventory. Example: 'how do I choose a bike size?', 'tips for buying a used e-bike'.

Input parameters:

- `limit` (number): 1-5, default 3.
- `query` (string, required): What to search for (e.g. "first road bike", "bike sizing").

### `publish_listing` (~308 tokens)

Publish a Cyclesite listing on the user's behalf. Multi-step: first call (no draftId) returns a phone-friendly photo upload URL; once 3+ photos are uploaded, the next call returns either step:'live' (during launch promo, no fee) or step:'payment_required' with a Stripe Checkout URL for the £10.99 listing fee. Idempotent — keep calling with the same draftId until step:'live'. Requires OAuth scope `listings:publish`. Example flow: user says 'sell my Trek Domane' → call publish_listing → assistant directs user to upload URL → user uploads → call again → step:'live' → seller receives a confirmation email with a 24h undo link.

Input parameters:

- `brand` (string)
- `category` (string)
- `city` (string): UK city.
- `condition` (string)
- `description` (string): Listing description (30-5000 chars).
- `draftId` (string): Returned by a previous call. Omit on first call.
- `frameSerial` (string): Frame/serial number — runs a stolen-bike check before publish.
- `frameSize` (string)
- `groupset` (string)
- `knownIssues` (string)
- `model` (string)
- `priceGbp` (number)
- `title` (string): Listing title (10-160 chars).
- `willShip` (boolean)
- `year` (number)

Output parameters:

- `draftId` (string)
- `listingFeeGbp` (number): Price in GBP.
- `listingUrl` (string)
- `message` (string)
- `paymentUrl` (string)
- `photoUploadUrl` (string)
- `photosNeeded` (number)
- `step` (string)

### `list_my_listings` (~62 tokens)

Show the authenticated user's Cyclesite listings (draft / active / sold). Requires OAuth scope `listings:read`. Example: 'how are my listings doing?'.

Input parameters:

- `limit` (number): 1-20.
- `status` (string)

### `mark_as_sold` (~70 tokens)

Mark a Cyclesite listing as sold (optionally with the final sale price). Requires OAuth scope `listings:manage`. Example: 'mark my Trek Domane as sold for £1,750'.

Input parameters:

- `listingId` (string, required)
- `salePriceGbp` (number)

### `get_my_enquiries` (~60 tokens)

Show buyer enquiries on the authenticated user's Cyclesite listings. Requires OAuth scope `listings:read`. Example: 'any messages about my Trek?'.

Input parameters:

- `limit` (number): 1-20.
- `listingId` (string)

### `get_my_messages` (~121 tokens)

Read the buyer's own Cyclesite message threads and any seller replies. Call with no args to list your conversations; pass a threadId to read one thread's messages. Pairs with make_enquiry (which saves the enquiry to your inbox). Requires OAuth scope `listings:read`. Example: 'did the seller of that Trek reply yet?'.

Input parameters:

- `limit` (number): 1-50.
- `threadId` (string): Thread id from a prior get_my_messages list or make_enquiry. Omit to list all your threads.

### `respond_to_enquiry` (~69 tokens)

Reply to a buyer enquiry on the authenticated user's listing. Requires OAuth scope `enquiries:respond`. Example: 'reply to that enquiry — say it's still available, collection only'.

Input parameters:

- `answer` (string, required): Reply text (1-2000 chars).
- `enquiryId` (string, required)

### `search` (~80 tokens)

OpenAI deep-research / company-knowledge compatibility. Search Cyclesite's active UK used-bike listings by free-text query (matches title, brand, model). Returns the canonical OpenAI shape: { results: [{ id, title, url }] }. Use the id to call fetch() for the full document.

Input parameters:

- `query` (string, required): Free-text query.

Output parameters:

- `results` (array)

### `fetch` (~86 tokens)

OpenAI deep-research / company-knowledge compatibility. Fetch the full document for a Cyclesite listing id (returned by the search tool). Returns { id, title, text, url, metadata } — text is a plain-prose summary of the listing's description and specs, suitable for direct quoting in deep-research answers.

Input parameters:

- `id` (string, required): Document id from search results.

Output parameters:

- `id` (string)
- `metadata` (object)
- `text` (string)
- `title` (string)
- `url` (string)

### `save_search` (~221 tokens)

Subscribe the user to alerts for new Cyclesite listings matching a filter — the AI assistant will then proactively notify them when a matching bike appears (price drop or fresh listing). Requires OAuth scope `listings:read` (read-only on data, but this is technically a write — it creates a SavedSearch row on the user's account). Examples: 'let me know when a Trek Domane SL 6 in Manchester under £2,000 appears', 'alert me to any e-MTB drops below £2,500 in Yorkshire'. Each user is capped at 50 active alerts.

Input parameters:

- `alertFrequency` (string): How often to send digest. Default: instant.
- `brand` (string)
- `category` (string)
- `city` (string): UK city to focus on.
- `condition` (string)
- `maxPrice` (number)
- `minPrice` (number)
- `model` (string)
- `name` (string): Optional human-readable name (e.g. "Trek Domane in Manchester").

### `make_enquiry` (~150 tokens)

Send an enquiry to a Cyclesite seller on the buyer's behalf. It's saved to the buyer's Cyclesite inbox and the seller is notified. Per-buyer-per-listing daily cap (2/day) prevents spam. Read the seller's reply with get_my_messages. Requires OAuth scope `enquiries:respond` (note: the scope name is shared with seller-side replies). Example: 'message the seller of that Trek and ask if they'd take £1,400 collection only in Manchester next Saturday'.

Input parameters:

- `listingId` (string, required): Bike ID from search_bikes / get_listing_detail.
- `message` (string, required): The buyer's question to the seller (10-2000 chars).

### `reserve_listing` (~163 tokens)

Hold a Cyclesite listing for 24 hours so other buyers can't claim it while the user decides. The hold is free and advisory (the seller isn't obligated to honour it — message the seller to confirm). Paid deposit-backed holds are coming soon; do not offer deposits today. The first UK marketplace where a buyer can COMMIT inside an AI conversation. Requires OAuth scope `listings:manage`. Example: 'put a hold on that Trek for me, I want to view it Saturday'.

Input parameters:

- `depositGbp` (number): COMING SOON — deposits are not yet available; omit this field (the server refuses it with payments_unavailable). When live: optional refundable deposit (£10-£500) via Stripe Checkout.
- `listingId` (string, required)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/api-mcp-server#diagnostics

## Score history

- 2026-08-03: 71
- 2026-08-02: 70
- 2026-08-01: 70
- 2026-07-31: 69
- 2026-07-30: 68
- 2026-07-29: 68
- 2026-07-28: 67
- 2026-07-27: 66
- 2026-07-26: 66

## Links

- Remote endpoint: https://www.cyclesite.co.uk/api/mcp-server
- Website: https://www.cyclesite.co.uk/
- Changelog RSS feed: https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/api-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/api-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/tomalarrrr-cyclesite-mcp-server/api-mcp-server