Setora MCP by usefulapi

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

Read locations, slots and bookings; create clients, book, move and cancel in Setora.

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

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

概覽

AI 產生的概覽

把助理連接到 Setora 預約帳號,可查看門市、服務、人員與空檔時段,並建立、改期或取消預約。

可以做什麼
  • 列出門市、服務與人員,包含價格、訂金以及每位人員可提供的服務
  • 依起始日期查詢一項或多項服務的可預約時段
  • 依電話或電子郵件尋找客戶,並依編號讀取單筆預約
  • 建立客戶與預約,需要訂金時回傳付款連結
  • 依門市取消政策改期或取消預約
  • 查看當月用量、提出功能需求,並管理 Pro 訂閱
適用情境
適合在 Setora 管理預約的情境:讓助理回答關於空檔時段、客戶與預約的問題,或代為建立、改期與取消預約,不必開啟 Setora 後台。
執行需求
遠端託管端點,免本機安裝。透過 OAuth 登入,首次連線時需輸入 Setora Hub 設定中的 Setora API 金鑰;寫入類工具需要 read_write 金鑰。金鑰不會寫進用戶端設定檔。
安裝前請注意
寫入類工具會建立客戶,並建立、改期或取消預約;取消無法復原,訂金是否退還依門市政策而定。需要訂金的預約會停在 pending_payment,須透過回傳的付款連結付款。伺服器會依使用者儲存你的 Setora API 金鑰。付費方案透過 Stripe 結帳連結付款,免費方案每月上限 50 次呼叫。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

README

Setora MCP by usefulapi

Use your Setora account from Claude, Cursor, or any MCP client. Look up locations, services, staff, open slots, clients and bookings. Also create clients and create, move or cancel bookings with a read_write key. Hosted, no local install: connect with your own credentials.

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

Connect

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

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

On first connect you enter a Setora API key (Setora Hub → Settings → Developer; a read_write key is needed to change bookings). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
setora_list_locationsreadList locations
setora_list_servicesreadList services at a location
setora_list_staffreadList staff at a location
setora_get_availabilityreadGet availability
setora_lookup_clientreadLook up a client
setora_get_bookingreadGet a booking
setora_create_clientwriteCreate a client
setora_create_bookingwriteCreate a booking
setora_reschedule_bookingwriteReschedule a booking
setora_cancel_bookingwriteCancel a booking
setora_usage_statusmetaUsage status (free-tier meter)
setora_request_featuremetaRequest a missing feature
setora_upgrademetaUpgrade to Pro or Pro+
setora_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 setora_upgrade (it returns a Stripe Checkout link). Cancel any time with setora_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running setora_upgrade before then undoes the cancel. Or write to [email protected].

License

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

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

工具

10

setora_list_locations

List locations

List the active locations (shops) of the Setora organisation: slug, name, timezone, address, phone and the Booking Protection policy. Start here: the slug is needed by most other tools.

輸入參數cursor

setora_list_services

List services at a location

List the services bookable at a location with price and deposit (in minor units, for example pence), duration, category and the staff who can deliver each service.

輸入參數cursorlocation_slug必填

setora_list_staff

List staff at a location

List the active staff at a location. Each staff member shows the ids of the services they deliver.

輸入參數cursorlocation_slug必填

setora_get_availability

Get availability

Get bookable time slots for one or more services at a location, from a local date forward. Slots use the location's local time with a UTC offset. Use a slot's starts_at as-is in setora_create_booking.

輸入參數date必填daysstaff_idservice_ids必填location_slug必填

setora_lookup_client

Look up a client

Find a client by phone (E.164, for example +447700900123) or by email. Give at least one. Returns 404 when no client matches.

輸入參數emailphone

setora_get_booking

Get a booking

Get one booking by reference: status, services, staff, client, times and Booking Protection state.

輸入參數reference必填

setora_create_client

Create a client

WRITE: create a client (first and last name, and a phone or an email). If the phone or email already exists, Setora returns the existing client and creates no duplicate. Needs a read_write key.

輸入參數emailphonelast_name必填first_name必填marketing_consent

setora_create_booking

Create a booking

WRITE: create a booking for a client. starts_at must be a slot from setora_get_availability. If the service needs a deposit, the booking stays in pending_payment and the result has a payment_url. Locations with Booking Protection return 409 booking_protection_required: use the Setora booking page there. Needs a read_write key. To retry after a network error, pass the same idempotency_key.

輸入參數notesstaff_idclient_id必填starts_at必填service_ids必填location_slug必填idempotency_key

setora_reschedule_booking

Reschedule a booking

WRITE: move a booking to a new slot of the same service and location, and optionally to another eligible staff member. The shop's cancellation policy window applies (409 if it blocks the change). Needs a read_write key.

輸入參數staff_idreference必填starts_at必填

setora_cancel_booking

Cancel a booking

WRITE: cancel a booking. The shop's cancellation policy decides if a deposit is refunded (see deposit_refunded in the result). This cannot be undone. Needs a read_write key.

輸入參數reasonreference必填

版本歷史

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 整合