Developers

Your coaching business, programmable.

Everything you manage in Kounisou — clients, programs, check-ins, nutrition, chat, your calendar — is available through a clean REST API. Connect an AI assistant over MCP and it can import your whole program library, onboard your roster, and help run week-to-week coaching — in your account, scoped to your business only.

Quick start

Create an API key in Settings → API (available on Pro and Studio plans).
Send it as a Bearer token with every request.

curl https://kounisou.com/api/v1/clients \
  -H "Authorization: Bearer kns_live_..."

Full machine-readable spec: /api/v1/openapi.json (OpenAPI 3.1 — generate an SDK or Postman collection from it).

Connect your AI assistant (MCP)

Kounisou speaks the Model Context Protocol — the open standard AI assistants use to work with your tools. Point your assistant at the endpoint below with your API key and it can check client progress, summarize check-ins, draft replies, assign programs, and keep your calendar — with your approval, in your account, scoped to your business only.

Endpoint   https://kounisou.com/api/mcp
Auth       Authorization: Bearer kns_live_...

Using Claude Code:

claude mcp add --transport http kounisou https://kounisou.com/api/mcp \
  --header "Authorization: Bearer kns_live_..."

Any other MCP client (JSON config):

{
  "mcpServers": {
    "kounisou": {
      "type": "http",
      "url": "https://kounisou.com/api/mcp",
      "headers": { "Authorization": "Bearer kns_live_..." }
    }
  }
}

Read tools · Pro & Studio

list_clientsRoster with status and names
get_clientSnapshot: program, 30-day adherence, last activity
get_conversationChat history with a client, both directions
list_checkins / get_checkinSubmissions, answers, review status
list_programs / get_programProgram library, down to every set and rep
search_exercises1,000+ movement library + your custom exercises
get_nutrition_summaryDaily calories and macros per client
get_calendarReminders + check-ins awaiting review
get_business_summaryOne-call business overview

Write tools · Studio

create_programImport a complete program — days, exercises, sets, reps — in one call
invite_clientSend a branded client invitation by email
send_messageMessage a client in Kounisou chat
assign_programAssign a program to a client
review_checkinMark a check-in reviewed with notes
create_reminderAdd a client reminder to the calendar

Your assistant only ever sees your own coaching data, and write actions require a Studio-plan key with write scope. Treat API keys like passwords — you can revoke them anytime in Settings.

Things coaches ask their AI to do

Once connected, these are single requests — no exports, no manual re-entry, no per-client clicking.

Import your program library

“Here's a spreadsheet of my 12 training programs. Import them all into Kounisou with the right days, exercises, sets, and reps.”

One create_program call per program. Exercise names match the library automatically; anything unique to you becomes your custom exercise.

Onboard your whole roster

“Invite these 30 clients from my old platform — here's the CSV with names and emails.”

invite_client sends each person your branded invitation. They appear on your roster as they accept — plan limits respected.

Run your Monday review

“Summarize every check-in from the weekend, draft replies in my voice, and flag anyone whose adherence dropped.”

Reads check-ins, chat history, and adherence; drafts sit with you for approval before send_message delivers them.

REST endpoints

Method	Path	What it does
GET	/api/v1/clients	List clients
POST	/api/v1/clients	Invite a client
GET	/api/v1/workouts	List workout programs
POST	/api/v1/workouts	Create a program — full days + exercises in one call
GET	/api/v1/workouts/{id}	Program detail with days and exercises
DELETE	/api/v1/workouts/{id}	Delete an unassigned program
POST	/api/v1/workouts/{id}/assign	Assign a program to a client
GET	/api/v1/checkins	List check-in submissions
PATCH	/api/v1/checkins/{id}	Review a check-in
GET	/api/v1/nutrition/summary	Client nutrition summary
GET	/api/v1/calendar	Reminders + pending check-ins
POST	/api/v1/calendar	Create a client reminder
GET	/api/v1/exercises	Exercise library — searchable by name
GET	/api/v1/messages	Chat history + conversation list
POST	/api/v1/messages	Send a message to a client
GET	/api/v1/analytics	Coaching analytics
GET/POST	/api/v1/webhooks	Event subscriptions

Access by plan

Pro

Read-only API + read MCP tools · 1,000 requests/hour

Studio

Full read/write API + all MCP tools · 10,000 requests/hour

Enterprise

Uncapped rate limits and custom integrations

See pricing for full plan details.