CONNECTOR DOCUMENTATION
STREEQ connector reference.
Everything the STREEQ connector does, how sign-in works, and what to do if something goes wrong. Operated by TRAINEDBY FIT LTD (UK company 17488583).
At a glance
- Connector URL: https://mcp.streeq.app (also answers at https://mcp.streeq.app/streeq/mcp).
- Sign-in: OAuth 2.1 with PKCE (S256), through https://mcp.trainedby.fit. Dynamic client registration and client ID metadata documents are supported, so no client ID needs to be issued in advance.
- Setup steps for Claude, ChatGPT and other assistants, and the permissions explained: Connect your AI.
- Privacy, terms, support: viv@trainedby.fit.
What it does
- Reads your own record: today’s rings, workouts, meals, weight and measurements, health history synced from Apple Health or Health Connect, progress and goals.
- Logs things for you: meals (described, or from a photo with the separate photo permission), weight, measurements, workouts and sets, daily and weekly check-ins.
- Builds and changes your own training plan. A new plan or a change is shown as a preview first and is saved only when you confirm.
- Manages your nutrition strategy, goals and reminder times.
- Keeps short notes from your conversations so later chats know them. You are asked before anything is saved.
- If a coach manages your plan through TrainedBy, STREEQ shows it and blocks changes to the parts the coach owns.
Examples
- “Set up a 3-day beginner gym plan for me.” The assistant asks a few questions, calls
propose_streeq_workout_programto show a preview, and after you say yes callsconfirm_streeq_workout_program. The plan appears in the STREEQ app. - “I had chicken, rice and salad for lunch, about 600 calories.” The assistant calls
log_streeq_manual_meal. Numbers you give are saved as yours; numbers the assistant estimates are marked as estimates. - “Remind me to check in at 6 pm on training days, starting next Monday.” The assistant calls
set_coaching_rhythm. STREEQ emails you, and notifies the app if it is installed, when a check-in is missed.
Tools (69)
Every tool the connector offers. “Changes data” means the tool writes to your STREEQ record.
| Tool | What it does | Changes data |
|---|---|---|
append_streeq_context | Use this when the person asks you to remember something about their training, food or recovery, or says yes when you offer to save it, for example a goal, an injury to train around, or stress that affects their sleep. | Yes |
archive_streeq_athlete_goal | Archive one owned athlete goal without deleting its history. | Yes |
change_streeq_endurance_target | Change one exact owned endurance session or indexed interval pace/load target using exercise occurrence identity and programme revision. | Yes |
change_streeq_nutrition_item | Change one stable ingredient occurrence when the person owns nutrition authority. | Yes |
change_streeq_nutrition_meal | Replace the ingredients in one exact stable meal coordinate in a self-owned nutrition strategy, recomputing meal/day totals and preserving a before/after diff. | Yes |
change_streeq_workout_set_target | Change one prescribed set target when the person owns workout authority. | Yes |
compact_streeq_context | Use this when a STREEQ result says the notes are long: rewrite the whole notes file shorter. | Yes |
confirm_streeq_workout_program | Explicitly confirm one proposal and commit it once through the immutable plan ledger. | Yes |
create_streeq_athlete_goal | Create one exact athlete goal with explicit units and a stable idempotency key. | Yes |
create_streeq_custom_exercise | Use this when the person does an exercise that is not in the library: create it as their own custom exercise so it can go in a plan and be logged. | Yes |
edit_streeq_workout_structure | Add, remove, reorder or substitute one exact exercise occurrence, or create/clear an exact superset, in one self-owned programme day. | Yes |
fetch | Read one full STREEQ record by the id returned from search (for example "workout:<id>", "meal:<id>", "today:current"). | No |
finish_streeq_workout | Finish an owned live workout and promote it once to canonical workout history. | Yes |
get_coach_plan_today | TrainedBy clients: read today's workout and nutrition targets from the coach's plan. | No |
get_coach_setup_prompt | Get the text that sets this AI up as the person's coach: recurring tasks in this AI app that call get_today and log answers. | No |
get_coaching_rhythm | Read what the person asked to be asked and when, and their reminder settings. | No |
get_streeq_account_overview | Use this when you need an overview of the person’s STREEQ account: profile, units, plan owner (self or coach), membership and today’s state. | No |
get_streeq_active_nutrition_strategy | Read the one active daily-rules, simple-meal or macro nutrition strategy. | No |
get_streeq_active_workout_program | Use this when the person asks about their workout plan, this week’s training, today’s session, or which sets, reps and weights to do. | No |
get_streeq_active_workout_session | Use this when the person asks about a workout they have already started, or before starting one, to see whether a session is in progress and what has been logged in it. | No |
get_streeq_app | Use this only when the person asks for something the chat cannot do because it needs their phone: pairing Apple Watch or WHOOP (watch), syncing steps from Apple Health or Health Connect (health_sync), scanning a... | No |
get_streeq_context | Use this when you are about to advise on training, food, goals or a plan and have not seen this person’s saved notes in this chat: read the notes saved from their past chats in ChatGPT, Claude and other AIs. | No |
get_streeq_endurance_activity | Read one owned endurance activity with route, splits, device laps, intervals, pace, elevation, heart rate, peak-effort segments and repeated-route comparisons. | No |
get_streeq_endurance_progress | Read owned weekly, monthly and yearly endurance totals, sport-safe pace, elevation, consistency, personal records and qualified heart-rate load. | No |
get_streeq_exercise_progress | Read lineage-aware performed history for one exercise. | No |
get_streeq_game | Read the connected person’s canonical Today rings, recent Perfect Days, streak, Saves, level, accomplishments and weekly game state. | No |
get_streeq_health_history | Read a page of saved daily health and wearable biometrics with provenance. | No |
get_streeq_meal_photo | View one owned private meal photo with its recorded nutrition certainty. | No |
get_streeq_nutrition_adherence | Analyse actual evidence against the active nutrition strategy for up to 90 days: planned meal-slot completion, daily-rule completion and actual macro averages versus targets. | No |
get_streeq_profile | Read the connected person’s product-neutral profile and module preferences. | No |
get_streeq_progress_history | Read body-weight, circumference and body-scan result history without photo bytes. | No |
get_streeq_progress_summary | Use this when the person asks how they are progressing: weight trend, measurements, body fat, strength records, endurance records or how they are doing over time. | No |
get_streeq_sync_diagnostics | Explain the latest device permission and sync state, server checkpoints, evidence provenance and reconciliation state without returning or inventing health values. | No |
get_streeq_usage | Read how much of this week's STREEQ AI usage the person has used, as a percentage, and when it resets. | No |
get_today | Call this first in any conversation about training or food, and from every scheduled check-in. | No |
list_streeq_athlete_goals | List the connected person’s evidence-backed distance, frequency, event, time and pace goals. | No |
list_streeq_context_versions | Use this when the person says something is missing from what you remember, or asks what changed in their notes: list the earlier versions of the notes, newest first, with what each tidy removed. | No |
list_streeq_endurance_activities | List the connected person’s endurance history with pace, heart-rate and elevation summaries. | No |
list_streeq_exercise_groups | Use this when you need the muscle groups and equipment names the STREEQ exercise library uses, before searching or creating an exercise. | No |
list_streeq_meals | Use this when the person asks what they ate, wants to see or check today’s food, or asks about calories, protein, carbs or fat for a day. | No |
list_streeq_starter_programmes | Use this when someone wants a ready-made workout programme to start from: list the STREEQ starter programmes. | No |
list_streeq_workouts | Use this when the person asks about workouts they have already done: their training history, last session, or what they lifted. | No |
log_streeq_activity | Log an unplanned strength/timed/functional workout or a direct canonical endurance activity without altering the active programme. | Yes |
log_streeq_manual_meal | Log food you describe without inventing nutrition numbers. | Yes |
log_streeq_meal_photo | Upload exact image bytes for one meal and save the photo and description as canonical food evidence. | Yes |
lookup_streeq_food_barcode | Use this when the person gives a product barcode number: look the food up in the STREEQ database. | No |
message_coach | TrainedBy clients: send a message to the coach in the TrainedBy chat. | Yes |
propose_streeq_workout_program | Store a reviewable self-managed workout-programme proposal without changing the active programme. | Yes |
record_streeq_measurements | Record dated circumference measurements with a stable request id. | Yes |
record_streeq_weight | Record body weight in kg or lb with a stable request id. | Yes |
replace_streeq_nutrition_strategy | Create or replace the one active self-owned nutrition strategy. | Yes |
replace_streeq_workout_program | Create or replace the one active self-owned workout programme. | Yes |
report_missing_capability | Use this only when the person asks to request a feature or to tell the team about something STREEQ cannot do yet. | Yes |
request_streeq_health_reconciliation | Queue one idempotent, person-scoped device reconciliation for biometrics and/or workouts. | Yes |
reschedule_streeq_endurance_session | Move one exact unfinished endurance occurrence to an open programme week/day, preserving its immutable occurrence audit. | Yes |
restore_streeq_context_version | Use this when an earlier version of the notes was better, for example a fact was lost in a tidy: put that version back. | Yes |
revise_streeq_athlete_goal | Revise one owned athlete goal using optimistic revision control and a stable idempotency key. | Yes |
revise_streeq_workout_program | Create a revised preview from a proposal or the active plan without committing it. | Yes |
search | Use this only to find a particular past record by words or a date, for example “the run last Sunday” or “meals from my holiday”. | No |
search_streeq_exercises | Use this when building or changing a workout plan and you need real exercises: search the STREEQ exercise library (including the person’s own custom exercises) by name, muscle group or equipment. | No |
search_streeq_foods | Use this when logging food and you want real nutrition values: search the STREEQ food database by name. | No |
set_coaching_rhythm | Save what the person wants to be asked and when (local times in their timezone), and whether STREEQ may remind them itself when something is missed. | Yes |
start_streeq_workout | Start or resume canonical execution of an active programme workout. | Yes |
submit_daily_check_in | Submit today's daily check-in: energy 1 to 5, notes, optional weight, and (for coached clients) which coach tasks were done. | Yes |
submit_weekly_check_in | Submit this week's check-in: weight, energy 1 to 5 and notes. | Yes |
suggest_streeq_routes | Rank the connected person’s own saved routes by requested activity, distance and eligible attempt evidence. | No |
sync_streeq_workout_sets | Synchronize prescribed-versus-actual sets into an owned active workout session. | Yes |
update_streeq_meal | Correct an owned meal at the evidenceVersion actually reviewed. | Yes |
update_streeq_profile | Update the connected person’s display name, timezone, units or enabled modules. | Yes |
Usage limits
The free plan includes a weekly allowance of AI usage through the connector. Opening calls such as get_today, plan previews, and looking things up in the exercise and food libraries are not counted. When the allowance is used up, the assistant is told when it resets. STREEQ Pro removes the limit.
Troubleshooting
- The sign-in page says the account was not found. Sign in with the same method you use in the STREEQ app (email, Apple or Google). Create the account in the app first if you have none.
- “This week’s free AI usage on STREEQ is used up.” The reset time is in the message. Pro removes the limit.
- A plan change is refused because a coach manages it. Your coach owns that plan. Ask them, or ask the assistant to message your coach.
- Steps or sleep are missing. These come from Apple Health or Health Connect through the phone app. Open the STREEQ app so it can sync, then ask again.
- The connection expired. Remove the connector and add it again.
Support
Email viv@trainedby.fit with the assistant you use, roughly when it happened and what you asked. Do not send passwords.