{"id":"io.github.Tomalarrrr/cyclesite-mcp-server","slug":"io-github-tomalarrrr-cyclesite-mcp-server","title":"Cyclesite: UK used-bike marketplace","description":"Search, value, sell, and trust-check used bikes on Cyclesite, the UK's used-bicycle marketplace.","version":"2.4.4","publisher":{"kind":"github","id":"Tomalarrrr","label":"@Tomalarrrr on GitHub","url":"https://github.com/Tomalarrrr"},"website":"https://www.cyclesite.co.uk","repository":"https://github.com/Tomalarrrr/the-sites","remotes":[{"type":"streamable-http","url":"https://www.cyclesite.co.uk/api/mcp-server"}],"packages":[{"registryType":"npm","identifier":"cyclesite-mcp-server","version":"2.4.4","transport":{"type":"stdio"},"environmentVariables":[{"description":"Cyclesite base URL. Override only for partner staging environments.","format":"string","default":"https://www.cyclesite.co.uk","name":"CYCLESITE_API_URL"},{"description":"Optional partner API key for raised rate limits. Public tier works without one.","format":"string","isSecret":true,"name":"CYCLESITE_API_KEY"}]}],"published":"2026-10-27","updated":"2026-10-27","status":"online","auth":"","latency_ms":1724,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_bikes","title":"Search bikes for sale","description":"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'.","read_only":true},{"name":"get_recent_listings","title":"Browse recent listings","description":"What's new on Cyclesite right now: up to 10 of the freshest active UK listings, refreshed every 15 minutes. Suited to questions like 'what's new today?' or 'any new road bikes this week?' rather than a specific filter. Optional category + maxPrice filters. Live data.","read_only":true},{"name":"get_listing_detail","title":"Get listing detail","description":"Full details for a specific bike listing on Cyclesite: specs, condition, frame number presence, photos, delivery, seller's city. Takes the URL slug and the listingId from a listing result. Example: 'tell me more about that 2022 Trek Domane'. The marketplace is not the seller: contact goes through the route in `howToContactSeller`, delivery terms are only what `delivery.summary` states, and no sell","read_only":true},{"name":"find_similar_listings","title":"Find similar listings","description":"Given a Cyclesite listing slug, return up to 5 similar active listings (same category, ±25% price, same brand or frame size weighted higher), as alternatives to one bike. Example: 'show me bikes like that one'.","read_only":true},{"name":"search_by_location","title":"Search by location","description":"Find Cyclesite listings within a radius of a UK town, city or postcode district (the first half of a postcode, e.g. 'BS1', 'M20'). A full postcode is cut to its district; coordinates are not accepted. Radius capped at 50 miles. Returns up to 10 listings ordered by distance, rounded to the mile, and `searchedFrom` naming the place measured from. Live UK marketplace data. Example: 'used bikes within","read_only":true},{"name":"recommend_bike_for_budget","title":"Recommend bikes for budget","description":"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'.","read_only":true},{"name":"list_brands","title":"List brands","description":"Paginated UK bike-brand catalogue from Cyclesite, ordered by stock level, for checking a brand name, listing the options or paging through 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?'.","read_only":true},{"name":"list_models_for_brand","title":"List models for brand","description":"Models for a brand on Cyclesite (paginated). Returns model names, year ranges, in-stock flag. Example: \"what Trek road bikes are available?\" (brandSlug \"trek\", category \"road\").","read_only":true},{"name":"get_model_info","title":"Get model info","description":"Cyclesite catalogue entry for a brand+model: category, year range, model description, key specs, market summary. Reference data — refreshed when models are added or specs change. Example: 'tell me about the Specialized Allez'.","read_only":true},{"name":"get_spec_sheet","title":"Get spec sheet","description":"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?'.","read_only":true},{"name":"compare_bikes","title":"Compare bikes","description":"Side-by-side comparison of up to 3 bikes (each by brand+model[+year]). Returns spec sheets and valuations together, from the same measured UK data as the single-bike spec sheets and valuations. Example: 'compare a Trek Domane SL 6 against a Specialized Roubaix Comp'.","read_only":true},{"name":"get_size_guide","title":"Get size guide","description":"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?'.","read_only":true},{"name":"get_valuation","title":"Get valuation","description":"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. When `year` is given, 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 sold prices, refreshed nightly. Example: 'what's a 2","read_only":true},{"name":"suggest_listing_price","title":"Suggest listing price","description":"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 the valuations, framed as seller guidance. When `year` is given, the ask is 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?'","read_only":true},{"name":"get_market_index","title":"Get market index","description":"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.","read_only":true},{"name":"get_market_health","title":"Get market health","description":"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.","read_only":true},{"name":"get_depreciation","title":"Get depreciation leaders","description":"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?'.","read_only":true},{"name":"get_price_trends","title":"Get price trends","description":"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.","read_only":true},{"name":"grade_listing_quality","title":"Grade listing quality","description":"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).","read_only":true},{"name":"draft_listing","title":"Draft a listing","description":"Sell-side helper: turn a seller's raw facts into a polished Cyclesite listing draft (title, description, suggested price, photo plan). Does not publish anything: publishing needs a signed-in account (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'.","read_only":true},{"name":"check_stolen","title":"Check a frame number","description":"Check whether a UK bike's frame (serial) number matches a theft report held by Cyclesite. Live data, checked on every call. Rate-limited per serial number (3 an hour) to prevent enumeration. Example: 'does frame number WTU123456 match a theft report?'. Someone who has found a bike, rather than bought one, can check the frame number and leave the owner a message at https://www.cyclesite.co.uk/stole","read_only":false},{"name":"report_stolen","title":"How to report a stolen bike","description":"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?'.","read_only":true},{"name":"get_buying_guide","title":"Get buying guide","description":"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. Covers educational questions that don't need live inventory. Example: 'how do I choose a bike size?', 'tips for buying a used e-bike'.","read_only":true},{"name":"publish_listing","title":"Publish a listing","description":"Publish a Cyclesite listing on the user's behalf. Multi-step: the first call (no draftId) saves a draft and returns step:'photos_required' with a phone-friendly link. On that page the seller, signed in to their account, adds 3+ photos, reads the whole advert and taps Approve; only the seller can approve, and the assistant cannot do it for them. A call with the same draftId then returns step:'live'","read_only":false},{"name":"list_my_listings","title":"My listings","description":"Show the authenticated user's Cyclesite listings (draft / active / sold). Requires OAuth scope `listings:read`. Example: 'how are my listings doing?'.","read_only":true},{"name":"mark_as_sold","title":"Mark sold","description":"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'.","read_only":false},{"name":"get_my_enquiries","title":"My enquiries","description":"Show the messages buyers have sent about the authenticated user's Cyclesite listings, newest first. Each enquiry is one buyer's conversation: its id, the listing, the buyer's latest message, the unread count and whether the seller has replied. The seller can answer an enquiry by its id. Requires OAuth scope `listings:read`. Example: 'any messages about my Trek?'.","read_only":true},{"name":"get_my_messages","title":"My messages","description":"Read the buyer's own Cyclesite message threads and any seller replies. With no arguments it lists the buyer's conversations; with a threadId it returns that thread's messages. Enquiries the buyer has sent to sellers appear here. Requires OAuth scope `listings:read`. Example: 'did the seller of that Trek reply yet?'.","read_only":true},{"name":"respond_to_enquiry","title":"Reply to enquiry","description":"Send the seller's reply to a buyer who messaged about one of the authenticated user's listings. Takes the id of one of the seller's enquiries. The buyer is notified, and the message tells them an AI assistant sent it on the seller's behalf. Requires OAuth scope `enquiries:respond`. Example: 'reply to my latest enquiry saying it's still available, collection only'.","read_only":false},{"name":"search","title":"Search (OpenAI deep-research)","description":"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 }] }. Each result id is a listing id.","read_only":true},{"name":"fetch","title":"Fetch (OpenAI deep-research)","description":"OpenAI deep-research / company-knowledge compatibility. Fetch the full document for one Cyclesite listing id. Returns { id, title, text, url, metadata }, where text is a plain-prose summary of the listing's description and specs, suitable for direct quoting in deep-research answers.","read_only":true},{"name":"save_search","title":"Save a search alert","description":"Subscribe the user to email alerts for Cyclesite listings matching a filter. We email them when a matching bike is listed or drops in price, instantly or in a daily digest, depending on their email preferences. 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","read_only":false},{"name":"make_enquiry","title":"Send a buyer enquiry","description":"Send an enquiry to a Cyclesite seller on the buyer's behalf. It's saved to the buyer's Cyclesite inbox, where the seller's reply also arrives, and the seller is notified. Per-buyer-per-listing daily cap (2/day) prevents spam. Requires OAuth scope `enquiries:respond` (the scope name is shared with seller-side replies). Example: 'message the seller of that Trek and ask whether it has had a service t","read_only":false},{"name":"reserve_listing","title":"Reserve listing (24h hold)","description":"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. We never take a deposit or any payment for a bike; the buyer and seller arrange payment between them. Requires OAuth scope `listings:manage`. Example: 'put a hold on that Trek for me, I want to view it Saturday'.","read_only":false}],"server_info":{"name":"cyclesite","version":"2.4.4","title":"Cyclesite: UK used-bike marketplace","websiteUrl":"https://www.cyclesite.co.uk","description":"Live UK inventory search, market-price valuation from real UK market data, stolen-bike check against an international registry and rider-filed theft reports, brand/model catalogue, plus full write-side OAuth flow: publish a listing, mark sold, reply to enquiries, save price alerts, send buyer enquiries, reserve a listing for 24 hours.","icons":[{"src":"https://www.cyclesite.co.uk/logo-square.png","mimeType":"image/png","sizes":["512x512"]}]},"category":"web-search","tags":["agents","analytics","communication"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-05-07","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-tomalarrrr-cyclesite-mcp-server/"}