cyclesite-mcp-server

MCP server for Cyclesite — the UK's used bicycle marketplace.

Lets AI agents search bikes for sale, get valuations, and check market trends using real marketplace data.

Quick Start

npx cyclesite-mcp-server

Tools

| Tool | Description | | -------------------- | ------------------------------------------------------------------------------ | | search_bikes | Search used bikes for sale — full specs, images, delivery options | | get_listing_detail | Full listing details — specs, condition, seller, delivery, engagement | | get_model_info | Bike model encyclopedia — specs, year range, availability, pricing | | get_buying_guide | Expert buying guides — 24 guides covering every bike type and cycling topic | | get_valuation | Bike valuation with condition breakdown, confidence, trend, and comparables | | get_market_index | UK bike market snapshot — median prices, transaction counts by category | | get_market_health | Market temperature per category — is it a good time to buy/sell? | | get_depreciation | Which bikes hold value best (or worst) — 1yr, 3yr, 5yr depreciation | | get_price_trends | Monthly price trends over time — filter by category, 1-24 months | | check_stolen | Check if a bike is reported stolen (serial number required) | | report_stolen | Step-by-step instructions for reporting a stolen bike in the UK |

Resources

| Resource | Description | | ---------------------------------- | --------------------------------------------------- | | cyclesite://marketplace-overview | Machine-readable marketplace capabilities and stats | | cyclesite://selling-guide | How to sell a bike on Cyclesite | | cyclesite://buying-guides | 24 expert cycling guides (buying, maintenance, etc) | | cyclesite://bike-categories | All 12 bike categories with descriptions | | cyclesite://brands | Bike brands with live listing counts |

Configuration

| Env Var | Default | Description | | ------------------- | ----------------------------- | --------------------------------------- | | CYCLESITE_API_URL | https://www.cyclesite.co.uk | API base URL | | CYCLESITE_API_KEY | (none) | Optional API key for higher rate limits |

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cyclesite": {
      "command": "npx",
      "args": ["-y", "cyclesite-mcp-server"]
    }
  }
}

Claude Code

Add to your project:

claude mcp add cyclesite -- npx -y cyclesite-mcp-server

Example Prompts

• "Find me a mountain bike under 500 in Manchester"
• "What's a Canyon Endurace CF SL worth?"
• "Is this bike stolen? Serial: WTU123456"
• "My bike was stolen, what do I do?"
• "Is it a good time to sell a road bike?"
• "How have road bike prices changed this year?"
• "Which bike brands hold their value best?"
• "Show me the current UK bike market prices"

Programmatic Usage

import { createServer } from "cyclesite-mcp-server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = createServer("https://www.cyclesite.co.uk");
await server.connect(new StdioServerTransport());

Rate Limits

The MCP API is rate-limited to 20 requests per minute per IP. Tool responses are cached for 1 hour. For higher limits, contact us for an API key.

Data Attribution

All data is from Cyclesite (cyclesite.co.uk) and licensed under CC BY-NC-SA 4.0 for market data endpoints.

License

MIT