bikefuchs-mcp-stub

This is not the real Bikefuchs MCP server. It is a namespace-defense placeholder that reserves @bikefuchs on Smithery while the production server is developed. It exposes one informational tool and nothing else.

What this exposes

One tool: get_info

Returns a text message with the Bikefuchs launch status, the list of tools that will be available in the real server, and a link to bikefuchs.de.

When the real server launches

Q3 2026, following the public launch of bikefuchs.de. The production server will include tools for cart optimization, product search, EAN lookup, and shop info across 5+ German/Austrian bike shops. This repo will be replaced or superseded at that point.

Connect remotely (Claude Desktop)

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

{
  "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.

1. Push to GitHub

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

2. 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.

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

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

5. 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.

6. Verify the live endpoint

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

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

7. 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.

Links

• bikefuchs.de — live bike price comparison
• Smithery listing — available after step 7
• MCP specification