The MCP tool reference

Creates a client and SENDS an invitation email to the given address. Calling it again for the same email does not duplicate the client — it re-sends the invitation (use this to re-invite a pending client). Returns the client card plus the invitation link the coach can share directly.

email: string displayName: string

Sets the system prompt of the client's built-in AI assistant (persona/instructions). An empty string resets it to the default. Name and email cannot be changed here. Returns the updated client card.

clientId: string systemPrompt: string

Archives a client (status archivedByCoach, hides from the active list). Reversible via activate_client. Returns the updated client card.

clientId: string

Restores an archived client to active status. Reverse of archive_client. Returns the updated client card.

clientId: string

REPLACES a client's whole tag set: pass the complete desired list, not a diff (an empty list clears all tags). Tags are normalized to lowercase, trimmed, and a leading '#' is stripped; reuse existing tags from list_client_tags where possible. Returns the client's resulting tags.

clientId: string tags: string[]

Grants or extends a client's paid access until a calendar date (inclusive, end of day in the client's timezone) — a date in the past is accepted and ends access immediately, so double-check the year. Pass amount (with optional currency, default USD, and paidAtIso) to also record a payment in the coach's private ledger. Works only for active clients. On the free plan this is the only paid gate: opening access for a client who is not billable yet fails when the coach already has 3 such clients (extending an already billable client always works, and revoke_client_access is never gated). Returns the updated client card (see accessSummary; trialUntil marks access granted automatically as a trial, which does not take a plan slot).

clientId: string accessUntil: date (YYYY-MM-DD) amount?: number (≥ 0) currency?: string paidAtIso?: datetime (ISO 8601)

Revokes a client's paid access immediately (accessSummary keeps the period as history with cancelledAt set). Reversible by granting access again via set_client_access. Not idempotent: each call re-stamps cancelledAt and logs the action — don't retry a successful call. Returns the updated client card.

clientId: string

Creates a service plan (pricing offer): name, optional price (omit for free/negotiable), duration (value + unit days/weeks/months) and included items. status defaults to active; hidden keeps it out of pickers. Returns the created plan.

name: string description?: string priceAmount?: number (≥ 0) currency?: string durationValue: integer (≥ 1) durationUnit: days | weeks | months status?: active | hidden | archived includedItems?: string[]

Updates a service plan. Pass only the fields to change; description/priceAmount/currency accept null to clear. includedItems REPLACES the whole list. Renaming does not affect clients already granted access (they keep a name snapshot). Returns the updated plan.

servicePlanId: string name?: string description?: string priceAmount?: number (≥ 0) currency?: string durationValue?: integer (≥ 1) durationUnit?: days | weeks | months status?: active | hidden | archived includedItems?: string[]

Archives a service plan (status → archived, kept for history; clients already granted access are unaffected). To bring it back use update_service_plan with status. Returns the updated plan.

servicePlanId: string

Creates a client workout as an empty shell — add exercises separately. type: workout (regular) or rest_day. Returns the created workout (lean).

clientId: string title: string date: date (YYYY-MM-DD) type: workout | rest_day description?: string

Updates a client workout. Pass only the fields to change (omitted fields keep their value). exerciseIds may only reorder/remove EXISTING exercise ids (unknown ids are rejected); to add new exercises use add_exercises_to_client_workout. Returns the updated workout (lean).

clientId: string workoutId: string title?: string description?: string date?: date (YYYY-MM-DD) type?: workout | rest_day exerciseIds?: string[]

Adds exercises from the coach's library to a client workout, in the given order (each is copied; library video carries over). Set per-exercise instructions (e.g. '3×12, rest 60s') right away. Items are applied independently: a failed item is reported in results[] and the rest continue; exercises already in the workout are skipped as duplicates — retrying a batch is safe. Returns per-item results and the updated workout (lean).

clientId: string workoutId: string exercises: { exerciseId, instructions? }[]

Creates a custom exercise directly in a client workout (not from the library). videoUrl: YouTube only. Prefer add_exercises_to_client_workout for library exercises. Returns the updated workout (lean).

clientId: string workoutId: string title: string instructions?: string description?: string videoUrl?: string

Updates an exercise inside a client workout (exerciseId from get_client_workout). Pass only the fields to change; omitted fields keep their value, including video. videoUrl: YouTube only. Returns the updated workout (lean).

clientId: string workoutId: string exerciseId: string title?: string instructions?: string description?: string videoUrl?: string

Creates a program template (title/description only — add days with create_program_workout). Returns the program tree.

title: string description?: string

Updates a program's title/description. Pass only the fields to change (omitted fields keep their value). Returns the program tree.

programId: string title?: string description?: string

Assigns a program to a client: expands its days into real client workouts (day N lands on startDate + N-1). Only ADDS workouts — assigning the same program again creates a duplicate set, so never retry a successful assign. Returns how many workouts and exercises were created (0 if the program has no days).

programId: string clientId: string startDate: date (YYYY-MM-DD)

Creates a day in a program template as an empty shell — add exercises separately. day is the ordinal number within the program (>= 1), not a date. type: workout (regular) or rest_day. Returns the created day (lean).

programId: string type: workout | rest_day title: string description?: string day: integer (≥ 1)

Updates a program day. Pass only the fields to change (omitted fields keep their value). exerciseIds may only reorder/remove EXISTING exercise ids (unknown ids are rejected); to add new exercises use add_exercises_to_program_workout. Returns the updated day (lean).

programId: string workoutId: string type?: workout | rest_day title?: string description?: string day?: integer (≥ 1) exerciseIds?: string[]

Adds library exercises to a program day, in the given order (each is copied; library video carries over). Set per-exercise instructions (e.g. '4×8') right away. This is the right tool for filling a program. Items are applied independently: a failed item is reported in results[] and the rest continue; exercises already in the day are skipped as duplicates — retrying a batch is safe. Returns per-item results and the updated day (lean).

programId: string workoutId: string exercises: { exerciseId, instructions? }[]

Creates a custom exercise directly in a program day (not from the library). videoUrl: YouTube only. Prefer add_exercises_to_program_workout for library exercises (video carries over). Returns the updated day (lean).

programId: string workoutId: string title: string instructions?: string description?: string videoUrl?: string exerciseType?: strength | cardio | flexibility | timed

Updates an exercise inside a program day (exerciseId from get_program_workout). Pass only the fields to change; omitted fields keep their value, including video. videoUrl: YouTube only. Returns the updated day (lean).

programId: string workoutId: string exerciseId: string title?: string instructions?: string description?: string videoUrl?: string exerciseType?: strength | cardio | flexibility | timed

Creates an exercise in the coach's library. videoUrl: YouTube link only (video files cannot be uploaded via MCP). Returns the created exercise.

title: string description?: string exerciseType?: strength | cardio | flexibility | timed videoUrl?: string

Updates a library exercise. Pass only the fields to change; omitted fields keep their value. Video cannot be cleared via MCP — omitting videoUrl keeps the current one. Returns the updated exercise.

exerciseId: string title?: string description?: string tags?: string[] exerciseType?: strength | cardio | flexibility | timed videoUrl?: string

Creates a folder in the exercise library. Returns the created folder.

name: string

Renames an exercise library folder (renaming an auto month folder makes its name permanent). Returns the updated folder.

folderId: string name: string

Moves library exercises into a folder, or to the library root when folderId is null. exerciseIds are LIBRARY ids (from list_exercises). Atomic: any unknown/foreign id rejects the whole batch. Returns the applied move.

exerciseIds: string[] folderId: string

Creates a form (questionnaire/check-in) with an ordered list of question texts. Questions are shown to clients verbatim — write them in the client's language. Returns the created form.

title: string description?: string questions?: string[]

Updates a form. Pass only the fields to change (omitted fields keep their value). questions REPLACES the whole list — pass the complete new list, not a diff. Returns the updated form.

formId: string title?: string description?: string questions?: string[]

Sends a text message from the coach to the client's chat. The client sees it in the app immediately and gets a push notification — write in the client's language. Text only (attachments are app-only). Do not retry a successful call: it would post a duplicate.

clientId: string text: string

Sends a text comment from the coach into one exercise's thread (form feedback). clientId/workoutId/exerciseId come from get_client_workout; the client gets a push notification — write in the client's language. Text only. Do not retry a successful call: it would post a duplicate.

clientId: string workoutId: string exerciseId: string text: string

Creates a broadcast that WILL BE SENT to every client in the audience — at scheduledAtIso, or within a minute if omitted. Each client receives it as a personal 1:1 chat message (with push); {{name}} in the text is replaced by the client's name. Until it is dispatched you can still update or delete it. Returns the broadcast card.

content: string audience: { type, tags?, clientIds? } scheduledAtIso?: datetime (ISO 8601)

Rewrites an unsent broadcast (draft/scheduled only). NOT a partial update: content and audience fully REPLACE the current ones; omitting scheduledAtIso reschedules to now (send asap). Returns the updated card.

broadcastId: string content: string audience: { type, tags?, clientIds? } scheduledAtIso?: datetime (ISO 8601)

Requeues a FAILED broadcast for immediate sending (already delivered messages are skipped — clients get no duplicates). Returns the updated card.

broadcastId: string

Creates a funnel as a DRAFT (not public until publish_funnel). steps are optional raw step objects ({id, type, ...fields}) — copy the shape from an existing funnel (get_funnel); invalid steps are rejected. The slug is the public URL segment; a duplicate slug is allowed in a draft but blocks publish_funnel until changed (uniqueness among the coach's published funnels is enforced at publish, not here). Returns the funnel card.

slug: string locale: string title: string description?: string steps?: { id, type }[]

Updates a funnel. Pass only the fields to change (omitted fields keep their value); steps REPLACES the whole ordered list — pass the complete new list. Editing a published funnel goes live immediately and must stay compliant (invalid updates are rejected). Returns the updated card.

funnelId: string slug?: string locale?: string title?: string description?: string steps?: { id, type }[]

Publishes a funnel — its public page goes LIVE at {origin}/{coachHandle}/join/{slug}. Requires a compliant step set: exactly one age-gate, at least one disclaimer, at least one consent (ALWAYS required, even without sensitive questions; must precede any sensitive step), application as the last step — violations are rejected with the reason. Returns the updated card.

funnelId: string

Takes a funnel offline (status → draft); the public page stops being served. Reversible via publish_funnel. Returns the updated card.

funnelId: string

Marks a lead as seen (status new → seen). Idempotent (no-op on an already seen lead). Returns the updated lead.

leadId: string

Archives a lead (removes it from the active inbox). Reversible via restore_lead. Returns the updated lead.

leadId: string

Restores an archived lead back to the inbox (status archived → seen, not new). Returns the updated lead.

leadId: string

Creates a lead magnet as a DRAFT (not public until publish_lead_magnet). Add exercise blocks with add_exercise_to_lead_magnet; text/image blocks can be passed here ({id, type, ...fields}). slug is the public URL segment: kebab-case, and unique among the coach's published magnets. Returns the card.

slug: string locale: string title: string intro?: string seoDescription?: string blocks?: { id, type }[] cta?: { label, url }

Updates a lead magnet. Pass only the fields to change (omitted fields keep their value); blocks REPLACES the whole ordered list (reorder/remove existing raw blocks from get_lead_magnet); cta: object to set, null to remove. Cover image can only be uploaded in the app. Editing a published magnet goes live immediately. Returns the updated card.

leadMagnetId: string slug?: string title?: string intro?: string seoDescription?: string blocks?: { id, type }[] cta?: { label, url }

Appends a library exercise to a lead magnet as an exercise block (snapshot copy with video; instructions override the library text). Duplicates are allowed by design. Returns {blockId, leadMagnet}.

leadMagnetId: string exerciseId: string instructions?: string

Publishes a lead magnet — its public page goes LIVE at {origin}/{coachHandle}/free/{slug}. Requires at least one block and a CTA. Returns the updated card.

leadMagnetId: string

Takes a lead magnet offline (status → draft); the public page stops being served. Reversible via publish_lead_magnet. Returns the updated card.

leadMagnetId: string

Creates a content item for the coach and returns its full card. channel and format are required; status defaults to draft — pass published to log an already-posted item, or scheduled together with scheduledAtIso (ISO 8601 slot time).

channel: instagram | tiktok | youtube | telegram format: reels | carousel | story | post | short | video | text status?: idea | draft | review | scheduled | published | missed | analyzed | archived pillar?: education | results | behindTheScenes | engagement hook?: string body?: string scheduledAtIso?: datetime (ISO 8601)

Updates a content item's fields (channel, format, pillar, hook, body). Pass only the fields to change; omitted fields keep their value. Status and slot are changed by dedicated tools. Returns the updated card.

contentId: string channel?: instagram | tiktok | youtube | telegram format?: reels | carousel | story | post | short | video | text pillar?: education | results | behindTheScenes | engagement hook?: string body?: string

Turns an idea from the idea bank into a draft (status → draft). Allowed only from idea. Returns the updated card.

contentId: string

Sends a draft for the coach's approval (status → review). Allowed only from draft. Returns the updated card.

contentId: string

Returns content to draft and clears its slot (status → draft) — use to reject a review, unschedule, or replan a missed slot. Allowed from review, scheduled or missed. Returns the updated card.

contentId: string

Puts a draft or in-review content item into a calendar slot (status → scheduled). scheduledAtIso is the ISO 8601 slot time. Returns the updated card.

contentId: string scheduledAtIso: datetime (ISO 8601)

Marks a scheduled content item as published (status → published) — use once it has been posted to the channel. Returns the updated card.

contentId: string

Moves a content item into the archive (status → archived) — use to shelve an idea or draft you no longer plan to publish. Allowed from any non-terminal status; rejected for already-analyzed or archived items. Returns the updated card.

contentId: string

Creates a VIDEO content library asset record (title, description, tags); the video file itself is uploaded in the app afterwards. Image assets cannot be created via MCP — an image requires the file at creation, which only the app can attach. Returns the created asset.

title: string type: value description?: string tags?: string[]

Creates a Markdown document (note/plan). folderId must reference an existing folder. Indexed for semantic search (search_documents). Returns the created document.

title: string content: string folderId?: string tags?: string[]

Updates a document. Pass only the fields to change (omitted fields keep their value). folderId: a folder id to move, null to remove from its folder. Re-indexed for search when title/content change. Returns the updated document.

documentId: string title?: string content?: string folderId?: string tags?: string[]

Creates a document folder; parentId nests it under an existing folder. Returns the created folder.

title: string parentId?: string

Updates a document folder. Pass only the fields to change: title renames; parentId moves under another folder, null moves to the root. Returns the updated folder.

folderId: string title?: string parentId?: string

Updates the coach's own profile. Pass only the fields to change: displayName (shown to clients), language (UI locale: en or ru), timeZone (IANA, e.g. Europe/Belgrade), country (ISO code), brandColor (accent hex #RRGGBB used by generated content). Email, password, photo and the public handle can only be changed in the app. Returns the updated profile.

displayName?: string language?: en | ru timeZone?: string country?: string brandColor?: string

Creates a team owned by the coach. Returns the team card (the owner is the first member).

title: string description?: string

Updates a team's title/description (owner only). Pass only the fields to change. Returns the updated team card.

teamId: string title?: string description?: string

Invites a person into the team by email and SENDS an invitation email. Returns the member id, the invitation link to share and the updated team card.

teamId: string email: string displayName: string

Updates a team member's displayName and/or role (admin/member; ownership is not transferable). Returns the updated team card.

teamId: string memberId: string displayName?: string role?: admin | member