luma-events-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dominik Grusemann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# luma-events-mcp
+
+<div align="center">
+
+A Luma Calendar MCP server exposing event, guest, and ticket operations as tools for AI assistants.
+
+[![Release](https://github.com/bettervibe-org/luma-events-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/bettervibe-org/luma-events-mcp/actions/workflows/release.yml)
+[![npm version](https://badge.fury.io/js/luma-events-mcp.svg)](https://www.npmjs.com/package/luma-events-mcp)
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
+[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
+
+</div>
+
+## Features
+
+- Get calendar info associated with your API key
+- List, create, and update events
+- List guests, get guest details, add guests, update guest status, send invites
+- List and create ticket types
+- List and create coupons
+- Dual pagination mode: auto-paginate all results or manual cursor-based paging
+
+## Setup
+
+```json
+{
+  "mcpServers": {
+    "luma": {
+      "command": "npx",
+      "args": ["luma-events-mcp"],
+      "env": {
+        "LUMA_API_KEY": "<your Luma API key>"
+      }
+    }
+  }
+}
+```
+
+Get your API key from your Luma dashboard (requires Luma Plus).
+
+## Development
+
+### Quick Start
+
+Run the MCP server in development mode with auto-reload:
+```bash
+npm run dev
+```
+
+This will run the TypeScript code directly with watch mode and automatically load environment variables from `.env`.
+
+### Manual Build
+
+```bash
+npm run build
+node dist/index.js
+```
+
+## Available Tools
+
+<!-- TOOLS:START - generated by scripts/gen-tool-docs.ts -->
+### get-calendar
+
+Get the calendar associated with the current API key
+
+Parameters: none
+
+Returns:
+- Calendar object with api_id, name, and geo fields
+
+### list-events
+
+List events for the calendar. Optionally filter by date range. Without pagination params, returns all events; with them, returns one page.
+
+Parameters:
+- `after`: string (optional) — Only events starting after this ISO 8601 datetime
+- `before`: string (optional) — Only events starting before this ISO 8601 datetime
+- `pagination_limit`: number (optional) — Page size (max 50)
+- `pagination_cursor`: string (optional) — Cursor from a previous page
+
+Returns:
+- Array of event objects, or paginated result with next_cursor
+
+### get-event
+
+Get admin details of a specific event by its ID
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+
+Returns:
+- Full event object including name, dates, location, description, and ticket info
+
+### list-guests
+
+List guests for an event. Without pagination params, returns all guests; with them, returns one page.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `approval_status`: enum (`approved` | `session` | `pending_approval` | `invited` | `declined` | `waitlist`) (optional) — Filter by approval status
+- `sort_column`: enum (`name` | `email` | `created_at` | `registered_at` | `checked_in_at`) (optional) — Sort column
+- `pagination_limit`: number (optional) — Page size
+- `pagination_cursor`: string (optional) — Cursor from a previous page
+
+Returns:
+- Array of guest objects, or paginated result with next_cursor
+
+### get-guest
+
+Get detailed info for a single event guest. The id field accepts a guest ID (gst-...), guest key (g-...), ticket key, or email address.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `id`: string — Guest identifier: guest ID (gst-...), guest key (g-...), or email
+
+Returns:
+- Full guest object with approval status, ticket info, event_ticket_orders, and profile
+
+### list-ticket-types
+
+List all ticket types for an event
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+
+Returns:
+- Array of ticket type objects with name, price, and availability info
+
+### create-event
+
+Create a new event on the calendar
+
+Parameters:
+- `name`: string — Event title
+- `start_at`: string — Start datetime (ISO 8601)
+- `timezone`: string — IANA timezone (e.g. America/New_York)
+- `end_at`: string (optional) — End datetime (ISO 8601)
+- `description_md`: string (optional) — Event description in markdown
+- `meeting_url`: string (optional) — Virtual event URL
+- `geo_address_json`: value (optional) — Address object with city, place, etc.
+- `geo_latitude`: number (optional) — Latitude
+- `geo_longitude`: number (optional) — Longitude
+- `cover_url`: string (optional) — Cover image URL (must be Luma CDN)
+- `visibility`: enum (`public` | `members-only` | `private`) (optional) — Event visibility
+- `max_capacity`: number (optional) — Maximum attendee capacity
+
+Returns:
+- The created event object
+
+### update-event
+
+Update an existing event. Only provided fields are changed.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `suppress_notifications`: boolean (optional) — Prevent guest notifications for name/time/location changes
+- `name`: string (optional) — Event title
+- `start_at`: string (optional) — Start datetime (ISO 8601)
+- `end_at`: string (optional) — End datetime (ISO 8601)
+- `timezone`: string (optional) — IANA timezone
+- `description_md`: string (optional) — Event description in markdown
+- `meeting_url`: string (optional) — Virtual event URL
+- `cover_url`: string (optional) — Cover image URL
+- `visibility`: enum (`public` | `members-only` | `private`) (optional) — Event visibility
+- `max_capacity`: number (optional) — Maximum attendee capacity
+
+Returns:
+- The updated event object
+
+### add-guests
+
+Add guests to an event. By default guests are approved and receive one default ticket.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `guests`: array of object — Array of guest objects with email
+- `approval_status`: enum (`approved` | `pending_approval` | `waitlist`) (optional) — Approval status for added guests (default: approved)
+- `send_email`: boolean (optional) — Send notification email (default: true)
+- `ticket`: value (optional) — Ticket type to assign to all guests
+
+Returns:
+- Confirmation of added guests
+
+### update-guest-status
+
+Update a guest's approval status (approve or decline)
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `guest`: value — Guest identifier object (e.g. { email: '...' } or { id: 'gst-...' })
+- `status`: enum (`approved` | `declined`) — New status for the guest
+- `should_refund`: boolean (optional) — Refund the guest if declining a paid ticket
+
+Returns:
+- Confirmation of status update
+
+### send-invites
+
+Send invites to guests for an event. Sends email and SMS if phone is linked.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `guests`: array of object — Array of guest objects with email and optional message
+
+Returns:
+- Confirmation of sent invites
+
+### create-ticket-type
+
+Create a new ticket type for an event
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `name`: string — Ticket type name
+- `type`: enum (`free` | `paid`) — Ticket pricing type
+- `require_approval`: boolean (optional) — Require host approval
+- `is_hidden`: boolean (optional) — Hide from public listing
+- `description`: string (optional) — Ticket type description
+- `max_capacity`: number (optional) — Maximum tickets available
+- `cents`: number (optional) — Price in cents (for paid tickets)
+- `currency`: string (optional) — Currency code (e.g. USD, EUR)
+
+Returns:
+- The created ticket type object
+
+### list-coupons
+
+List all coupons for an event. Without pagination params, returns all coupons; with them, returns one page.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `pagination_limit`: number (optional) — Page size
+- `pagination_cursor`: string (optional) — Cursor from a previous page
+
+Returns:
+- Array of coupon objects, or paginated result with next_cursor
+
+### create-coupon
+
+Create a coupon for an event. Coupon terms cannot be edited after creation.
+
+Parameters:
+- `event_id`: string — Event ID (e.g. evt-...)
+- `code`: string — Coupon code (1-20 chars, case-insensitive)
+- `discount`: value — Discount object (e.g. { type: 'percent', percent_off: 20 })
+- `remaining_count`: number (optional) — Number of uses (0-1000000; use 1000000 for unlimited)
+- `valid_start_at`: string (optional) — Validity start (ISO 8601)
+- `valid_end_at`: string (optional) — Validity end (ISO 8601)
+
+Returns:
+- The created coupon object
+<!-- TOOLS:END -->
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LumaClient } from "./luma-client.js";
+import { registerAddGuests } from "./tools/add-guests.js";
+import { registerCreateCoupon } from "./tools/create-coupon.js";
+import { registerCreateEvent } from "./tools/create-event.js";
+import { registerCreateTicketType } from "./tools/create-ticket-type.js";
+import { registerGetCalendar } from "./tools/get-calendar.js";
+import { registerGetEvent } from "./tools/get-event.js";
+import { registerGetGuest } from "./tools/get-guest.js";
+import { registerListCoupons } from "./tools/list-coupons.js";
+import { registerListEvents } from "./tools/list-events.js";
+import { registerListGuests } from "./tools/list-guests.js";
+import { registerListTicketTypes } from "./tools/list-ticket-types.js";
+import { registerSendInvites } from "./tools/send-invites.js";
+import { registerUpdateEvent } from "./tools/update-event.js";
+import { registerUpdateGuestStatus } from "./tools/update-guest-status.js";
+const server = new McpServer({
+    name: "luma-events-mcp",
+    version: "0.1.0",
+});
+async function main() {
+    const apiKey = process.env.LUMA_API_KEY;
+    if (!apiKey) {
+        console.error("Missing LUMA_API_KEY environment variable");
+        process.exit(1);
+    }
+    const client = new LumaClient(apiKey);
+    try {
+        await client.testConnection();
+    }
+    catch (error) {
+        console.error("Failed to connect to Luma API:", error);
+        process.exit(1);
+    }
+    registerGetCalendar(client, server);
+    registerListEvents(client, server);
+    registerGetEvent(client, server);
+    registerListGuests(client, server);
+    registerGetGuest(client, server);
+    registerListTicketTypes(client, server);
+    registerCreateEvent(client, server);
+    registerUpdateEvent(client, server);
+    registerAddGuests(client, server);
+    registerUpdateGuestStatus(client, server);
+    registerSendInvites(client, server);
+    registerCreateTicketType(client, server);
+    registerListCoupons(client, server);
+    registerCreateCoupon(client, server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main();

package/dist/luma-client.js

@@ -0,0 +1,68 @@
+const DEFAULT_BASE_URL = "https://public-api.luma.com";
+export class LumaApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Luma API ${status}: ${body}`);
+        this.status = status;
+        this.body = body;
+        this.name = "LumaApiError";
+    }
+}
+export class LumaClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl ?? process.env.LUMA_BASE_URL ?? DEFAULT_BASE_URL;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            "x-luma-api-key": this.apiKey,
+            "content-type": "application/json",
+        };
+        const res = await fetch(url, {
+            method,
+            headers,
+            ...(body !== undefined && { body: JSON.stringify(body) }),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new LumaApiError(res.status, text);
+        }
+        return text ? JSON.parse(text) : undefined;
+    }
+    async paginate(path, params) {
+        const all = [];
+        let cursor;
+        do {
+            const searchParams = new URLSearchParams(params);
+            if (cursor)
+                searchParams.set("pagination_cursor", cursor);
+            const query = searchParams.toString();
+            const fullPath = query ? `${path}?${query}` : path;
+            const page = await this.request("GET", fullPath);
+            all.push(...page.entries);
+            cursor = page.has_more ? page.next_cursor : undefined;
+        } while (cursor);
+        return all;
+    }
+    async paginateSingle(path, params, paginationLimit, paginationCursor) {
+        const searchParams = new URLSearchParams(params);
+        if (paginationLimit)
+            searchParams.set("pagination_limit", String(paginationLimit));
+        if (paginationCursor)
+            searchParams.set("pagination_cursor", paginationCursor);
+        const query = searchParams.toString();
+        const fullPath = query ? `${path}?${query}` : path;
+        const page = await this.request("GET", fullPath);
+        return {
+            entries: page.entries,
+            next_cursor: page.has_more ? page.next_cursor : undefined,
+        };
+    }
+    async testConnection() {
+        await this.request("GET", "/v1/calendar/get");
+    }
+}

package/dist/tools/add-guests.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+const guestSchema = z.object({
+    email: z.string().describe("Guest email address"),
+    name: z.string().optional().describe("Guest display name"),
+    phone_number: z.string().optional().describe("Phone number"),
+});
+export const addGuestsDefinition = {
+    name: "add-guests",
+    description: "Add guests to an event. By default guests are approved and receive one default ticket.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        guests: z.array(guestSchema).describe("Array of guest objects with email"),
+        approval_status: z
+            .enum(["approved", "pending_approval", "waitlist"])
+            .optional()
+            .describe("Approval status for added guests (default: approved)"),
+        send_email: z
+            .boolean()
+            .optional()
+            .describe("Send notification email (default: true)"),
+        ticket: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Ticket type to assign to all guests"),
+    },
+    returns: "Confirmation of added guests",
+};
+export function registerAddGuests(client, server) {
+    server.registerTool(addGuestsDefinition.name, {
+        description: addGuestsDefinition.description,
+        inputSchema: addGuestsDefinition.inputSchema,
+    }, async (args) => {
+        const body = {
+            event_id: args.event_id,
+            guests: args.guests,
+        };
+        if (args.approval_status !== undefined)
+            body.approval_status = args.approval_status;
+        if (args.send_email !== undefined)
+            body.send_email = args.send_email;
+        if (args.ticket !== undefined)
+            body.ticket = args.ticket;
+        const data = await client.request("POST", "/v1/event/add-guests", body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/create-coupon.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export const createCouponDefinition = {
+    name: "create-coupon",
+    description: "Create a coupon for an event. Coupon terms cannot be edited after creation.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        code: z.string().describe("Coupon code (1-20 chars, case-insensitive)"),
+        discount: z
+            .record(z.string(), z.unknown())
+            .describe("Discount object (e.g. { type: 'percent', percent_off: 20 })"),
+        remaining_count: z
+            .number()
+            .optional()
+            .describe("Number of uses (0-1000000; use 1000000 for unlimited)"),
+        valid_start_at: z.string().optional().describe("Validity start (ISO 8601)"),
+        valid_end_at: z.string().optional().describe("Validity end (ISO 8601)"),
+    },
+    returns: "The created coupon object",
+};
+export function registerCreateCoupon(client, server) {
+    server.registerTool(createCouponDefinition.name, {
+        description: createCouponDefinition.description,
+        inputSchema: createCouponDefinition.inputSchema,
+    }, async (args) => {
+        const body = {
+            event_id: args.event_id,
+            code: args.code,
+            discount: args.discount,
+        };
+        if (args.remaining_count !== undefined)
+            body.remaining_count = args.remaining_count;
+        if (args.valid_start_at !== undefined)
+            body.valid_start_at = args.valid_start_at;
+        if (args.valid_end_at !== undefined)
+            body.valid_end_at = args.valid_end_at;
+        const data = await client.request("POST", "/v1/event/create-coupon", body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/create-event.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+export const createEventDefinition = {
+    name: "create-event",
+    description: "Create a new event on the calendar",
+    inputSchema: {
+        name: z.string().describe("Event title"),
+        start_at: z
+            .string()
+            .datetime({ offset: true })
+            .describe("Start datetime (ISO 8601)"),
+        timezone: z.string().describe("IANA timezone (e.g. America/New_York)"),
+        end_at: z
+            .string()
+            .datetime({ offset: true })
+            .optional()
+            .describe("End datetime (ISO 8601)"),
+        description_md: z
+            .string()
+            .optional()
+            .describe("Event description in markdown"),
+        meeting_url: z.string().optional().describe("Virtual event URL"),
+        geo_address_json: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Address object with city, place, etc."),
+        geo_latitude: z.number().optional().describe("Latitude"),
+        geo_longitude: z.number().optional().describe("Longitude"),
+        cover_url: z
+            .string()
+            .optional()
+            .describe("Cover image URL (must be Luma CDN)"),
+        visibility: z
+            .enum(["public", "members-only", "private"])
+            .optional()
+            .describe("Event visibility"),
+        max_capacity: z.number().optional().describe("Maximum attendee capacity"),
+    },
+    returns: "The created event object",
+};
+export function registerCreateEvent(client, server) {
+    server.registerTool(createEventDefinition.name, {
+        description: createEventDefinition.description,
+        inputSchema: createEventDefinition.inputSchema,
+    }, async (args) => {
+        const body = {
+            name: args.name,
+            start_at: args.start_at,
+            timezone: args.timezone,
+        };
+        if (args.end_at !== undefined)
+            body.end_at = args.end_at;
+        if (args.description_md !== undefined)
+            body.description_md = args.description_md;
+        if (args.meeting_url !== undefined)
+            body.meeting_url = args.meeting_url;
+        if (args.geo_address_json !== undefined)
+            body.geo_address_json = args.geo_address_json;
+        if (args.geo_latitude !== undefined)
+            body.coordinate = {
+                latitude: args.geo_latitude,
+                longitude: args.geo_longitude,
+            };
+        if (args.cover_url !== undefined)
+            body.cover_url = args.cover_url;
+        if (args.visibility !== undefined)
+            body.visibility = args.visibility;
+        if (args.max_capacity !== undefined)
+            body.max_capacity = args.max_capacity;
+        const data = await client.request("POST", "/v1/event/create", body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/create-ticket-type.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export const createTicketTypeDefinition = {
+    name: "create-ticket-type",
+    description: "Create a new ticket type for an event",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        name: z.string().describe("Ticket type name"),
+        type: z.enum(["free", "paid"]).describe("Ticket pricing type"),
+        require_approval: z.boolean().optional().describe("Require host approval"),
+        is_hidden: z.boolean().optional().describe("Hide from public listing"),
+        description: z.string().optional().describe("Ticket type description"),
+        max_capacity: z.number().optional().describe("Maximum tickets available"),
+        cents: z.number().optional().describe("Price in cents (for paid tickets)"),
+        currency: z.string().optional().describe("Currency code (e.g. USD, EUR)"),
+    },
+    returns: "The created ticket type object",
+};
+export function registerCreateTicketType(client, server) {
+    server.registerTool(createTicketTypeDefinition.name, {
+        description: createTicketTypeDefinition.description,
+        inputSchema: createTicketTypeDefinition.inputSchema,
+    }, async (args) => {
+        const body = {
+            event_id: args.event_id,
+            name: args.name,
+            type: args.type,
+        };
+        if (args.require_approval !== undefined)
+            body.require_approval = args.require_approval;
+        if (args.is_hidden !== undefined)
+            body.is_hidden = args.is_hidden;
+        if (args.description !== undefined)
+            body.description = args.description;
+        if (args.max_capacity !== undefined)
+            body.max_capacity = args.max_capacity;
+        if (args.cents !== undefined)
+            body.cents = args.cents;
+        if (args.currency !== undefined)
+            body.currency = args.currency;
+        const data = await client.request("POST", "/v1/event/ticket-types/create", body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/get-calendar.js

@@ -0,0 +1,17 @@
+export const getCalendarDefinition = {
+    name: "get-calendar",
+    description: "Get the calendar associated with the current API key",
+    inputSchema: {},
+    returns: "Calendar object with api_id, name, and geo fields",
+};
+export function registerGetCalendar(client, server) {
+    server.registerTool(getCalendarDefinition.name, {
+        description: getCalendarDefinition.description,
+        inputSchema: getCalendarDefinition.inputSchema,
+    }, async () => {
+        const data = await client.request("GET", "/v1/calendar/get");
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/get-event.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export const getEventDefinition = {
+    name: "get-event",
+    description: "Get admin details of a specific event by its ID",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+    },
+    returns: "Full event object including name, dates, location, description, and ticket info",
+};
+export function registerGetEvent(client, server) {
+    server.registerTool(getEventDefinition.name, {
+        description: getEventDefinition.description,
+        inputSchema: getEventDefinition.inputSchema,
+    }, async (args) => {
+        const data = await client.request("GET", `/v1/event/get?id=${encodeURIComponent(args.event_id)}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/get-guest.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export const getGuestDefinition = {
+    name: "get-guest",
+    description: "Get detailed info for a single event guest. The id field accepts a guest ID (gst-...), guest key (g-...), ticket key, or email address.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        id: z
+            .string()
+            .describe("Guest identifier: guest ID (gst-...), guest key (g-...), or email"),
+    },
+    returns: "Full guest object with approval status, ticket info, event_ticket_orders, and profile",
+};
+export function registerGetGuest(client, server) {
+    server.registerTool(getGuestDefinition.name, {
+        description: getGuestDefinition.description,
+        inputSchema: getGuestDefinition.inputSchema,
+    }, async (args) => {
+        const params = new URLSearchParams({
+            event_id: args.event_id,
+            id: args.id,
+        });
+        const data = await client.request("GET", `/v1/event/get-guest?${params.toString()}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/list-coupons.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export const listCouponsDefinition = {
+    name: "list-coupons",
+    description: "List all coupons for an event. Without pagination params, returns all coupons; with them, returns one page.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        pagination_limit: z.number().optional().describe("Page size"),
+        pagination_cursor: z
+            .string()
+            .optional()
+            .describe("Cursor from a previous page"),
+    },
+    returns: "Array of coupon objects, or paginated result with next_cursor",
+};
+export function registerListCoupons(client, server) {
+    server.registerTool(listCouponsDefinition.name, {
+        description: listCouponsDefinition.description,
+        inputSchema: listCouponsDefinition.inputSchema,
+    }, async (args) => {
+        const params = { event_id: args.event_id };
+        const usePagination = args.pagination_limit !== undefined ||
+            args.pagination_cursor !== undefined;
+        if (usePagination) {
+            const result = await client.paginateSingle("/v1/event/coupons", params, args.pagination_limit, args.pagination_cursor);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+            };
+        }
+        const entries = await client.paginate("/v1/event/coupons", params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(entries) }],
+        };
+    });
+}

package/dist/tools/list-events.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export const listEventsDefinition = {
+    name: "list-events",
+    description: "List events for the calendar. Optionally filter by date range. Without pagination params, returns all events; with them, returns one page.",
+    inputSchema: {
+        after: z
+            .string()
+            .optional()
+            .describe("Only events starting after this ISO 8601 datetime"),
+        before: z
+            .string()
+            .optional()
+            .describe("Only events starting before this ISO 8601 datetime"),
+        pagination_limit: z.number().optional().describe("Page size (max 50)"),
+        pagination_cursor: z
+            .string()
+            .optional()
+            .describe("Cursor from a previous page"),
+    },
+    returns: "Array of event objects, or paginated result with next_cursor",
+};
+export function registerListEvents(client, server) {
+    server.registerTool(listEventsDefinition.name, {
+        description: listEventsDefinition.description,
+        inputSchema: listEventsDefinition.inputSchema,
+    }, async (args) => {
+        const params = {};
+        if (args.after)
+            params.after = args.after;
+        if (args.before)
+            params.before = args.before;
+        const usePagination = args.pagination_limit !== undefined ||
+            args.pagination_cursor !== undefined;
+        if (usePagination) {
+            const result = await client.paginateSingle("/v1/calendar/list-events", params, args.pagination_limit, args.pagination_cursor);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+            };
+        }
+        const entries = await client.paginate("/v1/calendar/list-events", params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(entries) }],
+        };
+    });
+}

package/dist/tools/list-guests.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+export const listGuestsDefinition = {
+    name: "list-guests",
+    description: "List guests for an event. Without pagination params, returns all guests; with them, returns one page.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        approval_status: z
+            .enum([
+            "approved",
+            "session",
+            "pending_approval",
+            "invited",
+            "declined",
+            "waitlist",
+        ])
+            .optional()
+            .describe("Filter by approval status"),
+        sort_column: z
+            .enum(["name", "email", "created_at", "registered_at", "checked_in_at"])
+            .optional()
+            .describe("Sort column"),
+        pagination_limit: z.number().optional().describe("Page size"),
+        pagination_cursor: z
+            .string()
+            .optional()
+            .describe("Cursor from a previous page"),
+    },
+    returns: "Array of guest objects, or paginated result with next_cursor",
+};
+export function registerListGuests(client, server) {
+    server.registerTool(listGuestsDefinition.name, {
+        description: listGuestsDefinition.description,
+        inputSchema: listGuestsDefinition.inputSchema,
+    }, async (args) => {
+        const params = {
+            event_id: args.event_id,
+        };
+        if (args.approval_status)
+            params.approval_status = args.approval_status;
+        if (args.sort_column)
+            params.sort_column = args.sort_column;
+        const usePagination = args.pagination_limit !== undefined ||
+            args.pagination_cursor !== undefined;
+        if (usePagination) {
+            const result = await client.paginateSingle("/v1/event/get-guests", params, args.pagination_limit, args.pagination_cursor);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+            };
+        }
+        const entries = await client.paginate("/v1/event/get-guests", params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(entries) }],
+        };
+    });
+}

package/dist/tools/list-ticket-types.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export const listTicketTypesDefinition = {
+    name: "list-ticket-types",
+    description: "List all ticket types for an event",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+    },
+    returns: "Array of ticket type objects with name, price, and availability info",
+};
+export function registerListTicketTypes(client, server) {
+    server.registerTool(listTicketTypesDefinition.name, {
+        description: listTicketTypesDefinition.description,
+        inputSchema: listTicketTypesDefinition.inputSchema,
+    }, async (args) => {
+        const data = await client.request("GET", `/v1/event/ticket-types/list?event_id=${encodeURIComponent(args.event_id)}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/send-invites.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+const inviteGuestSchema = z.object({
+    email: z.string().describe("Guest email address"),
+    message: z
+        .string()
+        .optional()
+        .describe("Personalized invite message (max 200 chars)"),
+});
+export const sendInvitesDefinition = {
+    name: "send-invites",
+    description: "Send invites to guests for an event. Sends email and SMS if phone is linked.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        guests: z
+            .array(inviteGuestSchema)
+            .describe("Array of guest objects with email and optional message"),
+    },
+    returns: "Confirmation of sent invites",
+};
+export function registerSendInvites(client, server) {
+    server.registerTool(sendInvitesDefinition.name, {
+        description: sendInvitesDefinition.description,
+        inputSchema: sendInvitesDefinition.inputSchema,
+    }, async (args) => {
+        const data = await client.request("POST", "/v1/event/send-invites", {
+            event_id: args.event_id,
+            guests: args.guests,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/update-event.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+export const updateEventDefinition = {
+    name: "update-event",
+    description: "Update an existing event. Only provided fields are changed.",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        suppress_notifications: z
+            .boolean()
+            .optional()
+            .describe("Prevent guest notifications for name/time/location changes"),
+        name: z.string().optional().describe("Event title"),
+        start_at: z
+            .string()
+            .datetime({ offset: true })
+            .optional()
+            .describe("Start datetime (ISO 8601)"),
+        end_at: z
+            .string()
+            .datetime({ offset: true })
+            .optional()
+            .describe("End datetime (ISO 8601)"),
+        timezone: z.string().optional().describe("IANA timezone"),
+        description_md: z
+            .string()
+            .optional()
+            .describe("Event description in markdown"),
+        meeting_url: z.string().optional().describe("Virtual event URL"),
+        cover_url: z.string().optional().describe("Cover image URL"),
+        visibility: z
+            .enum(["public", "members-only", "private"])
+            .optional()
+            .describe("Event visibility"),
+        max_capacity: z.number().optional().describe("Maximum attendee capacity"),
+    },
+    returns: "The updated event object",
+};
+export function registerUpdateEvent(client, server) {
+    server.registerTool(updateEventDefinition.name, {
+        description: updateEventDefinition.description,
+        inputSchema: updateEventDefinition.inputSchema,
+    }, async (args) => {
+        const body = { event_id: args.event_id };
+        if (args.suppress_notifications !== undefined)
+            body.suppress_notifications = args.suppress_notifications;
+        if (args.name !== undefined)
+            body.name = args.name;
+        if (args.start_at !== undefined)
+            body.start_at = args.start_at;
+        if (args.end_at !== undefined)
+            body.end_at = args.end_at;
+        if (args.timezone !== undefined)
+            body.timezone = args.timezone;
+        if (args.description_md !== undefined)
+            body.description_md = args.description_md;
+        if (args.meeting_url !== undefined)
+            body.meeting_url = args.meeting_url;
+        if (args.cover_url !== undefined)
+            body.cover_url = args.cover_url;
+        if (args.visibility !== undefined)
+            body.visibility = args.visibility;
+        if (args.max_capacity !== undefined)
+            body.max_capacity = args.max_capacity;
+        const data = await client.request("POST", "/v1/event/update", body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/dist/tools/update-guest-status.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export const updateGuestStatusDefinition = {
+    name: "update-guest-status",
+    description: "Update a guest's approval status (approve or decline)",
+    inputSchema: {
+        event_id: z.string().describe("Event ID (e.g. evt-...)"),
+        guest: z
+            .record(z.string(), z.unknown())
+            .describe("Guest identifier object (e.g. { email: '...' } or { id: 'gst-...' })"),
+        status: z
+            .enum(["approved", "declined"])
+            .describe("New status for the guest"),
+        should_refund: z
+            .boolean()
+            .optional()
+            .describe("Refund the guest if declining a paid ticket"),
+    },
+    returns: "Confirmation of status update",
+};
+export function registerUpdateGuestStatus(client, server) {
+    server.registerTool(updateGuestStatusDefinition.name, {
+        description: updateGuestStatusDefinition.description,
+        inputSchema: updateGuestStatusDefinition.inputSchema,
+    }, async (args) => {
+        const body = {
+            event_id: args.event_id,
+            guest: args.guest,
+            status: args.status,
+        };
+        if (args.should_refund !== undefined)
+            body.should_refund = args.should_refund;
+        const data = await client.request("POST", "/v1/event/update-guest-status", body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+        };
+    });
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+	"name": "luma-events-mcp",
+	"mcpName": "io.github.bettervibe-org/luma-events-mcp",
+	"description": "A Luma Calendar MCP server exposing event, guest, and ticket operations as tools for AI assistants.",
+	"version": "0.1.0",
+	"main": "dist/index.js",
+	"type": "module",
+	"bin": {
+		"luma-events-mcp": "dist/index.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsc && shx chmod +x dist/*.js",
+		"dev": "tsx --watch --env-file=.env src/index.ts",
+		"prepare": "lefthook install",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage",
+		"check": "biome check .",
+		"check:fix": "biome check --write .",
+		"check:ci": "biome ci .",
+		"docs": "tsx scripts/gen-tool-docs.ts",
+		"docs:check": "tsx scripts/gen-tool-docs.ts --check",
+		"validate": "npm run check && npm test && npm run knip && npm run docs:check && npm run build",
+		"smoke": "npm run build && tsx --env-file=.env scripts/smoke.ts",
+		"watch": "tsc --watch",
+		"semantic-release": "semantic-release",
+		"knip": "knip"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/bettervibe-org/luma-events-mcp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/bettervibe-org/luma-events-mcp/issues"
+	},
+	"homepage": "https://github.com/bettervibe-org/luma-events-mcp#readme",
+	"author": "Dominik Grusemann",
+	"license": "MIT",
+	"engines": {
+		"node": ">=18.0.0",
+		"npm": ">=9.0.0"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"zod": "^4.4.3"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.15",
+		"@commitlint/cli": "^21.0.1",
+		"@commitlint/config-conventional": "^21.0.1",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/github": "^12.0.8",
+		"@semantic-release/npm": "^13.1.5",
+		"@types/node": "^25.9.1",
+		"@vitest/coverage-v8": "^4.1.7",
+		"knip": "^6.14.2",
+		"lefthook": "^2.1.8",
+		"semantic-release": "^25.0.3",
+		"shx": "^0.4.0",
+		"tsx": "^4.22.3",
+		"typescript": "^6.0.3",
+		"vitest": "^4.1.7"
+	}
+}