Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brama.work/llms.txt

Use this file to discover all available pages before exploring further.

Status: live, closed beta, agency-assisted onboarding. 10 read-only MCP tools на Whoop API v2. Підключення робиться разом з агенцією Bystrov.

​
Як це працює

Whoop інтеграція — Full BYO (Bring-Your-Own): ти створюєш власний Whoop developer app, і Brama використовує саме твої client_id + client_secret. Brama не має спільного Whoop-застосунку — кожен tenant приносить свій. Це тримає твої Whoop-дані прив’язаними до твого ж OAuth-клієнта, без shared-app середини. Після того як ти вписав app-креди у Brama, проходиш стандартний OAuth consent — і Brama отримує access + refresh токени, зберігає їх зашифрованими (ключі поза базою). Whoop ротує refresh-токен при кожному оновленні; Brama персистить ротовані токени автоматично — повторний consent при звичайній роботі не потрібен.

​
Підключення

​
1. Створи Whoop developer app

  1. Зайди на developer.whoop.com → увійди своїм Whoop акаунтом
  2. Створи новий app
  3. У полі Redirect URI встав точно: 
    https://app.brama.work/integrations/whoop/callback
  4. Признач app’у scopes: read:recovery, read:sleep, read:cycles, read:workout, read:profile, read:body_measurement
  5. Збережи — отримаєш Client ID та Client Secret

​
2. Впиши app-креди у Brama

app.brama.work → Integrations → Whoop → встав Client ID + Client Secret → збережи. Креди зберігаються зашифрованими, ізольовано per-tenant. Brama ніколи не показує їх назад — лише статус. На сторінці Whoop-інтеграції натисни Authorize. Відкриється Whoop consent — підтвердиш доступ. Brama отримає токени і статус зміниться на active.

​
4. Запит

У своєму MCP клієнті (Claude Desktop, Gemini CLI — див. Connect a client):
Який у мене recovery score сьогодні за Whoop?
Агент викличе brama_whoop_get_recovery_summary і поверне recovery score, HRV та resting heart rate.

​
MCP tools (live)

Усі 10 tools — read-only, на Whoop API v2. Нічого не змінюють у Whoop.

​
Recovery

brama_whoop_get_recovery_summary

Останні recovery-записи tenant’а: recovery_score (0–100), HRV (RMSSD, ms), resting heart rate (bpm), дата.Параметри: limit (optional — default 1, max 25) — скільки останніх записів повернути.

brama_whoop_get_recovery_for_cycle

Recovery-запис для конкретного фізіологічного циклу.Параметри: cycle_id (required, int64) — з brama_whoop_get_cycle_summary чи brama_whoop_get_recovery_summary.

​
Sleep

brama_whoop_get_sleep_summary

Останні sleep-записи: performance / efficiency / consistency (%), тривалість у ліжку та за стадіями (light / REM / slow-wave), respiratory rate, кількість disturbances.Параметри: limit (optional — default 1, max 25).

brama_whoop_get_sleep_by_id

Конкретна sleep-активність за UUID — повний розклад стадій + sleep_needed.Параметри: sleep_id (required, UUID) — з brama_whoop_get_sleep_summary.

​
Cycles

brama_whoop_get_cycle_summary

Останні фізіологічні цикли (від початку сну до наступного початку сну): day strain (0–21), kilojoules, avg / max heart rate.Параметри: limit (optional — default 1, max 25).

brama_whoop_get_cycle_by_id

Конкретний цикл за int64 ID.Параметри: cycle_id (required, int64).

​
Workouts

brama_whoop_get_workouts

Останні тренування: strain (шкала 0–21), avg / max heart rate, спалені kilojoules, дистанція, altitude.Параметри: limit (optional — default 3, max 25).

brama_whoop_get_workout_by_id

Конкретне тренування за UUID — з тривалістю за heart-rate зонами.Параметри: workout_id (required, UUID) — з brama_whoop_get_workouts.

​
Profile

brama_whoop_get_profile

Whoop user profile tenant’а: user_id, email, first_name, last_name.Параметри: немає.

brama_whoop_get_body_measurements

Body measurements: height (m), weight (kg), max heart rate (bpm).Параметри: немає.
Потребує scope read:body_measurement. Якщо app створений раніше без цього scope — додай scope у Whoop developer app і пройди Authorize ще раз.

​
Безпека

  • Full BYO — Brama не тримає спільного Whoop-застосунку; client_id / client_secret належать твоєму app’у.
  • App-креди й токени зашифровані at rest, ключі поза базою; на диск не пишуться, у пам’яті лише на час запиту; у логи не потрапляють.
  • Whoop ротує refresh-токен при кожному оновленні — Brama персистить ротовані токени, тому повторний consent при звичайній роботі не потрібен.
  • Кожен tenant ізольований — твої Whoop-дані недосяжні іншим tenant’ам.
  • Read-only — tools нічого не змінюють у Whoop.

​
Питання

Підключення проходить разом з агенцією Bystrov. Напиши viktor@brama.work.