com.bikefuchs/bikefuchs MCP Server

The com.bikefuchs/bikefuchs MCP server is described as a price comparison and cart optimizer for bike parts across German and Austrian shops. The provided material indicates this is not the real Bikefuchs MCP server; it is a namespace-defense placeholder that reserves @bikefuchs on Smithery.

🛠️ Key Features

Provides a single informational tool: get_info
Returns a text message covering launch status, planned tool list, and a link to https://bikefuchs.de
Exposes one tool only (toolCount: 7 is mentioned in source data, but only get_info is documented)

🚀 Use Cases

Retrieve Bikefuchs launch/status information via get_info
Track when the production server will become available

⚡ Developer Benefits

Supports tooling integration discovery through get_info output (status, tool names, link)

⚠️ Limitations

Placeholder only; does not provide comparison/cart optimization capabilities yet
Real server launch timing is stated but not operational now

{ "type": "object", "properties": { "q": { "type": "string", "minLength": 2, "description": "Search keyword, min 2 chars. Multi-word queries use AND logic across product name, description, and specifications (e.g. 'shimano xt bremsbeläge')" }, "country": { "default": "DE", "description": "Country for pricing (DE or AT, default DE)", "type": "string", "enum": [ "DE", "AT" ] }, "in_stock": { "default": true, "description": "Only return in-stock products (default true)", "type": "boolean" }, "max_results": { "default": 10, "description": "Max results (1–20, default 10)", "type": "integer", "minimum": 1, "maximum": 20 }, "shop": { "description": "Restrict results to a single supported shop (by id or name)", "type": "string" }, "max_price": { "description": "Upper price bound in EUR (inclusive)", "type": "number", "exclusiveMinimum": 0 }, "category": { "description": "Filter by merchant category (partial match, e.g. 'Fahrräder' or 'Bremsen')", "type": "string" } }, "required": [ "q" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "ean": { "type": "string", "pattern": "^\\d{8,14}$", "description": "EAN barcode (8–14 digits, e.g. '4524667749493')" }, "country": { "default": "DE", "description": "Country for pricing (DE or AT, default DE)", "type": "string", "enum": [ "DE", "AT" ] }, "reference_shop": { "description": "Shop id or display name to compare against. When set, the response states how much cheaper the cheapest shop is vs. this shop.", "type": "string" } }, "required": [ "ean" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "eans": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "pattern": "^\\d{8,14}$" }, "description": "Array of EAN barcodes (8–14 digit numbers as strings, e.g. '4524667749493'). NOT URLs." }, "country": { "default": "DE", "description": "Country for pricing and shipping (DE or AT, default DE)", "type": "string", "enum": [ "DE", "AT" ] } }, "required": [ "eans" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "country": { "description": "Filter output to a specific country (optional — omit for both DE and AT)", "type": "string", "enum": [ "DE", "AT" ] } }, "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "shop": { "type": "string", "description": "Shop name or ID (e.g. 'rosebikes', 'boc24', 'bike24', 'fahrradteile', 'Rose Bikes')" }, "country": { "type": "string", "enum": [ "DE", "AT" ], "description": "Country (DE or AT)" }, "cart_value": { "type": "number", "minimum": 0, "description": "Total cart value in EUR (e.g. 49.99)" } }, "required": [ "shop", "country", "cart_value" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "ean": { "type": "string", "pattern": "^\\d{8,14}$", "description": "EAN barcode (8–14 digits, e.g. '4524667749493')" }, "country": { "default": "DE", "description": "Country for pricing (DE or AT, default DE)", "type": "string", "enum": [ "DE", "AT" ] } }, "required": [ "ean" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "url": { "type": "string", "format": "uri", "description": "Product page URL from a supported shop (e.g. 'https://www.bike24.de/p2462871.html')" }, "country": { "default": "DE", "description": "Country for pricing (DE or AT, default DE)", "type": "string", "enum": [ "DE", "AT" ] } }, "required": [ "url" ], "$schema": "http://json-schema.org/draft-07/schema#" }

Connect remotely (Claude Desktop)

The canonical entry point is the Vercel deployment. Use mcp-remote to proxy it into Claude Desktop:

json

{
  "mcpServers": {
    "bikefuchs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.bikefuchs.com/mcp"
      ]
    }
  }
}

Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json).

Initial deployment checklist

Follow this order exactly. Smithery verifies the live URL during publishing — publishing before DNS is configured will fail.

Push to GitHub

code

git remote add origin https://github.com/bikefuchs/bikefuchs-mcp-stub.git
git push -u origin main

Import into Vercel Log into Vercel with an account that has access to the bikefuchs GitHub org (not a personal account). Import bikefuchs/bikefuchs-mcp-stub. Default Next.js settings are correct — no env vars required.

Deploy on Vercel Trigger the first deploy. Confirm the build succeeds and the default .vercel.app URL returns a valid MCP response.

Add custom domain in Vercel In the Vercel project → Settings → Domains, add mcp.bikefuchs.com.

Configure DNS in Strato Under bikefuchs.com, create a subdomain mcp and set a CNAME record pointing to the value Vercel provides (typically cname.vercel-dns.com). Allow up to 30 minutes for propagation.

Verify the live endpoint

code

curl -i https://mcp.bikefuchs.com/mcp

Expected: HTTP 2xx or 4xx with a valid MCP response body — not a 404 or connection refused.

Publish on Smithery ← do this last Log into smithery.ai using the bikefuchs GitHub org. Submit the repo URL https://github.com/bikefuchs/bikefuchs-mcp-stub. Set the namespace to @bikefuchs in the Smithery dashboard.

Install

Tools (7)

search_productget_best_priceoptimize_cartget_shop_infoget_shipping_breakdownfind_alternatives_for_productresolve_product

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.bikefuchs.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bikefuchs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bikefuchs.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Bikefuchs — Bike Parts Price Comparison

com.bikefuchs/bikefuchs MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_product

get_best_price

optimize_cart

get_shop_info

get_shipping_breakdown

find_alternatives_for_product

resolve_product

bikefuchs-mcp-stub

What this exposes

When the real server launches

Connect remotely (Claude Desktop)

Initial deployment checklist

Links

Install

Remote endpoint

Related servers

q	string	required	Search keyword, min 2 chars. Multi-word queries use AND logic across product name, description, and specifications (e.g. 'shimano xt bremsbeläge')
country	string	optional	Country for pricing (DE or AT, default DE)
in_stock	boolean	optional	Only return in-stock products (default true)
max_results	integer	optional	Max results (1–20, default 10)
shop	string	optional	Restrict results to a single supported shop (by id or name)
max_price	number	optional	Upper price bound in EUR (inclusive)
category	string	optional	Filter by merchant category (partial match, e.g. 'Fahrräder' or 'Bremsen')

ean	string	required	EAN barcode (8–14 digits, e.g. '4524667749493')
country	string	optional	Country for pricing (DE or AT, default DE)
reference_shop	string	optional	Shop id or display name to compare against. When set, the response states how much cheaper the cheapest shop is vs. this shop.

eans	array	required	Array of EAN barcodes (8–14 digit numbers as strings, e.g. '4524667749493'). NOT URLs.
country	string	optional	Country for pricing and shipping (DE or AT, default DE)

url	string	required	Product page URL from a supported shop (e.g. 'https://www.bike24.de/p2462871.html')
country	string	optional	Country for pricing (DE or AT, default DE)