# BailaYa MCP by usefulapi

> BailaYa MCP by usefulapi is a freemium MCP server for productivity. Hosted connector to manage dance studio classes, events and students in BailaYa. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API
- **Website:** https://usefulapi.io/bailaya/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bailaya
- **MCP Registry name:** io.usefulapi/bailaya
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Written for dance studio owners and managers, this server reads a studio's class schedule with date, time, instructor, room and capacity, plus events, students with their level and status, team members, instructors, packages, rooms, locations and dance types. Handy for questions like who teaches on Saturday or which students joined at beginner level this month.

It can also write: create or change a class occurrence, delete one class or a whole series (which cannot be undone), create or update events, and add or update students. A newly created class becomes visible on the studio's booking page.

The API key is created in BailaYa under Settings, API keys, is bound to one studio and starts with `bya_live_`. Granting only the read scopes keeps the assistant from changing data.

## Features

- **Class schedule lookups:** List classes with instructor, room, capacity and open one by id.
- **Student records:** List students and check level and status.
- **Class creation and edits:** Create a class on a date or change its time, instructor, room, capacity or price.
- **Series deletion:** Delete one class or every occurrence of a series.
- **Events and team:** Read and manage events, rooms, instructors and team members.
- **Scoped API keys:** Grant read-only or write scopes per resource.

## Good for

- Check Saturday's classes and teachers
- List active class packages with prices
- Add a beginner salsa class to the booking page
- Review newly joined beginner students
- Plan a workshop around free rooms

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bailaya https://bailaya.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bailaya.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bailaya": {
      "url": "https://bailaya.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bailaya": {
      "type": "http",
      "url": "https://bailaya.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bailaya": {
      "serverUrl": "https://bailaya.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bailaya": {
      "type": "http",
      "url": "https://bailaya.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `bailaya_list_classes`: List the studio's classes (scheduled occurrences) with date, time, instructor, room, capacity and price. Needs scope classes:read. BailaYa API: GET /v1/classes.
- `bailaya_get_class`: Get one class by id. Needs scope classes:read. BailaYa API: GET /v1/classes/{id}.
- `bailaya_list_events`: List the studio's events (workshops and special sessions) with date, time, instructor and capacity. Needs scope events:read. BailaYa API: GET /v1/events.
- `bailaya_get_event`: Get one event by id. Needs scope events:read. BailaYa API: GET /v1/events/{id}.
- `bailaya_list_students`: List the studio's students with name, email, phone, level and status. Personal data: use only when the studio owner asks. Needs scope students:read. BailaYa API: GET /v1/students.
- `bailaya_get_student`: Get one student by id. Personal data. Needs scope students:read. BailaYa API: GET /v1/students/{id}.
- `bailaya_list_team_members`: List studio team members (staff, instructors, owners, admins), optionally filtered by role. Needs scope team:read. BailaYa API: GET /v1/team.
- `bailaya_get_team_member`: Get one team member by id. Needs scope team:read. BailaYa API: GET /v1/team/{id}.
- `bailaya_list_instructors`: List the studio's instructors. Needs scope instructors:read. BailaYa API: GET /v1/instructors.
- `bailaya_get_instructor`: Get one instructor by id. Needs scope instructors:read. BailaYa API: GET /v1/instructors/{id}.
- `bailaya_list_packages`: List class packages (pre-paid bundles of sessions) with price, sessions and validity. Set is_active to filter. Needs scope packages:read. BailaYa API: GET /v1/packages.
- `bailaya_get_package`: Get one class package by id. Needs scope packages:read. BailaYa API: GET /v1/packages/{id}.
- `bailaya_list_rooms`: List the studio's rooms with capacity and location. Needs scope rooms:read. BailaYa API: GET /v1/rooms.
- `bailaya_get_room`: Get one room by id. Needs scope rooms:read. BailaYa API: GET /v1/rooms/{id}.
- `bailaya_list_locations`: List the studio's locations (primary first). The API is not paginated: every location is returned. Needs scope locations:read. BailaYa API: GET /v1/locations.
- `bailaya_get_location`: Get one location by id. Needs scope locations:read. BailaYa API: GET /v1/locations/{id}.
- `bailaya_list_dance_types`: List the studio's dance types (studio types) used to tag classes. Includes types hidden from the website. Needs scope classes:read. BailaYa API: GET /v1/studio-types.
- `bailaya_create_class`: Create ONE class occurrence on a date. Visible on the studio's booking page. Needs scope classes:write. BailaYa API: POST /v1/classes.
- `bailaya_update_class`: Change fields of one class (time, instructor, room, capacity, price). Only the fields you pass change. Needs scope classes:write. BailaYa API: PATCH /v1/classes/{id}.
- `bailaya_delete_class`: Delete (cancel) one class. Set apply_to_series to true to delete every occurrence of a repeating series. Irreversible. Needs scope classes:delete. BailaYa API: DELETE /v1/classes/{id}.
- `bailaya_create_event`: Create ONE event (workshop or special session) on a date. Visible on the studio's booking page. Needs scope events:write. BailaYa API: POST /v1/events.
- `bailaya_update_event`: Change fields of one event (time, host, room, capacity, price). Only the fields you pass change. Needs scope events:write. BailaYa API: PATCH /v1/events/{id}.
- `bailaya_create_student`: Add ONE student record to the studio. Personal data. Needs scope students:write. BailaYa API: POST /v1/students.
- `bailaya_update_student`: Change fields of one student record (contact details, level, status). Only the fields you pass change. Personal data. Needs scope students:write. BailaYa API: PATCH /v1/students/{id}.

## FAQ

### Can the assistant delete classes?

Yes, if the API key has write scopes. The site warns that a delete cannot be undone.

### Can I make it read-only?

Yes. Give the BailaYa key only the read scopes, such as classes:read and students:read.

### Is one key valid for several studios?

No, each key is bound to a single studio.

### What does a new class do?

It becomes visible on the studio's booking page.

### Is BailaYa MCP by usefulapi free?

BailaYa MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add BailaYa MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http bailaya https://bailaya.usefulapi.io/mcp

### What are the best alternatives to BailaYa MCP by usefulapi?

The closest alternatives to BailaYa MCP by usefulapi are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/bailaya-mcp-by-usefulapi
