Every tool the Memberhaus MCP server exposes, with inputs, output shapes and the scope and permission each one needs. Written for people building prompts, agents and integrations.
POST https://api.memberhaus.com/api/mcp2026-07-28, Streamable HTTP, stateless60 calls per minute per token/.well-known/oauth-protected-resource/api/mcp/.well-known/oauth-authorization-serverevents:read · events:write (implies read) · registrations:read · registrations:write (implies read) · checkin:write · members:read · memberships:read · orders:read · campaigns:read (all standalone)events.view + per sectionread-onlyidempotentOne call for "what needs my attention". Upcoming events and how full they are, approval and waitlist queues, memberships that need action, and unpaid orders. Counts and event names only.
| Field | Type | Notes | |
|---|---|---|---|
days | integer 1-31 | optional | Days ahead for events. Default 7. |
upcomingEvents → events:read / events.view · registrationQueue → registrations:read / registrations.view · memberships → memberships:read / memberships.view · orders → orders:read / finances.view.null and is listed in omitted. reason: "scope": connect again and approve more access. reason: "permission": ask an organization admin.events lists at most 20, soonest first. registrationQueue counts all upcoming events, not only the days window.pending is unconfirmed, usually awaiting payment. It is not an approval.memberships and orders use fixed windows: memberships that end in the next 30 days, and orders from the last 30 days.events_list, registrations_list or members_search.{
"generatedAt": "2026-09-28T08:00:00.000Z",
"days": 7,
"upcomingEvents": {
"total": 3,
"events": [{
"id": "evt_…", "name": "…", "startAt": "…",
"timezone": "Europe/Ljubljana",
"attendeeCount": 24 | null, "maxCapacity": 30 | null
}]
} | null,
"registrationQueue": { "awaitingApproval": 3, "pending": 1, "waitlisted": 12 } | null,
"memberships": { "expiringIn30Days": 5, "pastDue": 2, "pendingApproval": 0, "infoRequested": 1 } | null,
"orders": { "openUnpaidLast30Days": 4, "failedLast30Days": 1 } | null,
"omitted": [{ "section": "orders", "reason": "scope" | "permission" }]
}{ "name": "org_overview", "arguments": { "days": 7 } }analytics.viewread-onlyidempotentHow an event performed, or the whole organization. Counts and event names only.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | optional | Omit for organization-wide top events. |
period | "7d" | "30d" | "90d" | "1y" | "all" | optional | Default 30d. |
{
"period": "30d",
"registrationsByStatus": [{ "status": "confirmed", "count": 88 }],
"attendance": [{ "attendanceStatus": "checked_in", "count": 61 }],
"registrationTimeline": [{ "date": "2026-09-01", "count": 12 }],
"topEvents": [{
"eventId": "evt_…", "eventName": "…",
"startAt": "…" | null, "registrations": 88
}]
}{ "name": "event_insights",
"arguments": { "period": "7d" } }finances.viewread-onlyidempotentMoney totals for a period, for the whole organization. Gross, refunds, Memberhaus platform fees and net, per currency.
| Field | Type | Notes | |
|---|---|---|---|
period | "7d" | "30d" | "90d" | "1y" | "all" | optional | Default 30d. |
orders_list with eventId.orders_list rows.platformFeesCents is the Memberhaus fee, not the payment processor fee.dailyTimeline is empty when the period has more than one currency.{
"period": "30d",
"totalsByCurrency": [{
"currency": "EUR",
"grossCents": 482000, "refundsCents": 9000,
"platformFeesCents": 14460, "netAfterRefundsCents": 473000
}],
"paymentCountsByStatus": [{ "status": "completed", "count": 131 }],
"refundCount": 2,
"dailyTimeline": [{ "date": "2026-09-01", "grossCents": 18000, "payments": 4 }]
}{ "name": "revenue_summary",
"arguments": { "period": "30d" } }events.viewread-onlyidempotentSearch and page through the organization's events.
| Field | Type | Notes | |
|---|---|---|---|
limit | integer 1-100 | optional | Default 20. |
offset | integer | optional | Default 0. |
search | string ≤200 | optional | Case-insensitive name search. |
timeFilter | "upcoming" | "past" | optional | |
visibility | "public" | "unlisted" | "private" | optional | |
locationType | "online" | "offline" | "hybrid" | optional | |
sortBy | "name" | "startAt" | "createdAt" | optional | |
sortOrder | "asc" | "desc" | optional | |
startsAfter | ISO date or date-time | optional | Events that start at or after this time. A bare date is UTC midnight. |
startsBefore | ISO date or date-time | optional | Events that start before this time. |
attendeeCount is sold seats, not people checked in. Use checkin_stats for that.startsAfter and startsBefore filter on the start time. timeFilter filters on the end time.{
"events": [{
"id": "evt_…", "slug": "…", "name": "…",
"visibility": "public" | "unlisted" | "private",
"locationType": "online" | "offline" | "hybrid",
"startAt": "2026-10-03T19:00:00+02:00", "endAt": "…" | null,
"timezone": "Europe/Ljubljana",
"maxCapacity": 30 | null, "attendeeCount": 24 | null,
"isSeries": false
}],
"total": 3, "limit": 20, "offset": 0, "nextOffset": null
}{ "name": "events_list",
"arguments": { "timeFilter": "upcoming", "visibility": "private", "limit": 10 } }events.viewread-onlyidempotentFull detail of one event, including its ticket types.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
attendeeCount is null here. It is populated only by events_list.{
…event summary fields,
"descriptionMarkdown": "## Programme\n\n- 18:00 doors" | null,
"venueName": "…" | null,
"address": "…" | null, "latitude": 46.05 | null, "longitude": 14.5 | null,
"meetingUrl": "…" | null,
"requireApproval": false, "enableWaitlist": true, "showGuestList": false,
"seriesId": "…" | null,
"coverImageUrl": "https://…" | null,
"themePresetId": "aurora" | null,
"ticketTypes": [{ "id": "…", "name": "…", "priceCents": 4500, "currency": "EUR" }],
"createdAt": "…", "updatedAt": "…"
}{ "name": "events_get", "arguments": { "eventId": "evt_abc123" } }events.viewread-onlyidempotentThe upcoming dates of the recurring series that an event belongs to, soonest first.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
isSeries first.events_update or events_delete with scope.{
"data": [{
"id": "evt_…", "slug": "…", "startAt": "…",
"isDetached": false,
"registrationCount": 12, "soldOut": false
}]
}{ "name": "events_series_occurrences",
"arguments": { "eventId": "evt_abc123" } }events.manageread-onlyidempotentFind a venue or an address for an event. Pass the chosen placeId to events_create or events_update, and the server sets the address and the map pin.
| Field | Type | Notes | |
|---|---|---|---|
query | string 2-200 | required | Venue name or address, for example Cankarjev dom, Ljubljana. |
country | ISO 3166-1 alpha-2 | optional | Prefers results in that country. It does not filter them out. |
addressText on the event instead. The event then has no map pin.{
"places": [{
"placeId": "ChIJ…",
"name": "Cankarjev dom",
"formattedAddress": "Prešernova cesta 10, 1000 Ljubljana"
}]
}{ "name": "places_search",
"arguments": { "query": "Cankarjev dom, Ljubljana", "country": "SI" } }events.manageCreate an event, or a recurring series. Same fields as the console form, with a Markdown description, a venue from places_search, a cover image URL and a theme.
| Field | Type | Notes | |
|---|---|---|---|
name | string ≤200 | required | |
locationType | "online" | "offline" | "hybrid" | required | Online and hybrid need meetingUrl. |
startAt | ISO 8601 with offset | required | |
endAt | ISO 8601 with offset | optional | |
timezone | IANA name | required | For example Europe/Ljubljana. |
descriptionMarkdown | string ≤50000 | optional | Markdown: headings (#, ##, ###), bullet and numbered lists, links, bold, italic, ~~strike~~, ++underline++, quotes and code. No images or tables. |
visibility | "public" | "unlisted" | "private" | optional | Default public. |
placeId | string | optional | From places_search. The server sets the address and the map pin. Not with addressText. |
addressText | string ≤500 | optional | For a venue that places_search does not find. No map pin. |
coverImageUrl | https URL | optional | JPEG, PNG, WebP, GIF or AVIF, at most 10 MB. The server downloads it. |
themePresetId | preset id | optional | Animated background, for example aurora, confetti or snow. none shows no animation. |
meetingUrl | URL | optional | |
maxCapacity | integer 1-1000000 | optional | |
requireApproval, enableWaitlist, showGuestList | boolean | optional | |
recurrence | object | optional | freq, interval, byWeekday, monthlyMode, ends. Makes a series. For weekly, byWeekday must include the start weekday. |
ticket_types_create.descriptionMarkdown to the same document the console editor stores. Images and tables return a tool error; use coverImageUrl for the event image.placeId or addressText.{
…event summary fields,
"descriptionMarkdown": "## Programme\n\n- 18:00 doors" | null,
"venueName": "…" | null,
"address": "…" | null, "latitude": 46.05 | null, "longitude": 14.5 | null,
"meetingUrl": "…" | null,
"requireApproval": false, "enableWaitlist": true, "showGuestList": false,
"seriesId": "…" | null,
"coverImageUrl": "https://…" | null,
"themePresetId": "aurora" | null,
"ticketTypes": [{ "id": "…", "name": "…", "priceCents": 4500, "currency": "EUR" }],
"createdAt": "…", "updatedAt": "…"
}{ "name": "events_create",
"arguments": {
"name": "Onboarding Q&A", "locationType": "online",
"startAt": "2026-09-15T18:00:00+02:00", "endAt": "2026-09-15T19:00:00+02:00",
"timezone": "Europe/Ljubljana", "meetingUrl": "https://meet.example.com/x",
"descriptionMarkdown": "## Agenda\n\n- Intro\n- Your questions"
} }events.managedestructiveidempotentChange any subset of fields on an event, or on part of a series.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
scope | "this" | "following" | "all" | optional | Required only when the event belongs to a recurring series. |
…any create field | | optional | All optional except recurrence, which cannot change here. Omitted fields keep their value. |
descriptionMarkdown | string | null | optional | Pass null to clear. |
placeId, addressText | string | null | optional | Pass null to remove the physical location. |
coverImageUrl | https URL | null | optional | Pass null to remove the cover. |
themePresetId | preset id | null | optional | Pass null to reset the theme. |
maxCapacity | integer | null | optional | Pass null to remove the cap. |
scope returns a tool error asking for one.{
…event summary fields,
"descriptionMarkdown": "## Programme\n\n- 18:00 doors" | null,
"venueName": "…" | null,
"address": "…" | null, "latitude": 46.05 | null, "longitude": 14.5 | null,
"meetingUrl": "…" | null,
"requireApproval": false, "enableWaitlist": true, "showGuestList": false,
"seriesId": "…" | null,
"coverImageUrl": "https://…" | null,
"themePresetId": "aurora" | null,
"ticketTypes": [{ "id": "…", "name": "…", "priceCents": 4500, "currency": "EUR" }],
"createdAt": "…", "updatedAt": "…"
}{ "name": "events_update",
"arguments": { "eventId": "evt_abc123", "maxCapacity": 80 } }events.deletedestructiveidempotentCancel an event. A soft cancel: the event stays in the console as cancelled.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
scope | "this" | "following" | "all" | optional | Required only when the event belongs to a recurring series. |
confirm | true | optional | Must be literally true. Ask the user first and wait for a yes. |
destructiveHint. Clients that honour it ask the user before calling. The confirm field covers clients that do not.confirm: true, or the call returns a tool error.{ "id": "evt_abc123", "deleted": true }{ "name": "events_delete",
"arguments": { "eventId": "evt_abc123", "confirm": true } }registrations.viewread-onlyidempotentAttendees of one event, with paging and filters.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
limit | integer 1-100 | optional | Default 20. |
offset | integer | optional | Default 0. |
search | string ≤200 | optional | Attendee name or email. |
status | "pending" | "confirmed" | "cancelled" | "waitlisted" | "rejected" | "awaiting_approval" | optional | |
type | "ticket" | "rsvp" | optional | |
ticketTypeId | string | optional | |
sortBy, sortOrder | string | optional |
registrations_get.{
"registrations": [{
"id": "reg_…", "eventId": "evt_…",
"type": "ticket" | "rsvp", "status": "confirmed",
"attendeeName": "…",
"createdAt": "…", "cancelledAt": "…" | null
}],
"total": 88, "limit": 20, "offset": 0, "nextOffset": 20
}{ "name": "registrations_list",
"arguments": { "eventId": "evt_abc123", "status": "waitlisted" } }registrations.viewread-onlyidempotentOne registration. Contact fields appear only when the caller holds registrations.manage.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
registrationId | string | required | From registrations_list. |
{
…registration summary fields,
"email": "…", // only with registrations.manage
"phone": "…" | null // only with registrations.manage
}{ "name": "registrations_get",
"arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456" } }registrations.managedestructiveidempotentChange one attendee's status. Confirm waitlisted or pending registrations, move back to the waitlist, decline, or cancel.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
registrationId | string | required | From registrations_list. |
status | "pending" | "confirmed" | "cancelled" | "rejected" | "waitlisted" | required | Confirming a waitlisted registration checks capacity first. |
source: mcp.{
…registration summary fields,
"email": "…", // only with registrations.manage
"phone": "…" | null // only with registrations.manage
}{ "name": "registrations_update",
"arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456", "status": "confirmed" } }registrations.canceldestructiveidempotentCancel one registration and free the seat.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
registrationId | string | required | From registrations_list. |
source: mcp.{ "id": "reg_def456", "cancelled": true }{ "name": "registrations_cancel",
"arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456" } }registrations.viewread-onlyidempotentAggregate attendance counts for one event. Live during the event.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
checkin_mark.checkin_walk_in.{
"allGuests": 150, // ticket seats + RSVP-only guests
"going": 32, // confirmed, not yet checked in
"checkedIn": 118,
"notGoing": 4, // guest cancellations
"declined": 2, // organizer-rejected approvals
"pending": 6,
"waitlisted": 12,
"rsvp": 20 // RSVP-only guests
}{ "name": "checkin_stats", "arguments": { "eventId": "evt_abc123" } }checkin.scandestructiveidempotentCheck one attendee in, or undo a check-in. A standalone scope: door devices can hold only check-in power.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
registrationId | string | required | From registrations_list. |
attendanceStatus | "checked_in" | "not_checked_in" | required | checked_in marks arrival. not_checked_in undoes one. |
confirm | true | required | Must be literally true. Ask the user first. |
alreadyInState: true.source: mcp.{
"id": "reg_…", "name": "…",
"displayStatus": "checked_in", "registrationStatus": "confirmed",
"attendanceStatus": "checked_in",
"ticketTypeName": "…" | null, "quantity": 1,
"alreadyInState": false
}{ "name": "checkin_mark",
"arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456", "attendanceStatus": "checked_in", "confirm": true } }checkin.walkIndestructiveRegister someone who arrived without a booking. It creates a confirmed registration, checks the person in and sends a confirmation email.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
ticketTypeId | string | required | From ticket_types_list, for example tkt_abc123. |
quantity | integer ≥1 | required | Seats to register. |
userId | string | optional | An existing member, for example usr_abc123. Send exactly one of userId or email. Prefer email. |
email | email | optional | An unknown email gets an invitation email. |
firstName, lastName | string ≤100 | optional | |
confirm | true | required | Must be literally true. Ask the user first. |
source: mcp.{
"id": "reg_…", "name": "…", "email": "…",
"displayStatus": "checked_in", "registrationStatus": "confirmed",
"attendanceStatus": "checked_in",
"ticketTypeName": "…" | null, "quantity": 1
}{ "name": "checkin_walk_in",
"arguments": { "eventId": "evt_abc123", "ticketTypeId": "tkt_abc123", "quantity": 1, "userId": "usr_abc123", "confirm": true } }events.viewread-onlyidempotentTicket types of one event: price, sales window, caps.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
sold counts confirmed, pending and awaiting-approval registrations. In-checkout holds excluded. remaining is maxQuantity minus sold, null when uncapped.{
"ticketTypes": [{
"id": "…", "name": "…", "description": "…" | null,
"type": "free" | "paid", "priceCents": 4500, "currency": "EUR",
"access": "everyone" | "members_only",
"isHidden": false, "requireApproval": false,
"maxQuantity": 100 | null, "seatsPerTicket": 1, "maxPerAttendee": 4 | null,
"salesStartAt": "…" | null, "salesEndAt": "…" | null,
"sortOrder": 0,
"sold": 34, "remaining": 66 | null, "salesOpen": true
}]
}{ "name": "ticket_types_list", "arguments": { "eventId": "evt_abc123" } }tickets.manageAdd a ticket tier to an event. Only the name is required.
| Field | Type | Notes | |
|---|---|---|---|
eventId | string | required | From events_list, for example evt_abc123. |
name | string ≤200 | required | |
priceCents | number 0-100000000 | optional | Free when omitted. Currency always follows the organization. |
maxQuantity | integer 1-1000000 | optional | No cap when omitted. |
salesStartAt, salesEndAt | ISO 8601 with offset | optional | |
seatsPerTicket | integer 1-20 | optional | Default 1. |
access | "everyone" | "members_only" | optional | Default everyone. |
description, requireApproval, isHidden, sortOrder, maxPerAttendee | | optional |
source: mcp.{
"ticketTypes": [{ …availability fields, "sold": 0, "remaining": 50 | null, "salesOpen": true }]
}{ "name": "ticket_types_create",
"arguments": { "eventId": "evt_abc123", "name": "Early Bird", "maxQuantity": 50 } }tickets.managedestructiveidempotentChange any subset of fields on a ticket tier. Omitted fields keep their value.
| Field | Type | Notes | |
|---|---|---|---|
ticketTypeId | string | required | |
…any create field | | optional | All optional. |
source: mcp.{
"ticketTypes": [{ …availability fields }]
}{ "name": "ticket_types_update",
"arguments": { "ticketTypeId": "tkt_abc123", "maxQuantity": 80 } }tickets.deletedestructiveidempotentDelete a ticket tier. Cannot be undone.
| Field | Type | Notes | |
|---|---|---|---|
ticketTypeId | string | required |
source: mcp.{ "id": "tkt_abc123", "deleted": true }{ "name": "ticket_types_delete",
"arguments": { "ticketTypeId": "tkt_abc123" } }members.viewread-onlyidempotentFind members by name or email, or filter by status or active membership.
| Field | Type | Notes | |
|---|---|---|---|
search | string 1-200 | optional | Part of a name or email, for example jane or doe@. |
status | "all" | "invited" | "active" | "deactivated" | "banned" | optional | Default: everyone except prospects. all includes prospects. |
hasMembership | boolean | optional | true: only people with an active membership. false: only people without one. |
sortBy | "name" | "email" | "membershipSince" | "createdAt" | optional | |
sortOrder | "asc" | "desc" | optional | |
limit | integer 1-50 | optional | Default 20. |
offset | integer ≥0 | optional |
member base role and no custom role. Owner, admin, staff-user and custom-role accounts are not returned.email, emailVerified and phone appear only when the caller holds members.manage. The check shapes the output. It never fails the call.members.manage.{
"data": [{
"userId": "usr_…", "memberId": "mem_…",
"name": "Jane Doe", "firstName": "Jane" | null, "lastName": "Doe" | null, "username": "…" | null,
"organizationRole": "member",
"memberStatus": "active" | null, "effectiveStatus": "active" | null,
"membershipSince": "2025-03-31T00:00:00.000Z" | null,
"membershipTypeNames": ["Gold"],
"joinedAt": "…",
"banned": false,
"emailSuppressed": false, // true: campaign emails are not delivered
"email": "…", // only with members.manage
"emailVerified": true, // only with members.manage
"phone": "…" | null // only with members.manage
}],
"pagination": { "limit": 20, "offset": 0, "total": 1 }
}{ "name": "members_search",
"arguments": { "search": "jane doe" } }members.viewread-onlyidempotentOne member by userId: status, membership types, member since, join date, ban and email-suppression flags.
| Field | Type | Notes | |
|---|---|---|---|
userId | string | required | From members_search, for example usr_abc123. |
members_search.memberships_list with memberId. For events, call members_registrations.{
"member": {
…member fields as in members_search
}
}{ "name": "members_get",
"arguments": { "userId": "usr_abc123" } }registrations.viewread-onlyidempotentThe events one member registered for, latest first, with status, ticket types and payment status.
| Field | Type | Notes | |
|---|---|---|---|
memberId | string | required | From members_search or members_get, for example mem_abc123. |
status | "pending" | "confirmed" | "cancelled" | "waitlisted" | "rejected" | "awaiting_approval" | optional | Default: all except cancelled. |
sortOrder | "asc" | "desc" | optional | By event start. Default desc. |
limit | integer 1-50 | optional | Default 20. |
offset | integer ≥0 | optional |
registrations:read, not members:read. The registration history stays behind the registrations consent.{
"data": [{
"id": "reg_…", "status": "confirmed", "type": "ticket" | "rsvp",
"registeredAt": "…",
"event": { "id": "evt_…", "name": "…", "startAt": "…" | null, "timezone": "…" | null },
"tickets": [{ "ticketTypeName": "General", "quantity": 1 }],
"paymentStatus": "…" | null
}],
"pagination": { "limit": 20, "offset": 0, "total": 7 }
}{ "name": "members_registrations",
"arguments": { "memberId": "mem_abc123" } }memberships.viewread-onlyidempotentMembership subscriptions: member name, plan, status, dates and next renewal charge date.
| Field | Type | Notes | |
|---|---|---|---|
limit | integer 1-100 | optional | Default 50. |
offset | integer ≥0 | optional | |
status | "pending_approval" | "pending_payment" | "active" | "past_due" | "expired" | "cancelled" | "rejected" | "info_requested" | optional | For "what ends soon": active, sortBy endAt, sortOrder asc. |
membershipTypeId | string | optional | From membership_types_list. |
memberId | string | optional | Only this member's subscriptions. From members_search. |
sortBy | "createdAt" | "startAt" | "endAt" | "status" | optional | Default createdAt. |
sortOrder | "asc" | "desc" | optional | Default desc. |
memberEmail appears only when the caller holds memberships.manage.search filter. To find one person, call members_search, then pass memberId.members_search needs members:read. This call needs only memberships:read.{
"data": [{
"id": "msb_…", "memberName": "…" | null, "membershipTypeName": "Gold" | null,
"status": "active", "origin": "self_purchase" | "complimentary",
"startAt": "…", "endAt": "…" | null, "cancelledAt": "…" | null,
"nextBillingAt": "…" | null, // null: does not renew
"createdAt": "…",
"memberEmail": "…" | null // only with memberships.manage
}],
"pagination": { "limit": 50, "offset": 0, "total": 1 }
}{ "name": "memberships_list",
"arguments": { "memberId": "mem_abc123", "status": "active" } }memberships.viewread-onlyidempotentThe membership plans the organization offers: visibility, capacity, features, renewal fee, and billing cycles with prices.
| Field | Type | Notes | |
|---|---|---|---|
limit | integer 1-100 | optional | Default 50. |
offset | integer ≥0 | optional | |
search | string ≤200 | optional | Matches the type name. |
includeArchived | boolean | optional | Default false. |
sortBy | "name" | "displayOrder" | "createdAt" | optional | Default displayOrder. |
sortOrder | "asc" | "desc" | optional | Default desc. |
durationDays is set only for pass cycles.{
"data": [{
"id": "mst_…", "name": "Gold", "description": "…" | null,
"visibility": "public" | "invite_only", "isActive": true,
"capacity": 200 | null, "displayOrder": 0,
"features": ["…"],
"renewalFeeInCents": 0, "renewalFeeLabel": "…",
"billingCycles": [{
"cycle": "annual", "priceInCents": 12000, "currency": "EUR",
"isDefault": true, "durationDays": null
}]
}],
"pagination": { "limit": 50, "offset": 0, "total": 3 }
}{ "name": "membership_types_list", "arguments": {} }finances.viewread-onlyidempotentOrders of the organization: amounts, currency, payment, lifecycle and fulfillment state, dates and buyer.
| Field | Type | Notes | |
|---|---|---|---|
limit | integer 1-100 | optional | Default 50. |
offset | integer ≥0 | optional | |
sortOrder | "asc" | "desc" | optional | By creation time. Default desc. |
search | string ≤200 | optional | Buyer name or email. |
paymentState | "not_required" | "unpaid" | "pending" | "failed" | "paid" | "reversal_pending" | "refunded" | "reversed" | optional | |
lifecycleState | "open" | "invalidated" | "expired" | "failed" | "fulfilled" | "reversed" | optional | |
fulfillmentState | "pending" | "processing" | "completed" | "failed" | "not_applicable" | optional | |
purchaseType | "one_time" | "recurring_initial" | "recurring_renewal" | optional | |
from, to | ISO date or date-time | optional | Orders created on or after from, and on or before to. |
eventId | string | optional | Only orders for this event. From events_list. |
revenue_summary. Do not add up rows.finances.view.{
"data": [{
"id": "cor_…", "sourceType": "event" | "membership", "sourceId": "evt_…",
"purchaseType": "one_time", "currency": "EUR",
"subtotalCents": 4500, "discountTotalCents": 0,
"feeTotalCents": 150, "totalCents": 4650,
"paymentState": "paid", "fulfillmentState": "completed", "lifecycleState": "fulfilled",
"expiresAt": "…" | null, "paidAt": "…" | null,
"expiredAt": "…" | null, "invalidatedAt": "…" | null,
"createdAt": "…", "updatedAt": "…",
"buyer": {
"name": "…" | null, "email": "…" | null,
"firstName": "…" | null, "lastName": "…" | null, "username": "…" | null
},
"items": { "itemCount": 1, "firstItemName": "General" | null }
}],
"pagination": { "limit": 50, "offset": 0, "total": 1 }
}{ "name": "orders_list",
"arguments": { "eventId": "evt_abc123", "paymentState": "paid" } }finances.viewread-onlyidempotentOne order with its line items, payments, reversals, checkout sessions and billing agreement.
| Field | Type | Notes | |
|---|---|---|---|
orderId | string | required | From orders_list, for example cor_abc123. |
provider is the payment provider name. Provider payment and order IDs are never returned.{
"order": { …order fields as in orders_list },
"items": [{
"name": "General", "description": "…" | null, "kind": "…",
"quantity": 1, "unitAmountCents": 4500, "totalAmountCents": 4500, "currency": "EUR"
}],
"payments": [{
"id": "…", "status": "completed", "provider": "…",
"amountCents": 4650, "refundedAmountCents": 0, "currency": "EUR",
"paidAt": "…" | null, "refundedAt": "…" | null, "createdAt": "…"
}],
"reversals": [{
"id": "…", "paymentId": "…", "provider": "…", "kind": "…", "status": "…",
"requestedAmountCents": 4650 | null, "resolvedAmountCents": 4650 | null,
"currency": "EUR", "cancelsSubscription": false,
"failureCode": "…" | null, "failureMessage": "…" | null, "createdAt": "…"
}],
"checkoutSessions": [{
"id": "…", "provider": "…", "status": "…",
"failureCode": "…" | null, "failureMessage": "…" | null,
"expiresAt": "…" | null, "createdAt": "…"
}],
"billingAgreement": {
"id": "…", "status": "…", "interval": "…", "intervalCount": 1,
"renewalAmountCents": 4500, "currency": "EUR",
"periodStartAt": "…" | null, "periodEndAt": "…" | null, "cancelledAt": "…" | null
} | null
}{ "name": "orders_get",
"arguments": { "orderId": "cor_abc123" } }campaigns.viewread-onlyidempotentEmail campaigns: name, subject, status, schedule, send counts and attributed registrations. Newest first.
| Field | Type | Notes | |
|---|---|---|---|
limit | integer 1-100 | optional | Default 50. |
offset | integer ≥0 | optional | |
status | "draft" | "sending" | "sent" | "failed" | "scheduled" | "archived" | optional | Archived campaigns are left out by default. |
eventId | string | optional | Only campaigns linked to this event. |
search | string ≤200 | optional | Matches the campaign name. |
{
"data": [{
"id": "cmp_…", "name": "…", "subject": "…", "previewText": "…" | null,
"status": "sent",
"scheduledAt": "…" | null, "sentAt": "…" | null,
"recipientCount": 420 | null, "sentCount": 418, "failedCount": 2,
"attributedRegistrations": 17,
"eventId": "evt_…" | null
}],
"pagination": { "limit": 50, "offset": 0, "total": 1 }
}{ "name": "campaigns_list",
"arguments": { "status": "sent", "limit": 10 } }campaigns.viewread-onlyidempotentDelivery, click and attribution numbers for one campaign, with clicks per link.
| Field | Type | Notes | |
|---|---|---|---|
campaignId | string | required | From campaigns_list, for example cmp_abc123. |
finances.view. The check shapes the output. It never fails the call.reachedAndRegistered is null when reachedAndRegisteredUnavailable gives the reason: no_event or event_ended.{
"delivered": 418, "trackedRecipients": 418,
"uniqueClicks": 96, "clickRate": 0.23 | null,
"attributedRegistrations": 17, "registrationRate": 0.04 | null,
"attributedTickets": 15, "attributedMemberships": 2,
"reachedAndRegistered": 21 | null,
"reachedAndRegisteredUnavailable": "no_event" | "event_ended" | null,
"windowDays": 7,
"links": [{ "position": 1, "label": "…" | null, "url": "…", "uniqueClicks": 80 }],
"attributedRevenueCents": 76500, // only with finances.view
"refundedCents": 0, // only with finances.view
"revenuePerRecipientCents": 183 | null, // only with finances.view
"currency": "EUR" | null // only with finances.view
}{ "name": "campaign_performance",
"arguments": { "campaignId": "cmp_abc123" } }campaigns.viewread-onlyidempotentEmails sent this month against the organization's monthly quota.
| Field | Type | Notes | |
|---|---|---|---|
| No input. | |||
quotaMonthly: null means no limit.{
"sentThisMonth": 1840,
"quotaMonthly": 5000 | null
}{ "name": "campaign_email_usage", "arguments": {} }Read-only snapshots an assistant can open by URI. Same checks as the matching tool: scope first, then the staff permission.
| Pattern | Scope | Permission |
|---|---|---|
enclave://event/{eventId} | events:read | events.view |
enclave://event/{eventId}/stats | registrations:read | registrations.view |
events_get. Stats carry the same numbers as checkin_stats.{ "uri": "enclave://event/evt_abc123/stats" }Ready-made flows an assistant can start. Static text, no data access. The prompt text contains no data. Each tool it calls keeps its own scope and permission check.
| Name | Arguments | Guides toward |
|---|---|---|
create-event | name, date? | Gathering fields, then events_create |
door-briefing | eventId? | checkin_stats, registrations_list, checkin_mark |
weekly-briefing | days? (string, 1–2 digits, for example "7") | org_overview. If it is not available: events_list, checkin_stats, memberships_list, orders_list, revenue_summary |
{ "name": "door-briefing",
"arguments": { "eventId": "evt_abc123" } }Transport problems are HTTP errors. Problems the model can fix are tool results with isError: true and a plain message.
error code, so clients do not loop on re-authorization.scope on a series event, not found (for example "Member not found"), or the staff role lacks the permission. Read the message and adjust the call.Dates are ISO 8601 with an offset. Time zones are IANA names. Always pass one when you set a date and time.
Results carry structuredContent, validated against the tool's output schema, plus a text block with a one-line summary and the same JSON.
Series: events in a recurring series need scope on update and delete: this, following or all.
Descriptions are plain text in and out. Blank lines separate paragraphs.
tools/list is static and cacheable: cacheScope: private, ttlMs: 300000.
Audit: every create, update and delete writes an audit row with source: mcp and the client ID.
Origin: browser requests must come from an allowed origin. Requests without an Origin header, such as command-line clients, are allowed. The bearer token is what authenticates.
Permissions resolve through the same resolver as the console, so custom roles behave the same way.
Money is integer cents with an ISO 4217 currency code.
Contact fields in registration, member and membership tools need the matching manage permission: registrations.manage, members.manage, memberships.manage. The check shapes the output. It never fails the call. Order tools show buyer name and email to every role with finances.view.
Partial answers: org_overview returns null for a section that the connection or role cannot see, and lists it in omitted. campaign_performance leaves out revenue fields without finances.view.
Pagination: newer list tools return pagination: { limit, offset, total }. Event and registration lists return total, limit, offset and nextOffset.
Limits: no tool refunds or changes a payment, sends a campaign or a message, or reads registration answers or check-in QR codes. Use the Memberhaus console for these.