MCP Radar
MCP-Server

cyclesite-mcp-server

io.github.Tomalarrrr/cyclesite-mcp-server
Commerce & Retail Suche & Recherche Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Supports searching, comparing, valuing, buying, selling, reserving, and messaging about used bicycles on a UK marketplace.

Funktionen

Tools

34 Tools
check_stolen
Check if a UK bicycle is reported stolen by serial number. Cyclesite checks an international stolen-bike registry and theft reports filed by riders, 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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['serial'], 'properties': {'serial': {'type': 'string', 'description': 'Frame/serial number (4-50 chars).'}}}
Ausgabeschema 
{'type': 'object', 'required': ['status', 'attribution'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'action': {'type': 'string'}, 'status': {'enum': ['CLEAR', 'STOLEN', 'POSSIBLE_MATCH', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'checkedAt': {'type': 'string', 'format': 'date-time'}, 'confidence': {'type': 'number'}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}, 'sourcesChecked': {'type': 'integer'}, 'confidenceLabel': {'type': 'string'}}}
compare_bikes
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'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['bikes'], 'properties': {'bikes': {'type': 'array', 'items': {'type': 'object', 'required': ['brand', 'model'], 'properties': {'year': {'type': 'number'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}}}}}}
Ausgabeschema 
{'type': 'object'}
draft_listing
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'.
Nur Lesen Externer Zugriff
Eingabeschema 
{'type': 'object', 'required': ['brand', 'model'], 'properties': {'city': {'type': 'string'}, 'year': {'type': 'number'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}, 'groupset': {'type': 'string'}, 'willShip': {'type': 'boolean'}, 'condition': {'enum': ['Excellent', 'Very_Good', 'Good', 'Fair', 'Poor', 'For_Parts'], 'type': 'string'}, 'frameSize': {'type': 'string'}, 'knownIssues': {'type': 'string', 'description': 'Honest declaration of any issues.'}, 'itemCondition': {'enum': ['new', 'used'], 'type': 'string', 'description': 'Whether the bike is new (never ridden) or used. Defaults to used. A new bike gets no used-market price suggestion.'}}}
Ausgabeschema 
{'type': 'object'}
fetch
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Document id from search results.'}}}
Ausgabeschema 
{'type': 'object', 'required': ['id', 'title', 'text', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object'}}}
find_similar_listings
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'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Source listing URL slug.'}}}
Ausgabeschema 
{'type': 'object', 'required': ['attribution', 'resultsCount', 'listings'], 'properties': {'listings': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'format': 'uri'}, 'city': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'year': {'type': ['number', 'null']}, 'brand': {'type': ['string', 'null']}, 'model': {'type': ['string', 'null']}, 'offer': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'availability': {'type': 'string'}, 'itemCondition': {'type': 'string'}, 'priceCurrency': {'type': 'string'}}, 'description': 'UCP/ACP-shaped commerce signal for this listing.'}, 'title': {'type': 'string'}, 'isEbike': {'type': 'boolean'}, 'delivery': {'type': ['string', 'null']}, 'groupset': {'type': ['string', 'null']}, 'imageUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'priceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'condition': {'type': 'string'}, 'frameSize': {'type': ['string', 'null']}, 'listingId': {'type': ['string', 'null']}, 'wheelSize': {'type': ['string', 'null']}, 'ebikeMotor': {'type': ['string', 'null']}, 'negotiable': {'type': 'boolean'}, 'distanceMiles': {'type': ['number', 'null']}, 'frameMaterial': {'type': ['string', 'null']}, 'ebikeBatteryWh': {'type': ['number', 'null']}}}}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}, 'resultsCount': {'type': 'number'}}}
get_buying_guide
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'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'description': '1-5, default 3.'}, 'query': {'type': 'string', 'description': 'What to search for (e.g. "first road bike", "bike sizing").'}}}
Ausgabeschema 
{'type': 'object'}
get_depreciation
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?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'sort': {'enum': ['best', 'worst'], 'type': 'string'}, 'limit': {'type': 'number', 'description': '1-20, default 10.'}}}
Ausgabeschema 
{'type': 'object'}
get_listing_detail
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Listing URL slug (e.g. "used-trek-domane-sl-6-2022").'}}}
Ausgabeschema 
{'type': 'object'}
get_market_health
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {}}
Ausgabeschema 
{'type': 'object'}
get_market_index
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {}}
Ausgabeschema 
{'type': 'object'}
get_model_info
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'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['brand', 'model'], 'properties': {'brand': {'type': 'string'}, 'model': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
get_my_enquiries
Show buyer enquiries on the authenticated user's Cyclesite listings. Requires OAuth scope `listings:read`. Example: 'any messages about my Trek?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': '1-20.'}, 'listingId': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
get_my_messages
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?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': '1-50.'}, 'threadId': {'type': 'string', 'description': 'Thread id from a prior get_my_messages list or make_enquiry. Omit to list all your threads.'}}}
Ausgabeschema 
{'type': 'object'}
get_price_trends
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'months': {'type': 'number', 'description': '1-24.'}, 'category': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
get_recent_listings
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many listings to return (1-10, default 10).'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'maxPrice': {'type': 'number', 'description': 'Maximum price in GBP.'}}}
Ausgabeschema 
{'type': 'object', 'required': ['attribution', 'resultsCount', 'listings'], 'properties': {'listings': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'format': 'uri'}, 'city': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'year': {'type': ['number', 'null']}, 'brand': {'type': ['string', 'null']}, 'model': {'type': ['string', 'null']}, 'offer': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'availability': {'type': 'string'}, 'itemCondition': {'type': 'string'}, 'priceCurrency': {'type': 'string'}}, 'description': 'UCP/ACP-shaped commerce signal for this listing.'}, 'title': {'type': 'string'}, 'isEbike': {'type': 'boolean'}, 'delivery': {'type': ['string', 'null']}, 'groupset': {'type': ['string', 'null']}, 'imageUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'priceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'condition': {'type': 'string'}, 'frameSize': {'type': ['string', 'null']}, 'listingId': {'type': ['string', 'null']}, 'wheelSize': {'type': ['string', 'null']}, 'ebikeMotor': {'type': ['string', 'null']}, 'negotiable': {'type': 'boolean'}, 'distanceMiles': {'type': ['number', 'null']}, 'frameMaterial': {'type': ['string', 'null']}, 'ebikeBatteryWh': {'type': ['number', 'null']}}}}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}, 'resultsCount': {'type': 'number'}}}
get_size_guide
Frame-size recommendation for a rider's height and bike category, the same chart Cyclesite publishes at /bike-size-calculator (height to inside leg to seat tube), refined by real UK listing data where riders' declared heights are available. Children are sized by wheel diameter instead and the tool says so. Example: 'I'm 178cm — what road-bike size do I need?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['heightCm'], 'properties': {'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'heightCm': {'type': 'number', 'description': 'Rider height in centimetres (120-220).'}}}
Ausgabeschema 
{'type': 'object'}
get_spec_sheet
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?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['brand', 'model'], 'properties': {'year': {'type': 'number'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
get_valuation
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. Pass `year` when the user names one and the answer is resolved against that model year's own measured median and confidence interval, instead of the all-years median. 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?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['brand', 'model'], 'properties': {'year': {'type': 'number', 'description': 'Model year, e.g. 2022. Optional. When given, the response carries a `forYear` block resolving the valuation to that year, or saying in words why it could not be.'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object', 'required': ['attribution', 'summary'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'basis': {'enum': ['uk_listings_asking', 'cyclesite_sold'], 'type': 'string'}, 'forYear': {'type': ['object', 'null'], 'properties': {'hi': {'type': ['number', 'null']}, 'lo': {'type': ['number', 'null']}, 'note': {'type': 'string'}, 'year': {'type': 'number'}, 'available': {'type': 'boolean'}, 'sampleSize': {'type': ['number', 'null']}, 'yearsCovered': {'type': 'array', 'items': {'type': 'number'}}, 'medianPriceGbp': {'type': ['number', 'null']}}}, 'summary': {'type': 'string', 'description': 'One-sentence summary safe to quote verbatim.'}, 'retention': {'type': ['object', 'null'], 'properties': {'after3y': {'type': 'number'}, 'after5y': {'type': 'number'}, 'anchorYear': {'type': 'number'}}}, 'confidence': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'priceTrend': {'enum': ['rising', 'stable', 'falling'], 'type': 'string'}, 'sampleSize': {'type': 'number'}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}, 'maxPriceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'minPriceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'citationUrls': {'type': 'object', 'additionalProperties': {'type': 'string', 'format': 'uri'}}, 'avgDaysToSell': {'type': 'number'}, 'activeListings': {'type': 'number'}, 'medianPriceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'priceByModelYear': {'type': 'array', 'items': {'type': 'object', 'properties': {'n': {'type': 'number'}, 'hi': {'type': 'number'}, 'lo': {'type': 'number'}, 'year': {'type': 'number'}, 'median': {'type': 'number'}}}}, 'conditionBreakdown': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'median': {'type': 'number', 'description': 'Price in GBP.'}}}}}}
grade_listing_quality
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).
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
list_brands
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?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Optional search filter (case-insensitive contains).'}, 'limit': {'type': 'number', 'description': '1-50, default 25.'}, 'offset': {'type': 'number', 'description': '0-500.'}}}
Ausgabeschema 
{'type': 'object', 'properties': {'limit': {'type': 'number'}, 'total': {'type': 'number'}, 'brands': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'country': {'type': ['string', 'null']}, 'verified': {'type': 'boolean'}, 'stockBand': {'enum': ['none', '1-5', '6-25', '26-100', '100+'], 'type': 'string'}}}}, 'offset': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}}}
list_models_for_brand
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").
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['brandSlug'], 'properties': {'limit': {'type': 'number', 'description': '1-50, default 25.'}, 'offset': {'type': 'number', 'description': '0-500.'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'brandSlug': {'type': 'string', 'description': 'Brand slug from list_brands (lowercase, hyphenated).'}}}
Ausgabeschema 
{'type': 'object'}
list_my_listings
Show the authenticated user's Cyclesite listings (draft / active / sold). Requires OAuth scope `listings:read`. Example: 'how are my listings doing?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': '1-20.'}, 'status': {'enum': ['active', 'draft', 'sold', 'all'], 'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
make_enquiry
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'.
Destruktiv Externer Zugriff
Eingabeschema 
{'type': 'object', 'required': ['listingId', 'message'], 'properties': {'message': {'type': 'string', 'description': "The buyer's question to the seller (10-2000 chars)."}, 'listingId': {'type': 'string', 'description': 'Bike ID from search_bikes / get_listing_detail.'}}}
Ausgabeschema 
{'type': 'object'}
mark_as_sold
Mark a Cyclesite listing as sold, optionally with the final sale price, where it sold and the date it sold. Requires OAuth scope `listings:manage`. Example: 'mark my Trek Domane as sold for £1,750 on Facebook last Saturday'.
Destruktiv Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['listingId'], 'properties': {'soldOn': {'type': 'string', 'description': 'The day it sold, YYYY-MM-DD. Leave out for today. Ignored if in the future or before the listing went up.'}, 'listingId': {'type': 'string'}, 'saleVenue': {'enum': ['cyclesite', 'facebook', 'ebay', 'gumtree', 'elsewhere'], 'type': 'string', 'description': 'Where the sale was agreed.'}, 'salePriceGbp': {'type': 'number', 'description': 'What it actually sold for. Leave out if the seller did not say.'}}}
Ausgabeschema 
{'type': 'object'}
publish_listing
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' (listing is free, no payment needed) or step:'payment_required' with a Stripe Checkout URL. 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.
Destruktiv Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'UK city.'}, 'year': {'type': 'number'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}, 'title': {'type': 'string', 'description': 'Listing title (10-160 chars).'}, 'draftId': {'type': 'string', 'description': 'Returned by a previous call. Omit on first call.'}, 'isEbike': {'type': 'boolean', 'description': 'True for an electric bike.'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'groupset': {'type': 'string'}, 'priceGbp': {'type': 'number'}, 'willShip': {'type': 'boolean'}, 'condition': {'enum': ['Excellent', 'Very_Good', 'Good', 'Fair', 'Poor', 'For_Parts'], 'type': 'string'}, 'frameSize': {'type': 'string'}, 'motorBrand': {'type': 'string', 'description': 'E-bike motor make, e.g. "Bosch", "Shimano", "Bafang".'}, 'motorModel': {'type': 'string', 'description': 'E-bike motor model, e.g. "Performance Line CX".'}, 'description': {'type': 'string', 'description': 'Listing description (30-5000 chars).'}, 'frameSerial': {'type': 'string', 'description': 'Frame/serial number â\x80\x94 runs a stolen-bike check before publish.'}, 'knownIssues': {'type': 'string'}, 'batteryCycles': {'type': 'number', 'description': 'Charge cycles as the seller reports them.'}, 'itemCondition': {'enum': ['new', 'used'], 'type': 'string', 'description': 'Whether the bike is new (never ridden) or used. Defaults to used.'}, 'motorPosition': {'enum': ['Mid-drive', 'Rear hub', 'Front hub'], 'type': 'string'}, 'ebikeBatteryWh': {'type': 'number', 'description': 'Battery capacity in watt-hours (100-3000).'}, 'rangeEstimateMiles': {'type': 'number', 'description': 'Range the seller claims on one charge, in miles.'}, 'batteryHealthPercent': {'type': 'number', 'description': 'Battery health as the seller reports it, 0-100.'}}}
Ausgabeschema 
{'type': 'object', 'required': ['step', 'message'], 'properties': {'step': {'enum': ['photos_required', 'payment_required', 'live'], 'type': 'string'}, 'draftId': {'type': 'string', 'format': 'uuid'}, 'message': {'type': 'string'}, 'listingUrl': {'type': 'string', 'format': 'uri'}, 'paymentUrl': {'type': 'string', 'format': 'uri'}, 'photosNeeded': {'type': 'number'}, 'listingFeeGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'photoUploadUrl': {'type': 'string', 'format': 'uri'}}}
recommend_bike_for_budget
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'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['budgetGbp'], 'properties': {'city': {'type': 'string', 'description': 'UK city to focus on (optional).'}, 'limit': {'type': 'number', 'description': '1-10, default 5.'}, 'useCase': {'type': 'string', 'description': 'Free-text intent (e.g. "commuting", "weekend trail", "first road bike").'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'budgetGbp': {'type': 'number', 'description': 'Maximum budget in GBP.'}}}
Ausgabeschema 
{'type': 'object'}
report_stolen
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?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'brand': {'type': 'string'}, 'model': {'type': 'string'}, 'serial': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
reserve_listing
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'.
Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['listingId'], 'properties': {'listingId': {'type': 'string'}, 'depositGbp': {'type': 'number', 'description': 'COMING SOON â\x80\x94 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.'}}}
Ausgabeschema 
{'type': 'object'}
respond_to_enquiry
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'.
Destruktiv Externer Zugriff
Eingabeschema 
{'type': 'object', 'required': ['enquiryId', 'answer'], 'properties': {'answer': {'type': 'string', 'description': 'Reply text (1-2000 chars).'}, 'enquiryId': {'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
save_search
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.
Externer Zugriff
Eingabeschema 
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'UK city to focus on.'}, 'name': {'type': 'string', 'description': 'Optional human-readable name (e.g. "Trek Domane in Manchester").'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'maxPrice': {'type': 'number'}, 'minPrice': {'type': 'number'}, 'condition': {'enum': ['Excellent', 'Very_Good', 'Good', 'Fair', 'Poor', 'For_Parts'], 'type': 'string'}, 'alertFrequency': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': 'How often to send digest. Default: instant.'}}}
Ausgabeschema 
{'type': 'object'}
search
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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Free-text query.'}}}
Ausgabeschema 
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'title': {'type': 'string'}}}}}}
search_bikes
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'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'UK city.'}, 'brand': {'type': 'string', 'description': 'Bike brand (e.g. Trek, Specialized, Canyon).'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string', 'description': 'Bike category.'}, 'maxPrice': {'type': 'number', 'description': 'Maximum price in GBP.'}, 'minPrice': {'type': 'number', 'description': 'Minimum price in GBP.'}, 'condition': {'enum': ['Excellent', 'Very_Good', 'Good', 'Fair', 'Poor', 'For_Parts'], 'type': 'string', 'description': 'Condition rating.'}}}
Ausgabeschema 
{'type': 'object', 'required': ['attribution', 'resultsCount', 'listings'], 'properties': {'listings': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'format': 'uri'}, 'city': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'year': {'type': ['number', 'null']}, 'brand': {'type': ['string', 'null']}, 'model': {'type': ['string', 'null']}, 'offer': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'availability': {'type': 'string'}, 'itemCondition': {'type': 'string'}, 'priceCurrency': {'type': 'string'}}, 'description': 'UCP/ACP-shaped commerce signal for this listing.'}, 'title': {'type': 'string'}, 'isEbike': {'type': 'boolean'}, 'delivery': {'type': ['string', 'null']}, 'groupset': {'type': ['string', 'null']}, 'imageUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'priceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'condition': {'type': 'string'}, 'frameSize': {'type': ['string', 'null']}, 'listingId': {'type': ['string', 'null']}, 'wheelSize': {'type': ['string', 'null']}, 'ebikeMotor': {'type': ['string', 'null']}, 'negotiable': {'type': 'boolean'}, 'distanceMiles': {'type': ['number', 'null']}, 'frameMaterial': {'type': ['string', 'null']}, 'ebikeBatteryWh': {'type': ['number', 'null']}}}}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}, 'resultsCount': {'type': 'number'}}}
search_by_location
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).
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude (UK only, 49.5â\x80\x9361.0).'}, 'lng': {'type': 'number', 'description': 'Longitude (UK only, -8.5â\x80\x932.0).'}, 'limit': {'type': 'number', 'description': '1-10, default 5.'}, 'category': {'enum': ['road', 'mtb', 'gravel', 'hybrid', 'ebike', 'kids', 'bmx', 'folding', 'city', 'touring', 'triathlon', 'track', 'cyclocross', 'cargo', 'adaptive', 'other'], 'type': 'string'}, 'maxPrice': {'type': 'number'}, 'radiusMiles': {'type': 'number', 'description': 'Search radius in miles (1-50, default 25).'}}}
Ausgabeschema 
{'type': 'object', 'required': ['attribution', 'resultsCount', 'listings'], 'properties': {'listings': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'format': 'uri'}, 'city': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'year': {'type': ['number', 'null']}, 'brand': {'type': ['string', 'null']}, 'model': {'type': ['string', 'null']}, 'offer': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'availability': {'type': 'string'}, 'itemCondition': {'type': 'string'}, 'priceCurrency': {'type': 'string'}}, 'description': 'UCP/ACP-shaped commerce signal for this listing.'}, 'title': {'type': 'string'}, 'isEbike': {'type': 'boolean'}, 'delivery': {'type': ['string', 'null']}, 'groupset': {'type': ['string', 'null']}, 'imageUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'priceGbp': {'type': 'number', 'description': 'Price in GBP.'}, 'condition': {'type': 'string'}, 'frameSize': {'type': ['string', 'null']}, 'listingId': {'type': ['string', 'null']}, 'wheelSize': {'type': ['string', 'null']}, 'ebikeMotor': {'type': ['string', 'null']}, 'negotiable': {'type': 'boolean'}, 'distanceMiles': {'type': ['number', 'null']}, 'frameMaterial': {'type': ['string', 'null']}, 'ebikeBatteryWh': {'type': ['number', 'null']}}}}, 'attribution': {'type': 'string', 'description': 'Citation string â\x80\x94 include verbatim when surfacing data.'}, 'resultsCount': {'type': 'number'}}}
suggest_listing_price
For a seller about to list: suggested ask, floor, and ceiling for their bike's brand+model[+year][+condition] on the UK market. Same measured UK used-price data as get_valuation but framed as seller guidance. Pass `year` when the seller names one — the ask is then anchored on that model year's own median rather than the all-years median. Example: 'I'm selling a 2021 Specialized Allez in good condition — what should I ask?'.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema 
{'type': 'object', 'required': ['brand', 'model'], 'properties': {'year': {'type': 'number', 'description': 'Model year, e.g. 2021. Optional. Anchors the ask on that year when the curve covers it; `basis` in the response always names what the ask was actually derived from.'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}, 'condition': {'enum': ['Excellent', 'Very_Good', 'Good', 'Fair', 'Poor', 'For_Parts'], 'type': 'string'}}}
Ausgabeschema 
{'type': 'object'}
Verlauf

Letzte Tool-Änderungen

Geändert
publish_listing
23. September 2026 02:50
Geändert
search_by_location
23. September 2026 02:50
Geändert
find_similar_listings
23. September 2026 02:50
Geändert
get_recent_listings
23. September 2026 02:50
Geändert
search_bikes
23. September 2026 02:50
Hinzugefügt
reserve_listing
17. September 2026 12:52
Hinzugefügt
make_enquiry
17. September 2026 12:52
Hinzugefügt
save_search
17. September 2026 12:52
Hinzugefügt
fetch
17. September 2026 12:52
Hinzugefügt
search
17. September 2026 12:52
Hinzugefügt
respond_to_enquiry
17. September 2026 12:52
Hinzugefügt
get_my_messages
17. September 2026 12:52
Hinzugefügt
get_my_enquiries
17. September 2026 12:52
Hinzugefügt
mark_as_sold
17. September 2026 12:52
Hinzugefügt
list_my_listings
17. September 2026 12:52
Hinzugefügt
publish_listing
17. September 2026 12:52
Hinzugefügt
get_buying_guide
17. September 2026 12:52
Hinzugefügt
report_stolen
17. September 2026 12:52
Hinzugefügt
check_stolen
17. September 2026 12:52
Hinzugefügt
draft_listing
17. September 2026 12:52
Hinzugefügt
grade_listing_quality
17. September 2026 12:52
Hinzugefügt
get_price_trends
17. September 2026 12:52
Hinzugefügt
get_depreciation
17. September 2026 12:52
Hinzugefügt
get_market_health
17. September 2026 12:52
Hinzugefügt
get_market_index
17. September 2026 12:52
Hinzugefügt
suggest_listing_price
17. September 2026 12:52
Hinzugefügt
get_valuation
17. September 2026 12:52
Hinzugefügt
get_size_guide
17. September 2026 12:52
Hinzugefügt
compare_bikes
17. September 2026 12:52
Hinzugefügt
get_spec_sheet
17. September 2026 12:52
Entdecken

Ähnliche MCP-Server

API Direct

io.apidirect/api-direct

Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…

Bonanza

io.github.pipeworx-io/bonanza

Searches active Bonanza marketplace listings and retrieves individual item details.

MONO Social

io.github.junoventures/mono-juno-ventures

Provides directory search for local places, events, listings, services, offers, bookings, reservations, tickets, and products.

Campo Belo

io.github.junoventures/campobelo-sampa-br

Provides Campo Belo local discovery for places, events, menus, offers, services, bookings, reservations, tickets, and purchases.

Bom Retiro

io.github.junoventures/bomretiro-sampa-br

Provides Bom Retiro local place, event, menu, offer, service, booking, reservation, ticketing, and checkout capabilities.

Bogeyland

io.github.junoventures/bogeyland-golf

Provides directory search for places, events, services, offers, bookings, reservations, tickets, menus, and purchases.

Genesis Social

io.github.junoventures/genesis-social

Provides directory search and transactions for local places, events, restaurants, services, offers, bookings, and tickets.

Filipe Coffee

io.github.junoventures/filipe-coffee

Provides local directory search for places, events, menus, offers, services, bookings, reservations, tickets, and checkout.