Developer documentation

The REST API and MCP server let you read and manage company, member, lead, class, attendance, invoice, messaging, and automation data. They are free on every plan.

Get an API key

Owners and users with the required privileges can create keys at API Access. A key is shown once; choose scopes, set an optional expiry, and revoke it there. High-risk scopes are unchecked by default.

Authentication

Send the key in the Bearer authorization header.

curl -H "Authorization: Bearer us_YOUR_API_KEY" https://users.solutions/api/v1/account

Base URL: https://users.solutions/api/v1

Scopes

Safety and limits

• Write operations that change data use preview/confirm where supported.
• Use Idempotency-Key for safe retries of supported writes.
• Rate limit: 60 requests per minute per API key.
• Daily cap: 200 confirmed messages per company.
• API requests are audit-logged without request or response bodies.
• Human-only actions not in the API: API-key management, billing or plan changes, payment-method entry, payouts, credentials or 2FA, ownership changes, granting privilege 1, and company deletion. Billing and plan changes must be completed by the owner in the browser.

Pagination and errors

List endpoints use limit and cursor where documented. Responses include next_cursor when another page is available. Errors use an error object; validation details may also be returned in errors.

{
  "error": {
    "code": "validation_error",
    "message": "The request could not be processed."
  },
  "errors": { "name": "This field is required." }
}

REST endpoint reference

Generated from the current OpenAPI document at request time. See OpenAPI 3.1 JSON.

MCP

MCP URL: https://users.solutions/mcp

Available tools: get_company, update_company, get_member_form, list_members, search_members, get_member, create_member, update_member, delete_member, list_fields, create_field, update_field, delete_field, list_leads, search_leads, get_lead, create_lead, update_lead, add_lead_note, list_classes, get_class, create_class, update_class, enroll_member, unenroll_member, list_rooms, list_teachers, list_attendance, mark_attendance, list_invoices, get_invoice, create_invoice, send_invoice, mark_invoice_paid, delete_invoice, list_invoice_categories, list_auto_invoices, send_email, send_sms, list_messages, list_automations, get_automation, enable_automation, disable_automation.

Cursor

{
   "mcpServers" : {
      "users-solutions" : {
         "headers" : {
            "Authorization" : "Bearer us_YOUR_API_KEY"
         },
         "url" : "https://users.solutions/mcp"
      }
   }
}

Claude Code

claude mcp add --transport http users-solutions https://users.solutions/mcp --header "Authorization: Bearer us_YOUR_API_KEY"

Syntax: Claude Code MCP documentation.

Claude Desktop

Using the mcp-remote stdio bridge:

{
   "mcpServers" : {
      "users-solutions" : {
         "args" : [
            "-y",
            "mcp-remote",
            "https://users.solutions/mcp",
            "--header",
            "Authorization: Bearer us_YOUR_API_KEY"
         ],
         "command" : "npx"
      }
   }
}

To connect from ChatGPT or claude.ai, add this MCP URL as a custom connector, then sign in to approve access. OAuth does not require an API key.