Reference

Tool reference.

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.

EndpointPOST https://api.memberhaus.com/api/mcp
ProtocolMCP 2026-07-28, Streamable HTTP, stateless
AuthOAuth 2.1 + PKCE. Client ID Metadata Documents. Bearer token per request.
Rate limit60 calls per minute per token
Discovery/.well-known/oauth-protected-resource/api/mcp
/.well-known/oauth-authorization-server
Scopesevents:read · events:write (implies read) · registrations:read · registrations:write (implies read) · checkin:write · members:read · memberships:read · orders:read · campaigns:read (all standalone)
ConsentNew areas need a new consent. Disconnect and connect again to allow them.
TokensAccess 1 h. Refresh 30 d, rotating. Bound to one user, organization and client.

org_overview

events:readpermission events.view + per sectionread-onlyidempotent

One 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.

Input

FieldTypeNotes
daysinteger 1-31optionalDays ahead for events. Default 7.
  • Each section needs its scope and the role permission: upcomingEvents → events:read / events.view · registrationQueue → registrations:read / registrations.view · memberships → memberships:read / memberships.view · orders → orders:read / finances.view.
  • A section that fails a check is null and is listed in omitted. reason: "scope": connect again and approve more access. reason: "permission": ask an organization admin.
  • A write scope counts as its read scope.
  • 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.
  • Use it for broad briefing questions only. To find one event or one person, use events_list, registrations_list or members_search.

Output

structuredContentcopy
{
  "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" }]
}

Example

tools/callcopy
{ "name": "org_overview", "arguments": { "days": 7 } }

event_insights

registrations:readpermission analytics.viewread-onlyidempotent

How an event performed, or the whole organization. Counts and event names only.

Input

FieldTypeNotes
eventIdstringoptionalOmit for organization-wide top events.
period"7d" | "30d" | "90d" | "1y" | "all"optionalDefault 30d.
  • No attendee rows. No revenue.

Output

structuredContentcopy
{
  "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
  }]
}

Example

tools/callcopy
{ "name": "event_insights",
  "arguments": { "period": "7d" } }

revenue_summary

orders:readpermission finances.viewread-onlyidempotent

Money totals for a period, for the whole organization. Gross, refunds, Memberhaus platform fees and net, per currency.

Input

FieldTypeNotes
period"7d" | "30d" | "90d" | "1y" | "all"optionalDefault 30d.
  • Organization-wide only. For the sales of one event, use orders_list with eventId.
  • Use this tool. Do not add up orders_list rows.
  • Amounts are integer cents. A currency with no activity in the period is left out.
  • platformFeesCents is the Memberhaus fee, not the payment processor fee.
  • Refunds count on the day of the refund, so net can be negative in a short period.
  • dailyTimeline is empty when the period has more than one currency.
  • There is no split between event and membership revenue.
  • Numbers can lag the latest payment by a short cache interval.

Output

structuredContentcopy
{
  "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 }]
}

Example

tools/callcopy
{ "name": "revenue_summary",
  "arguments": { "period": "30d" } }

events_list

events:readpermission events.viewread-onlyidempotent

Search and page through the organization's events.

Input

FieldTypeNotes
limitinteger 1-100optionalDefault 20.
offsetintegeroptionalDefault 0.
searchstring ≤200optionalCase-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
startsAfterISO date or date-timeoptionalEvents that start at or after this time. A bare date is UTC midnight.
startsBeforeISO date or date-timeoptionalEvents 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.

Output

structuredContentcopy
{
  "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
}

Example

tools/callcopy
{ "name": "events_list",
  "arguments": { "timeFilter": "upcoming", "visibility": "private", "limit": 10 } }

events_get

events:readpermission events.viewread-onlyidempotent

Full detail of one event, including its ticket types.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
  • attendeeCount is null here. It is populated only by events_list.

Output

structuredContentcopy
{
  …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": "…"
}

Example

tools/callcopy
{ "name": "events_get", "arguments": { "eventId": "evt_abc123" } }

events_series_occurrences

events:readpermission events.viewread-onlyidempotent

The upcoming dates of the recurring series that an event belongs to, soonest first.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
  • Upcoming occurrences only. Past dates are never included.
  • An event that is not in a series returns a tool error, not an empty list. Check isSeries first.
  • To change a series, use events_update or events_delete with scope.

Output

structuredContentcopy
{
  "data": [{
    "id": "evt_…", "slug": "…", "startAt": "…",
    "isDetached": false,
    "registrationCount": 12, "soldOut": false
  }]
}

Example

tools/callcopy
{ "name": "events_series_occurrences",
  "arguments": { "eventId": "evt_abc123" } }

events_create

events:writepermission events.manage

Create 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.

Input

FieldTypeNotes
namestring ≤200required
locationType"online" | "offline" | "hybrid"requiredOnline and hybrid need meetingUrl.
startAtISO 8601 with offsetrequired
endAtISO 8601 with offsetoptional
timezoneIANA namerequiredFor example Europe/Ljubljana.
descriptionMarkdownstring ≤50000optionalMarkdown: headings (#, ##, ###), bullet and numbered lists, links, bold, italic, ~~strike~~, ++underline++, quotes and code. No images or tables.
visibility"public" | "unlisted" | "private"optionalDefault public.
placeIdstringoptionalFrom places_search. The server sets the address and the map pin. Not with addressText.
addressTextstring ≤500optionalFor a venue that places_search does not find. No map pin.
coverImageUrlhttps URLoptionalJPEG, PNG, WebP, GIF or AVIF, at most 10 MB. The server downloads it.
themePresetIdpreset idoptionalAnimated background, for example aurora, confetti or snow. none shows no animation.
meetingUrlURLoptional
maxCapacityinteger 1-1000000optional
requireApproval, enableWaitlist, showGuestListbooleanoptional
recurrenceobjectoptionalfreq, interval, byWeekday, monthlyMode, ends. Makes a series. For weekly, byWeekday must include the start weekday.
  • Ticket tiers are not part of this call. Create the event first, then add tiers with ticket_types_create.
  • The server converts descriptionMarkdown to the same document the console editor stores. Images and tables return a tool error; use coverImageUrl for the event image.
  • An online event cannot have placeId or addressText.

Output

structuredContentcopy
{
  …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": "…"
}

Example

tools/callcopy
{ "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_update

events:writepermission events.managedestructiveidempotent

Change any subset of fields on an event, or on part of a series.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
scope"this" | "following" | "all"optionalRequired only when the event belongs to a recurring series.
…any create fieldoptionalAll optional except recurrence, which cannot change here. Omitted fields keep their value.
descriptionMarkdownstring | nulloptionalPass null to clear.
placeId, addressTextstring | nulloptionalPass null to remove the physical location.
coverImageUrlhttps URL | nulloptionalPass null to remove the cover.
themePresetIdpreset id | nulloptionalPass null to reset the theme.
maxCapacityinteger | nulloptionalPass null to remove the cap.
  • A series event without scope returns a tool error asking for one.

Output

structuredContentcopy
{
  …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": "…"
}

Example

tools/callcopy
{ "name": "events_update",
  "arguments": { "eventId": "evt_abc123", "maxCapacity": 80 } }

events_delete

events:writepermission events.deletedestructiveidempotent

Cancel an event. A soft cancel: the event stays in the console as cancelled.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
scope"this" | "following" | "all"optionalRequired only when the event belongs to a recurring series.
confirmtrueoptionalMust be literally true. Ask the user first and wait for a yes.
  • Carries destructiveHint. Clients that honour it ask the user before calling. The confirm field covers clients that do not.
  • Clients that support form elicitation get a confirm form. Other clients must send confirm: true, or the call returns a tool error.
  • There is no hard delete over MCP.

Output

structuredContentcopy
{ "id": "evt_abc123", "deleted": true }

Example

tools/callcopy
{ "name": "events_delete",
  "arguments": { "eventId": "evt_abc123", "confirm": true } }

registrations_list

registrations:readpermission registrations.viewread-onlyidempotent

Attendees of one event, with paging and filters.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
limitinteger 1-100optionalDefault 20.
offsetintegeroptionalDefault 0.
searchstring ≤200optionalAttendee name or email.
status"pending" | "confirmed" | "cancelled" | "waitlisted" | "rejected" | "awaiting_approval"optional
type"ticket" | "rsvp"optional
ticketTypeIdstringoptional
sortBy, sortOrderstringoptional
  • Never returns the check-in QR signature or answers to registration questions. Those fields do not exist at any permission level.
  • Email and phone are not in the list. Use registrations_get.

Output

structuredContentcopy
{
  "registrations": [{
    "id": "reg_…", "eventId": "evt_…",
    "type": "ticket" | "rsvp", "status": "confirmed",
    "attendeeName": "…",
    "createdAt": "…", "cancelledAt": "…" | null
  }],
  "total": 88, "limit": 20, "offset": 0, "nextOffset": 20
}

Example

tools/callcopy
{ "name": "registrations_list",
  "arguments": { "eventId": "evt_abc123", "status": "waitlisted" } }

registrations_get

registrations:readpermission registrations.viewread-onlyidempotent

One registration. Contact fields appear only when the caller holds registrations.manage.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
registrationIdstringrequiredFrom registrations_list.
  • The permission check shapes the output. It never fails the call.

Output

structuredContentcopy
{
  …registration summary fields,
  "email": "…",        // only with registrations.manage
  "phone": "…" | null  // only with registrations.manage
}

Example

tools/callcopy
{ "name": "registrations_get",
  "arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456" } }

registrations_update

registrations:writepermission registrations.managedestructiveidempotent

Change one attendee's status. Confirm waitlisted or pending registrations, move back to the waitlist, decline, or cancel.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
registrationIdstringrequiredFrom registrations_list.
status"pending" | "confirmed" | "cancelled" | "rejected" | "waitlisted"requiredConfirming a waitlisted registration checks capacity first.
  • Invalid transitions return a tool error. Read the message and adjust the call.
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{
  …registration summary fields,
  "email": "…",        // only with registrations.manage
  "phone": "…" | null  // only with registrations.manage
}

Example

tools/callcopy
{ "name": "registrations_update",
  "arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456", "status": "confirmed" } }

registrations_cancel

registrations:writepermission registrations.canceldestructiveidempotent

Cancel one registration and free the seat.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
registrationIdstringrequiredFrom registrations_list.
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{ "id": "reg_def456", "cancelled": true }

Example

tools/callcopy
{ "name": "registrations_cancel",
  "arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456" } }

checkin_stats

registrations:readpermission registrations.viewread-onlyidempotent

Aggregate attendance counts for one event. Live during the event.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
  • Counts only. No names, no list. To mark attendance use checkin_mark.
  • To add someone without a booking, use checkin_walk_in.

Output

structuredContentcopy
{
  "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
}

Example

tools/callcopy
{ "name": "checkin_stats", "arguments": { "eventId": "evt_abc123" } }

checkin_mark

checkin:writepermission checkin.scandestructiveidempotent

Check one attendee in, or undo a check-in. A standalone scope: door devices can hold only check-in power.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
registrationIdstringrequiredFrom registrations_list.
attendanceStatus"checked_in" | "not_checked_in"requiredchecked_in marks arrival. not_checked_in undoes one.
confirmtruerequiredMust be literally true. Ask the user first.
  • Only confirmed registrations can be checked in.
  • Repeating the current state changes nothing and reports alreadyInState: true.
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{
  "id": "reg_…", "name": "…",
  "displayStatus": "checked_in", "registrationStatus": "confirmed",
  "attendanceStatus": "checked_in",
  "ticketTypeName": "…" | null, "quantity": 1,
  "alreadyInState": false
}

Example

tools/callcopy
{ "name": "checkin_mark",
  "arguments": { "eventId": "evt_abc123", "registrationId": "reg_def456", "attendanceStatus": "checked_in", "confirm": true } }

checkin_walk_in

checkin:writepermission checkin.walkIndestructive

Register someone who arrived without a booking. It creates a confirmed registration, checks the person in and sends a confirmation email.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
ticketTypeIdstringrequiredFrom ticket_types_list, for example tkt_abc123.
quantityinteger ≥1requiredSeats to register.
userIdstringoptionalAn existing member, for example usr_abc123. Send exactly one of userId or email. Prefer email.
emailemailoptionalAn unknown email gets an invitation email.
firstName, lastNamestring ≤100optional
confirmtruerequiredMust be literally true. Ask the user first.
  • An unknown email also creates a member account. You cannot undo this.
  • The output includes the email. It never includes phone or registration answers.
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{
  "id": "reg_…", "name": "…", "email": "…",
  "displayStatus": "checked_in", "registrationStatus": "confirmed",
  "attendanceStatus": "checked_in",
  "ticketTypeName": "…" | null, "quantity": 1
}

Example

tools/callcopy
{ "name": "checkin_walk_in",
  "arguments": { "eventId": "evt_abc123", "ticketTypeId": "tkt_abc123", "quantity": 1, "userId": "usr_abc123", "confirm": true } }

ticket_types_list

events:readpermission events.viewread-onlyidempotent

Ticket types of one event: price, sales window, caps.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
  • Never returns member-tier pricing or admin-fee configuration.
  • sold counts confirmed, pending and awaiting-approval registrations. In-checkout holds excluded. remaining is maxQuantity minus sold, null when uncapped.

Output

structuredContentcopy
{
  "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
  }]
}

Example

tools/callcopy
{ "name": "ticket_types_list", "arguments": { "eventId": "evt_abc123" } }

ticket_types_create

events:writepermission tickets.manage

Add a ticket tier to an event. Only the name is required.

Input

FieldTypeNotes
eventIdstringrequiredFrom events_list, for example evt_abc123.
namestring ≤200required
priceCentsnumber 0-100000000optionalFree when omitted. Currency always follows the organization.
maxQuantityinteger 1-1000000optionalNo cap when omitted.
salesStartAt, salesEndAtISO 8601 with offsetoptional
seatsPerTicketinteger 1-20optionalDefault 1.
access"everyone" | "members_only"optionalDefault everyone.
description, requireApproval, isHidden, sortOrder, maxPerAttendeeoptional
  • Member-tier pricing and admin fees are accepted as input but never returned.
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{
  "ticketTypes": [{ …availability fields, "sold": 0, "remaining": 50 | null, "salesOpen": true }]
}

Example

tools/callcopy
{ "name": "ticket_types_create",
  "arguments": { "eventId": "evt_abc123", "name": "Early Bird", "maxQuantity": 50 } }

ticket_types_update

events:writepermission tickets.managedestructiveidempotent

Change any subset of fields on a ticket tier. Omitted fields keep their value.

Input

FieldTypeNotes
ticketTypeIdstringrequired
…any create fieldoptionalAll optional.
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{
  "ticketTypes": [{ …availability fields }]
}

Example

tools/callcopy
{ "name": "ticket_types_update",
  "arguments": { "ticketTypeId": "tkt_abc123", "maxQuantity": 80 } }

ticket_types_delete

events:writepermission tickets.deletedestructiveidempotent

Delete a ticket tier. Cannot be undone.

Input

FieldTypeNotes
ticketTypeIdstringrequired
  • Writes an audit row with source: mcp.

Output

structuredContentcopy
{ "id": "tkt_abc123", "deleted": true }

Example

tools/callcopy
{ "name": "ticket_types_delete",
  "arguments": { "ticketTypeId": "tkt_abc123" } }

members_get

members:readpermission members.viewread-onlyidempotent

One member by userId: status, membership types, member since, join date, ban and email-suppression flags.

Input

FieldTypeNotes
userIdstringrequiredFrom members_search, for example usr_abc123.
  • Same field rules as members_search.
  • Owner, admin and staff-user accounts return "Member not found". A custom role on a member account is returned, the same as in the console.
  • For subscriptions, call memberships_list with memberId. For events, call members_registrations.

Output

structuredContentcopy
{
  "member": {
    …member fields as in members_search
  }
}

Example

tools/callcopy
{ "name": "members_get",
  "arguments": { "userId": "usr_abc123" } }

members_registrations

registrations:readpermission registrations.viewread-onlyidempotent

The events one member registered for, latest first, with status, ticket types and payment status.

Input

FieldTypeNotes
memberIdstringrequiredFrom members_search or members_get, for example mem_abc123.
status"pending" | "confirmed" | "cancelled" | "waitlisted" | "rejected" | "awaiting_approval"optionalDefault: all except cancelled.
sortOrder"asc" | "desc"optionalBy event start. Default desc.
limitinteger 1-50optionalDefault 20.
offsetinteger ≥0optional
  • Needs registrations:read, not members:read. The registration history stays behind the registrations consent.
  • No slugs, addresses, cover images, seat names or registration answers.

Output

structuredContentcopy
{
  "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 }
}

Example

tools/callcopy
{ "name": "members_registrations",
  "arguments": { "memberId": "mem_abc123" } }

memberships_list

memberships:readpermission memberships.viewread-onlyidempotent

Membership subscriptions: member name, plan, status, dates and next renewal charge date.

Input

FieldTypeNotes
limitinteger 1-100optionalDefault 50.
offsetinteger ≥0optional
status"pending_approval" | "pending_payment" | "active" | "past_due" | "expired" | "cancelled" | "rejected" | "info_requested"optionalFor "what ends soon": active, sortBy endAt, sortOrder asc.
membershipTypeIdstringoptionalFrom membership_types_list.
memberIdstringoptionalOnly this member's subscriptions. From members_search.
sortBy"createdAt" | "startAt" | "endAt" | "status"optionalDefault createdAt.
sortOrder"asc" | "desc"optionalDefault desc.
  • memberEmail appears only when the caller holds memberships.manage.
  • Never returned: member user ID, payment method, application answers, verification photo, provider subscription IDs.
  • There is no search filter. To find one person, call members_search, then pass memberId.
  • members_search needs members:read. This call needs only memberships:read.

Output

structuredContentcopy
{
  "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 }
}

Example

tools/callcopy
{ "name": "memberships_list",
  "arguments": { "memberId": "mem_abc123", "status": "active" } }

membership_types_list

memberships:readpermission memberships.viewread-onlyidempotent

The membership plans the organization offers: visibility, capacity, features, renewal fee, and billing cycles with prices.

Input

FieldTypeNotes
limitinteger 1-100optionalDefault 50.
offsetinteger ≥0optional
searchstring ≤200optionalMatches the type name.
includeArchivedbooleanoptionalDefault false.
sortBy"name" | "displayOrder" | "createdAt"optionalDefault displayOrder.
sortOrder"asc" | "desc"optionalDefault desc.
  • Never returns admin fees, application form settings or provider price IDs.
  • durationDays is set only for pass cycles.

Output

structuredContentcopy
{
  "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 }
}

Example

tools/callcopy
{ "name": "membership_types_list", "arguments": {} }

orders_list

orders:readpermission finances.viewread-onlyidempotent

Orders of the organization: amounts, currency, payment, lifecycle and fulfillment state, dates and buyer.

Input

FieldTypeNotes
limitinteger 1-100optionalDefault 50.
offsetinteger ≥0optional
sortOrder"asc" | "desc"optionalBy creation time. Default desc.
searchstring ≤200optionalBuyer 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, toISO date or date-timeoptionalOrders created on or after from, and on or before to.
eventIdstringoptionalOnly orders for this event. From events_list.
  • Read-only. It cannot refund, cancel or change an order. Refunds are in the Memberhaus console.
  • For totals over a period, use revenue_summary. Do not add up rows.
  • Buyer name and email appear for every role with finances.view.
  • Never returned: card details, payment provider IDs, buyer user ID, order metadata such as answers and coupons.

Output

structuredContentcopy
{
  "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 }
}

Example

tools/callcopy
{ "name": "orders_list",
  "arguments": { "eventId": "evt_abc123", "paymentState": "paid" } }

orders_get

orders:readpermission finances.viewread-onlyidempotent

One order with its line items, payments, reversals, checkout sessions and billing agreement.

Input

FieldTypeNotes
orderIdstringrequiredFrom orders_list, for example cor_abc123.
  • Read-only. It cannot refund, cancel or change an order. Refunds are in the Memberhaus console.
  • provider is the payment provider name. Provider payment and order IDs are never returned.
  • Amounts are integer cents.

Output

structuredContentcopy
{
  "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
}

Example

tools/callcopy
{ "name": "orders_get",
  "arguments": { "orderId": "cor_abc123" } }

campaigns_list

campaigns:readpermission campaigns.viewread-onlyidempotent

Email campaigns: name, subject, status, schedule, send counts and attributed registrations. Newest first.

Input

FieldTypeNotes
limitinteger 1-100optionalDefault 50.
offsetinteger ≥0optional
status"draft" | "sending" | "sent" | "failed" | "scheduled" | "archived"optionalArchived campaigns are left out by default.
eventIdstringoptionalOnly campaigns linked to this event.
searchstring ≤200optionalMatches the campaign name.
  • Email content, segment rules and per-recipient data are never returned.
  • No tool sends or schedules a campaign. Use the Memberhaus console for that.

Output

structuredContentcopy
{
  "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 }
}

Example

tools/callcopy
{ "name": "campaigns_list",
  "arguments": { "status": "sent", "limit": 10 } }

campaign_performance

campaigns:readpermission campaigns.viewread-onlyidempotent

Delivery, click and attribution numbers for one campaign, with clicks per link.

Input

FieldTypeNotes
campaignIdstringrequiredFrom campaigns_list, for example cmp_abc123.
  • Revenue fields appear only when the caller holds finances.view. The check shapes the output. It never fails the call.
  • There is no open tracking. Memberhaus does not record opens.
  • A draft returns zeros.
  • reachedAndRegistered is null when reachedAndRegisteredUnavailable gives the reason: no_event or event_ended.

Output

structuredContentcopy
{
  "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
}

Example

tools/callcopy
{ "name": "campaign_performance",
  "arguments": { "campaignId": "cmp_abc123" } }

campaign_email_usage

campaigns:readpermission campaigns.viewread-onlyidempotent

Emails sent this month against the organization's monthly quota.

Input

FieldTypeNotes
No input.
  • quotaMonthly: null means no limit.

Output

structuredContentcopy
{
  "sentThisMonth": 1840,
  "quotaMonthly": 5000 | null
}

Example

tools/callcopy
{ "name": "campaign_email_usage", "arguments": {} }

Resources.

Read-only snapshots an assistant can open by URI. Same checks as the matching tool: scope first, then the staff permission.

URI

PatternScopePermission
enclave://event/{eventId}events:readevents.view
enclave://event/{eventId}/statsregistrations:readregistrations.view
  • Detail carries the same fields as events_get. Stats carry the same numbers as checkin_stats.
  • Denied or foreign reads return a plain message, never data.

Example

resources/readcopy
{ "uri": "enclave://event/evt_abc123/stats" }

Prompts.

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.

Prompt

NameArgumentsGuides toward
create-eventname, date?Gathering fields, then events_create
door-briefingeventId?checkin_stats, registrations_list, checkin_mark
weekly-briefingdays? (string, 1–2 digits, for example "7")org_overview. If it is not available: events_list, checkin_stats, memberships_list, orders_list, revenue_summary

Example

prompts/getcopy
{ "name": "door-briefing",
  "arguments": { "eventId": "evt_abc123" } }

Errors.

Transport problems are HTTP errors. Problems the model can fix are tool results with isError: true and a plain message.

401 invalid_tokenMissing, expired, revoked, wrong audience, or the user is no longer staff. Re-authorize.
403 insufficient_scope · scope="events:write"The token lacks the scope the tool needs. Repeat authorization with the wider scope. Existing grants on other devices stay valid. Scopes: see the Scopes fact at the top.
403 · error_description onlyThe organization has assistant access turned off. No error code, so clients do not loop on re-authorization.
404The deployment has MCP disabled. Endpoint, metadata and OAuth routes all return 404.
429Over 60 calls per minute on this token. Back off and retry.
isError: trueValidation failure, missing 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.

Conventions.

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.