Skip to main content
Glama
deenesjakoruzh
samiashi

chrono24-mcp

by samiashi
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

chrono24-mcp

npm CI License: MIT

Chrono24 watch-marketplace tools for any MCP-capable LLM client - Claude Code, Claude Desktop, Codex, Cursor, Windsurf and friends.

Search listings, shortlist by price/location/seller type, then pull full watch details (reference, movement, caliber, box & papers, dealer info, photos) without leaving your chat.

search_listings("Rolex Submariner", { sort: "price_asc" })
  -> 60 cards, totalCount 9145, USD prices
get_watch("48091925")
  -> Rolex Submariner Date, ref 16610, $10,307, caliber 3135, box+papers, 16 photos

How it works

Chrono24 has no public API and sits behind a Cloudflare managed challenge that blocks plain HTTP (403). This server drives a real Chrome via Playwright with a persistent profile, so the Cloudflare clearance cookie is earned once and reused across restarts. Requests are serialized with ~3.5s spacing plus jitter to stay polite; responses are cached (search 3 min, details 30 min).

Related MCP server: JobSpy MCP Server

Setup

Requires Node >= 20 and Google Chrome (the fallback bundled Chromium needs a one-time npx playwright install chromium). First run may take ~15-30s to clear the Cloudflare challenge.

No repo clone needed - run straight from npm with npx.

Claude Code

claude mcp add chrono24 -- npx -y chrono24-mcp

or project scope via .mcp.json:

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Codex CLI / ChatGPT desktop

Add to ~/.codex/config.toml (shared by Codex CLI, IDE extension and desktop app):

[mcp_servers.chrono24]
command = "npx"
args = ["-y", "chrono24-mcp"]
tool_timeout_sec = 120

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

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

Global install alternative

npm i -g chrono24-mcp
# then use "chrono24-mcp" as the command in any client config

Run from source

git clone https://github.com/samiashi/chrono24-mcp.git
cd chrono24-mcp
npm install && npm run build && npm run smoke

Tools

Tool

Description

list_brands

List all 550+ Chrono24 watch brands with numeric ids (optional name filter). Feed ids into search_listings' manufacturerIds or names into find_models.

find_models

A brand's model catalog: model name, slug and numeric model id (e.g. Rolex -> Submariner mod1, Daytona mod2). Pair with search_listings' models + manufacturerIds for precise searches.

list_filters

All search facet filters with allowed values (case material, bracelet material, gender, watch category, country, listing age). Use with search_listings' facets param.

search_listings

Search with query + filters (brand id, model id, reference, price range, condition, year, seller countries, facets), sort (relevance, price_asc, price_desc, newest, popularity), paging and an optional limit (1-60) for shortlisting. Returns cards with id, url, title, USD price, location, seller type, thumbnail.

get_price_stats

Price statistics for a watch: min, p10/p25/median/p75/p90, max and sample size from the 60 cheapest matching listings. One request - the fast way to answer "what's a fair price for X?".

get_watch

Full detail for one listing id: reference, condition, year, movement/caliber/power reserve, case material/diameter, scope of delivery, location, description, all photo URLs, canonical URL, seller ids.

get_watches

Batch detail for up to 10 ids. Sequential and polite (~4s per uncached id); per-id failures don't break the batch.

get_dealer_listings

A dealer's current inventory by customerId (from get_watch's sellerIds). Same card shape as search_listings.

get_dealer_ratings

A dealer's customer reviews by dealerId (from get_watch's sellerIds - a different id!). Per-review rating, text, dealer reply, paging totals.

All prices are normalized to USD (currencyId=USD). Empty result sets are valid outcomes, not errors.

Environment variables

Variable

Default

Purpose

REQUEST_DELAY_MS

3500

Min spacing between Chrono24 requests. Raise it if you ever see challenges.

HEADLESS

true

Set false to run a visible browser (useful when a challenge needs manual completion once).

CHROME_CHANNEL

true

Prefer installed Google Chrome; set false to force bundled Chromium.

PROFILE_DIR

~/.cache/chrono24-mcp/profile

Browser profile holding the Cloudflare clearance cookie.

SEARCH_CACHE_TTL_S

180

Search cache TTL.

DETAIL_CACHE_TTL_S

1800

Detail cache TTL.

TAXONOMY_CACHE_TTL_S

86400

Brand/model taxonomy cache TTL.

MAX_BATCH

10

Cap for get_watches.

CURRENCY_ID

USD

Price normalization currency.

DEBUG

false

Verbose fetch logging to stderr.

Troubleshooting

  • Cloudflare challenge timeout: wait ~30s and retry once. If persistent, run the server once with HEADLESS=false, complete any interactive challenge, then switch back.

  • Slow first call: the first request after a cold profile earns clearance; subsequent calls reuse it.

  • Chromium fallback missing browser: run npx playwright install chromium.

Roadmap

Ideas welcome - open an issue.

Disclaimer

Educational/research project. Not affiliated with, endorsed by, or associated with Chrono24 GmbH. Scraping may violate Chrono24's Terms of Service depending on jurisdiction and use; you are responsible for compliance. Rate limits are deliberately conservative - keep them that way.

License

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • cryptosense-mcp

    josephibra
    A
    license
    A
    quality
    D
    maintenance
    Real-time crypto market intelligence MCP. Get prices, trending coins, market overview, top coins by market cap, and portfolio value — all through natural language in Claude, Cursor, or any MCP client
    6
    MIT

  • JobSpy MCP Server

    chinpeerapat
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables job search and scraping across multiple job boards (LinkedIn, Indeed, Glassdoor, etc.) with advanced filtering, directly from Claude Desktop or other MCP clients.
    5
    MIT

  • Webotee Amazon Product

    ncosic
    A
    license
    A
    quality
    A
    maintenance
    Hosted Amazon market-intelligence MCP for Claude and ChatGPT: query brands, sellers, ASINs, under-competed niches, the cross-seller operator network, observed buy-box history, and Amazon/Walmart cross-marketplace overlap. 65 read-only research tools over a pre-collected research dataset.
    72
    MIT

  • ebay-mcp

    luke-nielsen
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude to search eBay listings, analyze price distributions, find deals, and generate market research overviews via the Model Context Protocol.
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/samiashi/chrono24-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server