Developer Documentation

Integrate with BuildStability using MCP (for AI agents) or REST API (for traditional apps). Get your first API call working in under 5 minutes.

Quick Start (5 minutes)

Sign Up & Enable API

Create account → Business Settings → Enable API Access

Get Your Token

Business Settings → API & Integrations → Copy Token, or create an OAuth app for server-to-server

Auth guide →

Make Your First Call

Choose MCP or REST API below, then test with our examples

Code examples →

Choose Your Integration Method

Pick the approach that fits your use case. Both provide full access to your data.

MCP (AI Agents)

For Claude, ChatGPT, Gemini, custom agents

JSON-RPC 2.0 over HTTP
15 pre-built tools (clients, schedule, revenue, etc.)
Bearer token auth (Supabase JWT)

Quick Start Full Guide OpenAPI Spec

REST API

For web apps, mobile apps, integrations

Standard REST endpoints (GET, POST, PUT)
OAuth 2.0 Client Credentials flow
Clients, appointments, programs, revenue, classes, workouts

API Reference Try It (Swagger) OpenAPI JSON

Authentication

MCP / Direct API (JWT)

Easiest: Business Settings → API & Integrations → Copy Token. The JWT is copied to your clipboard.

What to do with it: set the Authorization: Bearer <token> header on every MCP or PostgREST request.

What a JWT looks like: Three base64url segments separated by dots (header.payload.signature), typically 200–500+ characters. Example format:

eyJhbGciOiJIUzI1NiIs...eyJhdWQiLCJlbWFpbC...<signed>

Authorization: Bearer <your-jwt-token>
Content-Type: application/json

REST API (OAuth 2.0)

Create an OAuth app, then exchange credentials for a token.

POST /api/oauth/token
Content-Type: application/json

{ "grant_type": "client_credentials",
  "client_id": "...", "client_secret": "..." }

Full authentication guide →

Rate Limits

Plan	Requests / 15 min	Daily Cap	Query Complexity
Free Trial	30	100	Basic
Essential	50	500	Standard
Starter	100	2,000	Standard
Pro	200	10,000	Advanced
Pro+	500	Unlimited	Advanced + Webhooks

Rate limit headers: X-RateLimit-Remaining, X-RateLimit-Reset. See pricing for plan details.

Resources

Guides

API Reference

For AI Agents

Account Resources (Login Required)

Manage OAuth Apps View API Usage Developer Sign Up

Available MCP Tools

15 tools available via MCP. Use tools/list for full details or see the Agent Guide.

Core

get_client_summary
list_active_programs
check_churn_risk
get_business_stats

Schedule

get_schedule
list_clients
get_available_slots

Analytics

get_revenue_summary
get_attendance_stats
get_popular_times

Actions

send_client_message
create_client_note
get_client_notes
get_client_workout_history

Ready to Build?

Start your free trial and get API access immediately. No credit card required.

Developer Sign Up Regular Sign Up