Zenamu MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.2.4更新於 Nov 7, 2026

List classes, workshops and clients; grant passes or credits to clients in Zenamu.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

託管式 Zenamu 連接器,讓助理讀取工作室的課程與工作坊安排、講師、場地與客戶餘額,並發放通行證或額度。

可以做什麼
  • 依日期範圍列出課程與課程場次,含已取消活動、時間、價格與名額
  • 列出公開工作坊及其各自的地址與價格
  • 列出講師(姓名、照片、簡介)與實體場地(名稱與地址)
  • 列出使用中客戶,含聯絡資料、額度與入場通行證餘額、補課次數與預約總數
  • 列出入場通行證群組,含啟用與封存
  • 對某位客戶帳戶發放額度或入場通行證,並回傳新餘額
適用情境
適合工作室經營者或員工向助理詢問近期課程、工作坊、授課講師,以及哪些客戶通行證餘額偏低,或在對話中為客戶補充額度或通行證。
執行需求
遠端 MCP 端點,無需本機安裝。透過 OAuth 登入;首次連線需提供 Zenamu 公開 API 金鑰與私密 API 金鑰,伺服器依使用者儲存。客戶清單與通行證群組需要私密金鑰與 Ultimate 方案。免費版每月 50 次工具呼叫,付費方案可提高上限。
安裝前請注意
客戶清單會回傳個人資料;發放類工具會寫入客戶帳戶且不具冪等性,失敗後重試可能重複發放,應先核對餘額。發放時啟用 sendEmail 會寄信給客戶。私密 API 金鑰屬敏感憑證。付費方案透過結帳連結付款,取消後服務持續到已付週期結束,當期不退款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Zenamu MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fzenamu/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

Zenamu MCP by usefulapi

Use your Zenamu account from Claude, Cursor, or any MCP client. Read the class schedule, workshops, clients and pass balances, and grant passes or credits. Hosted, no local install: connect with your own credentials.

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://zenamu.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http zenamu https://zenamu.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": {    "zenamu": {      "url": "https://zenamu.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 Zenamu credentials.

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

On first connect you provide your public API key (zen_pub_…) and your secret API key (zen_live_…). Find both in Zenamu admin under Settings → General info → API keys. The server validates them and stores them per user. No keys go in config files.

Tools

ToolTypeWhat it does
zenamu_list_classesreadList classes
zenamu_list_workshopsreadList workshops
zenamu_list_lecturersreadList lecturers
zenamu_list_placesreadList places
zenamu_list_clientsreadList clients
zenamu_list_pass_groupsreadList pass groups
zenamu_grant_creditswriteGrant credits to a client
zenamu_grant_passeswriteGrant entry passes to a client
zenamu_usage_statusmetaUsage status (free-tier meter)
zenamu_request_featuremetaRequest a missing feature
zenamu_upgrademetaUpgrade to Pro or Pro+
zenamu_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 zenamu_upgrade (it returns a Stripe Checkout link). Cancel any time with zenamu_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running zenamu_upgrade before then undoes the cancel. Or write to [email protected].

License

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

來源:servers/zenamu/README.md,提交 4046075

工具

8

zenamu_list_classes

List classes

List the published schedule of the studio for a date range (YYYY-MM-DD, studio time zone, max 366 days). Returns classes and course sessions (read eventType), with times, lecturerIds, locationId, pricing options and seat capacity when requested. Canceled events are included with isCanceled=true. Zenamu API: GET /v1/classes.

輸入參數limitdateTo必填offsetdateFrom必填labelIdsplaceIdslecturerIdsincludeCapacity

zenamu_list_workshops

List workshops

List the studio's public workshops (standalone events such as retreats and intensives) for a date range (YYYY-MM-DD, max 366 days). Each workshop has its own address and pricing. Canceled workshops are excluded. Zenamu API: GET /v1/workshops.

輸入參數limitdateTo必填offsetdateFrom必填labelIdslecturerIdsincludeCapacity

zenamu_list_lecturers

List lecturers

List the studio's lecturers with name, photo and bio. Use it to turn the lecturerIds from classes and workshops into names. Contact details are never returned. Zenamu API: GET /v1/lecturers.

輸入參數includeInactive

zenamu_list_places

List places

List the studio's physical locations with name and address. Use it to turn the locationId from classes into an address. Archived places are excluded. Zenamu API: GET /v1/places.

無需輸入參數。

zenamu_list_clients

List clients

List every active client of the studio with contact details, credit and entry-pass balances, pass balances per pass group, make-up sessions and booking totals. Returns personal data. Needs the secret key and the Ultimate plan. Archived and blocked clients are excluded. Zenamu API: GET /v1/clients.

無需輸入參數。

zenamu_list_pass_groups

List pass groups

List the studio's entry-pass groups (active and archived) with their id, name and state. Use an id as passGroupId when granting passes. Needs the secret key and the Ultimate plan. Zenamu API: GET /v1/pass-groups.

無需輸入參數。

zenamu_grant_credits

Grant credits to a client

WRITE: adds credits to one client's account and returns the new balance. Changes what the client owes or holds. Not idempotent: a retry after an unclear failure can grant twice, so check the balance first with zenamu_list_clients. sendEmail=true emails the client. Zenamu API: POST /v1/clients/{clientId}/credits.

輸入參數count必填price必填clientId必填currency必填sendEmail必填validityTimeUnit必填validityTimeValue必填

zenamu_grant_passes

Grant entry passes to a client

WRITE: adds entry passes to one client's account in a pass group and returns the new balance in that group. Changes what the client holds. Not idempotent: a retry after an unclear failure can grant twice, so check the balance first with zenamu_list_clients. Omit passGroupId for the studio's default group. sendEmail=true emails the client. Zenamu API: POST /v1/clients/{clientId}/passes.

輸入參數count必填price必填clientId必填currency必填sendEmail必填passGroupIdvalidityTimeUnit必填validityTimeValue必填

版本歷史

6
  1. v1.2.4最新Nov 7, 2026
  2. v1.1.3Nov 5, 2026
  3. v1.1.2Nov 5, 2026
  4. v1.1.1Nov 4, 2026
  5. v1.1.0Nov 3, 2026
  6. v1.0.1Nov 3, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合