English Français العربية

FindSaunaPlunge — US cold plunge & sauna studios

السجل الرسمي الصحة

Cold plunge, sauna and contrast-therapy studios across US metros, each fact dated.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http findsaunaplunge-us-cold-plunge-sauna-stu 'https://findsaunaplunge.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "findsaunaplunge-us-cold-plunge-sauna-stu": {
            "type": "http",
            "url": "https://findsaunaplunge.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FindSaunaPlunge MCP server
  2. Tools
  3. Connect
  4. Run it yourself
  5. How it runs
  6. Design rules
  7. Licence

FindSaunaPlunge MCP server

Model Context Protocol server for findsaunaplunge.com: cold plunge, sauna and contrast-therapy venues across US metros. get_data_freshness reports the current venue count and the dates the records were last checked. Every published temperature and price is read from the venue's own pages and carries its source URL, capture date and verbatim quote. Absent fields mean the venue does not publish that detail — never zero.

Tools

ToolArgumentsReturns
search_venuesquery?, citySlug?, modality?, access?, maxDropInUsd?, limit?Compact venue records; filters AND-combine. maxDropInUsd matches only venues with a published drop-in price.
get_venueidThe full feed record, including per-fact sources.
list_cities—Covered cities with venue counts and available modalities.
get_city_statscitySlugCounts, published price and temperature ranges, contrast-capable venues.
get_data_freshness—When the feed was built and the newest/oldest lastVerified.

Connect

# Claude Code
claude mcp add --transport http findsaunaplunge https://findsaunaplunge.com/mcp

# Any client, by hand
curl -s -X POST https://findsaunaplunge.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_venues","arguments":{"citySlug":"austin-tx","modality":"cold_plunge","limit":3}}}'

Run it yourself

The handler needs nothing but the public feed, so it runs anywhere with Node 24+:

npm start                    # JSON-RPC over stdio, one message per line (= node src/serve.ts --stdio)
npm run http                 # Streamable HTTP on :8080 — POST /mcp        (= node src/serve.ts)
docker build -t findsaunaplunge-mcp . && docker run -i findsaunaplunge-mcp   # stdio
npm test                     # smoke test: stdio + HTTP against the live feed

Both modes read https://findsaunaplunge.com/api/v1/venues.json (override with FINDSAUNAPLUNGE_ORIGIN), so a self-hosted copy serves exactly what the site serves.

How it runs

src/mcp.ts is the whole server: one handleMcp(request, env) function mounted at /mcp inside the site's Cloudflare Worker. It has no dependencies. Tool results come from the static /api/v1/venues.json asset produced by the site build (fetched through the Worker's ASSETS binding and memoized per isolate), so the server can never disagree with the site and a deploy refreshes it automatically. server.json is the registry manifest.

This repository is the published source of that server. The site itself is not open source.

Design rules

  • Stateless: no sessions, no server-initiated SSE. Every POST is self-contained.
  • Unknown arguments are rejected with a message naming the valid ones, rather than silently ignored.
  • Nothing here is, or will be, a paid placement.

Licence

MIT — see LICENSE. The venue data the server serves is separately licensed CC BY 4.0.

الأسئلة الشائعة

ما هو FindSaunaPlunge — US cold plunge & sauna studios؟

Cold plunge, sauna and contrast-therapy studios across US metros, each fact dated.

كيف أثبّت FindSaunaPlunge — US cold plunge & sauna studios؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http findsaunaplunge-us-cold-plunge-sauna-stu 'https://findsaunaplunge.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج FindSaunaPlunge — US cold plunge & sauna studios إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل FindSaunaPlunge — US cold plunge & sauna studios مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون FindSaunaPlunge — US cold plunge & sauna studios؟

ينشره findsaunaplunge. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.