Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Cyclesite MCP Server
Overview
Description from the maker (original English)
Search, value, sell, and trust-check used bikes on Cyclesite, the UK's used-bicycle marketplace.
PopNx MCP’s three pillars
These three are never merged into one score: opinions, measurements and popularity are different things.
- User voiceiNo reviews yetReviews open together with accounts in a later step
- Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
- UsageiNot measured yet★ –
What you can do with it
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
- Connection: Computer or cloud
- Transport: stdio, Streamable HTTP
- Category: Online shops & payments
- You need to fill in: CYCLESITE_API_KEY
Install
Pick the AI app you use, then copy the settings.
Before you install
- Basic checks: 3 of 3 passed
- Runs on the maker’s server: what you ask it goes through their server.
- Can do 34 things (tools) search_bikes, get_recent_listings, get_listing_detail, find_similar_listings …
- You fill in yourself:
CYCLESITE_API_URL,CYCLESITE_API_KEY
Values marked secret are keys to your account. Never share them or paste them into a chat.
You need
- Runs in the cloudNothing to install; it connects over the internet
- npmNode.js installed (for the npx command)
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
- Open Settings → Connectors
- Press Add custom connector
- Paste the address below and press Add
- If it asks you to sign in, sign in with the maker
https://www.cyclesite.co.uk/api/mcp-serverOr run it on your computer
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"cyclesite": {
"command": "npx",
"args": [
"-y",
"cyclesite-mcp-server"
],
"env": {
"CYCLESITE_API_URL": "your-value",
"CYCLESITE_API_KEY": "your-value"
}
}
}
}Run this in your terminal
claude mcp add --transport http cyclesite https://www.cyclesite.co.uk/api/mcp-serverOr run it on your computer
claude mcp add cyclesite --env CYCLESITE_API_URL=your-value --env CYCLESITE_API_KEY=your-value -- npx -y cyclesite-mcp-serverFill in the empty values before running it.
Or copy the settings yourself
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"cyclesite": {
"url": "https://www.cyclesite.co.uk/api/mcp-server"
}
}
}Or run it on your computer
Or copy the settings yourself
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"cyclesite": {
"command": "npx",
"args": [
"-y",
"cyclesite-mcp-server"
],
"env": {
"CYCLESITE_API_URL": "your-value",
"CYCLESITE_API_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Or copy the settings yourself
Paste into .vscode/mcp.json in your project
{
"servers": {
"cyclesite": {
"type": "http",
"url": "https://www.cyclesite.co.uk/api/mcp-server"
}
}
}Or run it on your computer
Or copy the settings yourself
Paste into .vscode/mcp.json in your project
{
"servers": {
"cyclesite": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cyclesite-mcp-server"
],
"env": {
"CYCLESITE_API_URL": "your-value",
"CYCLESITE_API_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
- Open ChatGPT on the web → Settings → Connectors (Apps)
- Press Create or Add (some plans need Developer mode under Advanced first)
- Paste the address below, give it a name and save
- If it asks you to sign in, sign in with the maker
https://www.cyclesite.co.uk/api/mcp-serverMenu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
Values you fill in
CYCLESITE_API_URLenvCyclesite base URL. Override only for partner staging environments.- Optional partner API key for raised rate limits. Public tier works without one.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
What it can do
Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.
search_bikesSearch 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 querie
get_recent_listingsWhat'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.
get_listing_detailFull details for a specific bike listing on Cyclesite: specs, condition, frame number presence, photos, delivery, seller's city. Takes the URL slug from a listing result. Example: 'tell me more about that 2022 Trek Domane'. The marketplace is not the seller: contact goes through
find_similar_listingsGiven 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'.
search_by_locationFind 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, round
recommend_bike_for_budgetCurated 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
list_brandsPaginated 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.
list_models_for_brandModels 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").
get_model_infoCyclesite 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'.
get_spec_sheetAggregated 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 End
compare_bikesSide-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'.
get_size_guideFrame-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 in
get_valuationWhat 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 confide
suggest_listing_priceFor 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
get_market_indexCurrent 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_healthBuyer'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_depreciationBrands 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?'.
get_price_trendsUK 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.
grade_listing_qualityCategorical 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
draft_listingSell-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
check_stolenCheck 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 bik
report_stolenStep-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?'.
get_buying_guideSearch 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?', 'tip
publish_listingPublish a Cyclesite listing on the user's behalf. Multi-step: the first call (no draftId) returns step:'photos_required' with a phone-friendly photo upload URL for the seller. Once 3+ photos are uploaded, a call with the same draftId returns either step:'live' (listing is free, n
list_my_listingsShow the authenticated user's Cyclesite listings (draft / active / sold). Requires OAuth scope `listings:read`. Example: 'how are my listings doing?'.
mark_as_soldMark 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'.
get_my_enquiriesShow 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
get_my_messagesRead 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
respond_to_enquirySend 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
searchOpenAI 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.
fetchOpenAI 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 answe
save_searchSubscribe 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
make_enquirySend 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 na
reserve_listingHold 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 OAut
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account Tomalarrrr, which owns the repo
- … Not checked yet
Still maintained
We have not read this repo from GitHub yet
- … Not checked yet
Has a licence
We have not read this repo from GitHub yet
- ✓ Pass
Endpoint responds
Responded in 1158 ms (HTTP 200)
- – Not applicable
Sign-in with OAuth
No sign-in needed
- ✓ Pass
No hidden instructions in tool descriptions
Read 34 tool descriptions and found no hidden instructions to the AI
Compared with others in Online shops & paymentsi
- More stars than 0% of the other 2534 servers in this category
- Published to the registry more recently than 75% of the other 2534 servers in this category
- Basic checks equal to or better than 100% of the other 2534 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Cyclesite MCP Server safe?
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
You need to fill in: CYCLESITE_API_KEY
Does it run on my computer or in the cloud?
Either way works: install it on your computer or connect to the cloud version.
Is it still maintained?
The GitHub repo last changed –, and the latest version (2.4.4) reached the registry 11 days ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
What can I use instead?
In the same category: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternatives
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Stripe MCP
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README from the maker
No README found in the repo