BailaYa MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.3.4更新于 Nov 7, 2026

Read schedules, students and packages; add or change classes, events and students in BailaYa.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

面向 BailaYa 舞蹈工作室的托管 MCP 服务器:读取课程、学员、套餐与团队信息,并新增或修改课程、活动与学员。

可以做什么
  • 列出并查询课程、活动、舞种、教室与地点
  • 列出并查询学员、团队成员与教练
  • 列出并查询课程套餐的价格、课时与有效期
  • 创建、修改和删除单次课程,可一并删除整个重复系列
  • 创建和修改活动与学员记录
  • 查看当月用量、提交功能请求、升级或取消付费方案
适用场景
适合舞蹈工作室的经营者或员工,让助手在聊天客户端中回答排课、套餐、教室和学员相关问题,或新增与调整课程、活动和学员记录。
运行要求
仅需以 URL 连接远程端点,无需本地安装。通过 OAuth 登录,首次连接时需提供 BailaYa 工作室 API 密钥(以 bya_live_ 开头,可在 BailaYa 设置中获取),密钥不写入客户端配置。免费方案每月 50 次工具调用。
安装前请注意
写入类工具会创建、修改和删除工作室数据;删除课程时可将重复系列的全部场次一并删除,且不可恢复。学员相关工具涉及个人数据(姓名、邮箱、电话),应仅在工作室负责人要求时使用。服务器会按用户保存你的 BailaYa API 密钥。付费方案需付费,通过 Stripe 结账链接订阅,取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BailaYa MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fbailaya/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

BailaYa MCP by usefulapi

Use your BailaYa account from Claude, Cursor, or any MCP client. Read the schedule, students, team and packages of your dance studio, and add or change classes, events and students. Hosted, no local install: connect with your own credentials.

Live endpoint: https://bailaya.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://bailaya.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http bailaya https://bailaya.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "bailaya": {      "url": "https://bailaya.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your BailaYa credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bailaya/

On first connect you provide a BailaYa studio API key (BailaYa → Settings → API keys; it starts with bya_live_). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
bailaya_list_classesreadList classes
bailaya_get_classreadGet a class
bailaya_list_eventsreadList events
bailaya_get_eventreadGet an event
bailaya_list_studentsreadList students
bailaya_get_studentreadGet a student
bailaya_list_team_membersreadList team members
bailaya_get_team_memberreadGet a team member
bailaya_list_instructorsreadList instructors
bailaya_get_instructorreadGet an instructor
bailaya_list_packagesreadList class packages
bailaya_get_packagereadGet a class package
bailaya_list_roomsreadList rooms
bailaya_get_roomreadGet a room
bailaya_list_locationsreadList locations
bailaya_get_locationreadGet a location
bailaya_list_dance_typesreadList dance types
bailaya_create_classwriteCreate a class
bailaya_update_classwriteUpdate a class
bailaya_delete_classwriteDelete a class
bailaya_create_eventwriteCreate an event
bailaya_update_eventwriteUpdate an event
bailaya_create_studentwriteCreate a student
bailaya_update_studentwriteUpdate a student
bailaya_usage_statusmetaUsage status (free-tier meter)
bailaya_request_featuremetaRequest a missing feature
bailaya_upgrademetaUpgrade to Pro or Pro+
bailaya_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with bailaya_upgrade (it returns a Stripe Checkout link). Cancel any time with bailaya_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bailaya_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/bailaya/README.md,提交 4046075

工具

24

bailaya_list_classes

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.

输入参数limitoffset

bailaya_get_class

Get a class

Get one class by id. Needs scope classes:read. BailaYa API: GET /v1/classes/{id}.

输入参数id必填

bailaya_list_events

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.

输入参数limitoffset

bailaya_get_event

Get an event

Get one event by id. Needs scope events:read. BailaYa API: GET /v1/events/{id}.

输入参数id必填

bailaya_list_students

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.

输入参数limitoffset

bailaya_get_student

Get a student

Get one student by id. Personal data. Needs scope students:read. BailaYa API: GET /v1/students/{id}.

输入参数id必填

bailaya_list_team_members

List team members

List studio team members (staff, instructors, owners, admins), optionally filtered by role. Needs scope team:read. BailaYa API: GET /v1/team.

输入参数rolelimitoffset

bailaya_get_team_member

Get a team member

Get one team member by id. Needs scope team:read. BailaYa API: GET /v1/team/{id}.

输入参数id必填

bailaya_list_instructors

List instructors

List the studio's instructors. Needs scope instructors:read. BailaYa API: GET /v1/instructors.

输入参数limitoffset

bailaya_get_instructor

Get an instructor

Get one instructor by id. Needs scope instructors:read. BailaYa API: GET /v1/instructors/{id}.

输入参数id必填

bailaya_list_packages

List class 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.

输入参数limitoffsetis_active

bailaya_get_package

Get a class package

Get one class package by id. Needs scope packages:read. BailaYa API: GET /v1/packages/{id}.

输入参数id必填

bailaya_list_rooms

List rooms

List the studio's rooms with capacity and location. Needs scope rooms:read. BailaYa API: GET /v1/rooms.

输入参数limitoffset

bailaya_get_room

Get a room

Get one room by id. Needs scope rooms:read. BailaYa API: GET /v1/rooms/{id}.

输入参数id必填

bailaya_list_locations

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 a location

Get one location by id. Needs scope locations:read. BailaYa API: GET /v1/locations/{id}.

输入参数id必填

bailaya_list_dance_types

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.

输入参数limitoffset

bailaya_create_class

Create a class

Create ONE class occurrence on a date. Visible on the studio's booking page. Needs scope classes:write. BailaYa API: POST /v1/classes.

输入参数date必填name必填level必填priceroom_idcapacityend_time必填locationdiscipline必填is_virtualstart_time必填description另有 6 个

bailaya_update_class

Update a 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}.

输入参数id必填namelevelpriceroom_idcapacityend_timelocationdisciplinestart_timedescriptionallow_packages另有 3 个

bailaya_delete_class

Delete a 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}.

输入参数id必填apply_to_series

bailaya_create_event

Create an 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.

输入参数date必填name必填level必填priceroom_idcapacityend_time必填locationdiscipline必填is_virtualstart_time必填description另有 6 个

bailaya_update_event

Update an 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}.

输入参数id必填namelevelpriceroom_idcapacityend_timelocationdisciplinestart_timedescriptionallow_packages另有 3 个

bailaya_create_student

Create a student

Add ONE student record to the studio. Personal data. Needs scope students:write. BailaYa API: POST /v1/students.

输入参数name必填email必填level必填phonestatuslastname必填

bailaya_update_student

Update a 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}.

输入参数id必填nameemaillevelphonestatuslastname

版本历史

7
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成