{"id":"com.nisebookings/booking","slug":"com-nisebookings-booking","title":"nisebookings","description":"Operate a nisebookings account: catalogue, staff schedules, free slots, customers, appointments","version":"1.0.0","publisher":{"kind":"domain","id":"nisebookings.com","label":"nisebookings.com","url":"https://nisebookings.com"},"website":"https://guide.nisebookings.com/api/mcp.html","repository":"","remotes":[{"type":"streamable-http","url":"https://app.nisebookings.com/api/mcp","headers":[{"description":"Management API key from Settings → API in the nisebookings admin, sent as a bearer token","isRequired":true,"value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"nisebookings API key (nk_…), shown once when created","isRequired":true,"isSecret":true}},"name":"Authorization"}]}],"packages":[],"published":"2026-10-13","updated":"2026-10-13","status":"online","auth":"","latency_ms":1370,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"whoami","title":"Who am I","description":"The tenant (id, name, timeZone, currency), the scopes of the API key in use and the plan (id, label, bookingsPerMonth, usedThisMonth, level ok|warn|full). Works with any valid key. Call first to learn which tools your key may use and, when writing fails with 402 plan_limit, what the account's plan allows.","read_only":true},{"name":"create_project","title":"Create a client project","description":"Create a new account (project) for a client, owned by this account's first owner — the agency case: one login or key configures several client sites. The new account starts on Free; the allowance is the highest `projects` among the plans of the accounts that owner owns (Free/Pro 1, Agency 5, € 9 per extra project), so 402 plan_limit when it is full and 409 when the slug is taken. Give the client a","read_only":false},{"name":"list_services","title":"List services","description":"All services of the tenant (simple, compound, collaborative, package), ordered by position. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"get_service","title":"Get service","description":"One service by id. Scope catalog:read.","read_only":true},{"name":"create_service","title":"Create service","description":"Create a service; missing fields get admin defaults (type simple, duration 60, deposit 100%, taxRate 21). `type` cannot change later. A service is bookable once visibility is public and a public staff member with a schedule offers it (assign_staff_service). Scope catalog:write.","read_only":false},{"name":"update_service","title":"Update service","description":"Partial update: send only the fields that change (merged over current values). `type` is fixed. Scope catalog:write.","read_only":false},{"name":"list_categories","title":"List categories","description":"Service categories, ordered by position. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"list_staff","title":"List staff","description":"All staff members, including archived ones (visibility = archive). Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"get_staff","title":"Get staff member","description":"One staff member by id. Scope catalog:read.","read_only":true},{"name":"create_staff","title":"Create staff member","description":"Create a staff member; the weekly schedule starts as a copy of the business hours. Link services with assign_staff_service afterwards. Scope catalog:write.","read_only":false},{"name":"update_staff","title":"Update staff member","description":"Partial update of a staff member. visibility \"archive\" hides them (staff are never deleted). Scope catalog:write.","read_only":false},{"name":"get_staff_schedule","title":"Get staff schedule","description":"Weekly working hours of a staff member: {days: [{weekday 1=Mon…7=Sun, start, end, breaks}]}. A missing weekday is a day off. Scope catalog:read.","read_only":true},{"name":"set_staff_schedule","title":"Replace staff schedule","description":"Replace the WHOLE week of a staff member (not a merge): send every working day; a missing weekday becomes a day off. end > start, breaks inside the day and not overlapping. Read it first with get_staff_schedule. Scope catalog:write.","read_only":false},{"name":"list_staff_services","title":"List services of a staff member","description":"Services this staff member offers, with per-link price, capacityMin/Max and deposit. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"assign_staff_service","title":"Assign service to staff member","description":"Let a staff member offer a service (create or update the link). Missing fields keep current link values, or for a new link the service price/capacity and deposit null (= service deposit). Required before a staff member can be booked for the service. Scope catalog:write.","read_only":false},{"name":"unassign_staff_service","title":"Unassign service from staff member","description":"Stop a staff member offering a service. Existing appointments stay. Scope catalog:write.","read_only":false},{"name":"get_business_hours","title":"Get business hours","description":"Company opening hours {days: [{weekday 1=Mon…7=Sun, start, end}]}; a missing weekday = closed. New staff copy these. Scope settings:read.","read_only":true},{"name":"set_business_hours","title":"Replace business hours","description":"Replace ALL business hours (not a merge): one entry per open weekday, no breaks; a missing weekday = closed. Does not change existing staff schedules. Scope settings:write.","read_only":false},{"name":"list_holidays","title":"List days off","description":"Days off. staffId filters: a staff id, or \"company\" for company-wide days; omit for all. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"add_holiday","title":"Add day off","description":"Add a day off. kind: once | yearly (same date every year) | exception (a working day despite company days off). staffId null/omitted = company-wide. Scope catalog:write.","read_only":false},{"name":"delete_holiday","title":"Delete day off","description":"Remove a day off by id (from list_holidays). Scope catalog:write.","read_only":false},{"name":"get_settings","title":"Get settings","description":"All admin-editable tenant settings, plus read-only id, publicKey (for the widget / public API) and currency. Scope settings:read.","read_only":true},{"name":"update_settings","title":"Update settings","description":"Partial update: only fields present are validated and written; returns all settings. id, publicKey and currency are read-only. The Mollie key is set via api_request PUT /settings/mollie-key {key} (scope payments:write) before payMollieEnabled: true. Scope settings:write.","read_only":false},{"name":"list_customers","title":"List customers","description":"Customers, optionally searched with q (name, e-mail or phone). Scope customers:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"get_customer","title":"Get customer","description":"One customer by id. Scope customers:read.","read_only":true},{"name":"create_customer","title":"Create customer","description":"Create a customer. email is unique per tenant: 409 when it exists, so search with list_customers first. Scope customers:write.","read_only":false},{"name":"update_customer","title":"Update customer","description":"Partial update of a customer. Scope customers:write.","read_only":false},{"name":"list_appointments","title":"List appointments","description":"The calendar: appointments with their bookings and customers. Filter by from/to (ISO date-times; start ≥ from, < to), staffId, serviceId, status (appointments having a booking in that status). Scope bookings:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"get_appointment","title":"Get appointment","description":"One appointment with bookings (bookingId, status, persons), customers, extras, series/group ids and meetingUrl. Scope bookings:read.","read_only":true},{"name":"create_appointment","title":"Create appointment","description":"Book like the admin: one appointment with one booking. Give customerId or customer {name, email, phone}. Without end the service duration is used; without status the tenant default. A day service (rental, durationDays > 0) starts at the local midnight (00:00) and without end spans its number of days. The staff member must offer the service. Admin checks (overlap, duration, schedule, holiday) retur","read_only":false},{"name":"update_appointment","title":"Reschedule / update appointment","description":"Move or change an appointment: send only what changes (start, end, staffId, serviceId, internalNote). start without end keeps the service duration (for a day service: its number of days); besides, a day service starts at the local midnight (00:00). scope following|series shifts later/all appointments of a recurring series (response seriesMoved). Warnings → 422 code \"warnings\" unless force: true. D","read_only":false},{"name":"delete_appointment","title":"Delete appointment","description":"Delete an appointment and its bookings. notify: true first sets approved bookings to cancelled and pending ones to rejected and mails the customers. To cancel but keep the record, use update_booking status cancelled instead. scope this|following|series for recurring series. Scope bookings:write.","read_only":false},{"name":"add_customer_to_appointment","title":"Add customer to appointment","description":"Add another booking (customer) to an existing group appointment. Give customerId or customer {name, email, phone}. 409 capacity_exceeded when it does not fit. Response includes the new bookingId. Scope bookings:write.","read_only":false},{"name":"update_booking","title":"Update booking status","description":"Change a booking's status (approve, cancel, reject, done…) and/or persons. id is the bookingId (from create_appointment or get_appointment), not the appointment id. The status also applies to other parts of the same compound/collaborative group; scope following|series applies it to a recurring series. Response {id, changed, failed, reason}: id is the booking you patched — a 200 without an error me","read_only":false},{"name":"find_slots","title":"Find free slots","description":"Bookable times for a service, day by day, exactly as the booking widget sees them (respects schedules, days off, existing bookings, capacity, minimum notice and booking horizon). Returns {days: [{date, slots: [{start, time, staffId, state?}]}], hasMore}; days without free times are omitted. Pass a slot's start and staffId to create_appointment. state \"waitlist\" = full, waiting list open. Works wit","read_only":true},{"name":"list_payments","title":"List payments","description":"Payments, newest first. Filters: status (pending|completed|rejected|refunded), type (local|free|mollie), customerId. Scope payments:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"get_payment","title":"Get payment","description":"One payment with its items and bookings. Mark a local payment paid / refund it via api_request POST /payments/{id}/complete or /refund (payments:write). Scope payments:read.","read_only":true},{"name":"list_outbox","title":"List sent e-mails","description":"The e-mail log, newest first: what was sent or queued (id, status, toEmail, toName, subject, text, html, createdAt, sentAt, lastError). On a sandbox nothing is delivered: rows end as status \"suppressed\", read them here to verify confirmations. Filters: status (pending|sending|sent|failed|suppressed), to (exact address, case-insensitive). Scope settings:read. Paginated: limit ≤ 100 (default 50), of","read_only":true},{"name":"list_events","title":"List events","description":"Ticketed events ordered by startAt. Ticket types, attendees and event staff are under /events/{id}/… via api_request. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"list_coupons","title":"List coupons","description":"Coupons (discount codes) ordered by code. Scope catalog:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"generate_coupons","title":"Generate coupons","description":"Create up to 100 unique coupon codes from a mask: every * becomes one of 0-9A-Z (e.g. \"SUMMER-****\"). The other fields are the template for each coupon; discount (percent) or deduction must be > 0. 422 on mask when it is used up. Returns {data: coupons}. Single coupons: api_request POST /coupons. Scope catalog:write.","read_only":false},{"name":"list_webhooks","title":"List webhook endpoints","description":"Webhook endpoints (id, url, events, active, description, createdAt, updatedAt); the secret is never returned. Event types with descriptions: api_request GET /webhooks/events. Scope settings:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"create_webhook","title":"Create webhook endpoint","description":"Register a URL that receives signed POSTs (Standard Webhooks: webhook-id, webhook-timestamp, webhook-signature \"v1,<base64 HMAC-SHA256>\" over \"id.timestamp.body\" keyed with the base64 part of the secret after whsec_). Payloads are thin ({id, type, createdAt, tenantId, data: ids + status, previousStatus, start}): fetch details via the API. url must be public https (private/loopback addresses are re","read_only":false},{"name":"delete_webhook","title":"Delete webhook endpoint","description":"Delete an endpoint and its delivery log. To pause instead: api_request PATCH /webhooks/{id} {active: false}. New secret: POST /webhooks/{id}/rotate-secret. Scope settings:write.","read_only":false},{"name":"test_webhook","title":"Send test webhook","description":"Queue a `ping` event ({type: \"ping\", data: {endpointId}}) to the endpoint and send it right away. Returns the delivery (202); check the outcome (status delivered/pending, lastStatus, lastError) with list_webhook_deliveries a second later. Scope settings:write.","read_only":false},{"name":"list_webhook_deliveries","title":"List webhook deliveries","description":"Delivery log of one endpoint, newest first: id, eventId, type, status (pending|sending|delivered|failed), attempts, nextAttemptAt, lastStatus (HTTP), lastError, createdAt, deliveredAt, payload. Resend one: api_request POST /webhooks/{id}/deliveries/{deliveryId}/retry. Scope settings:read. Paginated: limit ≤ 100 (default 50), offset; returns {data, total}.","read_only":true},{"name":"api_request","title":"Raw management API request","description":"Any /api/v1 management API call not covered by a dedicated tool. path is relative to /api/v1 (e.g. \"/services/<uuid>/extras\"), ids in place of {…}; put query parameters in query, the JSON body in body (camelCase). Same scopes and errors as the API: {error: {code, message, fields}}. Lists take limit ≤ 100 / offset and return {data, total}. Not for /public/ (use find_slots). Routes:\nGET /me\nGET POST","read_only":false}],"server_info":{"name":"nise-booking","version":"1.0.0"},"category":"support","tags":["automation","finance","health"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-13","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-nisebookings-booking/"}