Zenamu MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.2.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted Zenamu connector that lets an assistant read a studio's class and workshop schedule, lecturers, places and client balances, and grant passes or credits.

What you can do
  • List classes and course sessions for a date range, including canceled events, times, pricing and capacity
  • List public workshops with their own addresses and pricing
  • List lecturers with name, photo and bio, and physical places with name and address
  • List active clients with contact details, credit and entry-pass balances, make-up sessions and booking totals
  • List entry-pass groups, active and archived
  • Grant credits or entry passes to a client's account and return the new balance
When to use it
Useful for studio owners or staff who want to ask an assistant about upcoming classes, workshops, who teaches them, and which clients have low pass balances, or to top up a client's credits or passes from a chat.
Requirements
Remote MCP endpoint, no local install. Sign-in is via OAuth; on first connect you supply your Zenamu public API key and secret API key, which the server stores per user. Client records and pass groups require the secret key and the Ultimate plan. Free tier allows 50 tool calls per month; paid plans raise the limit.
Before you install
Client listing returns personal data, and the grant tools write to client accounts and are not idempotent, so a retry after an unclear failure can grant twice; check balances first. Granting with sendEmail emails the client. The secret API key is a sensitive credential. Paid plans are billed through a checkout link, and cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

  1. Open Zenamu MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fzenamu/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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.

Source: servers/zenamu/README.md at commit 4046075

Tools

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.

ParameterslimitdateTorequiredoffsetdateFromrequiredlabelIdsplaceIdslecturerIdsincludeCapacity

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.

ParameterslimitdateTorequiredoffsetdateFromrequiredlabelIdslecturerIdsincludeCapacity

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.

ParametersincludeInactive

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.

Takes no parameters.

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.

Takes no parameters.

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.

Takes no parameters.

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.

ParameterscountrequiredpricerequiredclientIdrequiredcurrencyrequiredsendEmailrequiredvalidityTimeUnitrequiredvalidityTimeValuerequired

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.

ParameterscountrequiredpricerequiredclientIdrequiredcurrencyrequiredsendEmailrequiredpassGroupIdvalidityTimeUnitrequiredvalidityTimeValuerequired

Version history

6
  1. v1.2.4LatestNov 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

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations