Luma MCP server for AI agents

Let Claude, ChatGPT or your own agent read Luma: 5 typed functions through one MCP server. No Luma API key needed.

Functions
5
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Luma

An MCP server for Luma alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/luma
Every site

One MCP server for Luma and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 5
  • discoverEventsSearch and discover upcoming Luma events in a city by free-text keyword query (retail, loss prevention, robotics.

    Arguments

    NameTypeRequired
    placestringYes
    categorystringNo
    datestring
    YYYY-MM-DD, the event's own local day.
    No
    querystring
    Free-text keyword ("retail", "robotics"), matched by Luma's own search within the city.
    No
    limitnumber
    Default 50, at most 1000.
    No

    Returns LumaEvent[]

    interface LumaEvent {
      id: string;
      slug: string;
      url: string;
      name: string;
      startAt: string;
      endAt: string | null;
      timezone: string | null;
      localStart: string | null;
      locationType: string | null;
      venue: string | null;
      address: string | null;
      city: string | null;
      latitude: number | null;
      longitude: number | null;
      isFree: boolean | null;
      price: { cents: number; currency: string } | null;
      spotsRemaining: number | null;
      isSoldOut: boolean;
      requiresApproval: boolean;
      guestCount: number | null;
      hosts: string[];
      /** The hosts again, with what each publishes on Luma. */
      hostDetails: LumaHost[];
      /** Pass this straight to listCalendarEvents({ calendar }). `name` is a label, never an argument. */
      calendar: LumaCalendar | null;
      categories: string[];
      coverUrl: string | null;
      description: string | null;
      /** The RSVP / application form, in order. null on discover and calendar rows. */
      registrationQuestions: LumaRegistrationQuestion[] | null;
    }
    
    interface LumaRegistrationQuestion {
      id: string;
      label: string;
      required: boolean;
      /** text, long-text, select, multi-select, url, linkedin, github, company, terms… */
      type: string;
      /** A select's choices; [] otherwise. */
      options: string[];
      /** A terms question's text as markdown. */
      terms: string | null;
    }
    
    interface LumaCalendar {
      /** cal-… */
      id: string;
      name: string | null;
      slug: string | null;
      url: string | null;
      /** The owner's own website, e.g. "https://modal.com". */
      website: string | null;
    }
    
    interface LumaHost {
      id: string | null;
      name: string;
      /** https://www.linkedin.com/in/<slug>; null for a company page or none. */
      linkedin: string | null;
      /** https://x.com/<handle> */
      x: string | null;
      website: string | null;
      bio: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/luma/discoverEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.luma.discoverEvents({ place: "sf" });
  • getEventReads one Luma event page (luma.com/<slug> or lu.ma/<slug>) and returns its date, time and timezone, venue and full address, price, spots remaining…

    Arguments

    NameTypeRequired
    urlstringYes

    Returns LumaEvent

    interface LumaEvent {
      id: string;
      slug: string;
      url: string;
      name: string;
      startAt: string;
      endAt: string | null;
      timezone: string | null;
      localStart: string | null;
      locationType: string | null;
      venue: string | null;
      address: string | null;
      city: string | null;
      latitude: number | null;
      longitude: number | null;
      isFree: boolean | null;
      price: { cents: number; currency: string } | null;
      spotsRemaining: number | null;
      isSoldOut: boolean;
      requiresApproval: boolean;
      guestCount: number | null;
      hosts: string[];
      /** The hosts again, with what each publishes on Luma. */
      hostDetails: LumaHost[];
      /** Pass this straight to listCalendarEvents({ calendar }). `name` is a label, never an argument. */
      calendar: LumaCalendar | null;
      categories: string[];
      coverUrl: string | null;
      description: string | null;
      /** The RSVP / application form, in order. null on discover and calendar rows. */
      registrationQuestions: LumaRegistrationQuestion[] | null;
    }
    
    interface LumaRegistrationQuestion {
      id: string;
      label: string;
      required: boolean;
      /** text, long-text, select, multi-select, url, linkedin, github, company, terms… */
      type: string;
      /** A select's choices; [] otherwise. */
      options: string[];
      /** A terms question's text as markdown. */
      terms: string | null;
    }
    
    interface LumaCalendar {
      /** cal-… */
      id: string;
      name: string | null;
      slug: string | null;
      url: string | null;
      /** The owner's own website, e.g. "https://modal.com". */
      website: string | null;
    }
    
    interface LumaHost {
      id: string | null;
      name: string;
      /** https://www.linkedin.com/in/<slug>; null for a company page or none. */
      linkedin: string | null;
      /** https://x.com/<handle> */
      x: string | null;
      website: string | null;
      bio: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/luma/getEvent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.luma.getEvent({ url: "<url>" });
  • listCalendarEventsLists every upcoming event on one Luma calendar or organizer profile page (luma.com/genai-sf, luma.com/workos, luma.com/sftw).

    Arguments

    NameTypeRequired
    calendarstring | LumaCalendar
    An event's calendar as returned, its id (cal-…) or url, or any luma.com calendar, profile or event url or slug.
    Yes
    pastbooleanNo
    limitnumber
    Default 50, at most 1000.
    No

    Returns LumaEvent[]

    interface LumaEvent {
      id: string;
      slug: string;
      url: string;
      name: string;
      startAt: string;
      endAt: string | null;
      timezone: string | null;
      localStart: string | null;
      locationType: string | null;
      venue: string | null;
      address: string | null;
      city: string | null;
      latitude: number | null;
      longitude: number | null;
      isFree: boolean | null;
      price: { cents: number; currency: string } | null;
      spotsRemaining: number | null;
      isSoldOut: boolean;
      requiresApproval: boolean;
      guestCount: number | null;
      hosts: string[];
      /** The hosts again, with what each publishes on Luma. */
      hostDetails: LumaHost[];
      /** Pass this straight to listCalendarEvents({ calendar }). `name` is a label, never an argument. */
      calendar: LumaCalendar | null;
      categories: string[];
      coverUrl: string | null;
      description: string | null;
      /** The RSVP / application form, in order. null on discover and calendar rows. */
      registrationQuestions: LumaRegistrationQuestion[] | null;
    }
    
    interface LumaRegistrationQuestion {
      id: string;
      label: string;
      required: boolean;
      /** text, long-text, select, multi-select, url, linkedin, github, company, terms… */
      type: string;
      /** A select's choices; [] otherwise. */
      options: string[];
      /** A terms question's text as markdown. */
      terms: string | null;
    }
    
    interface LumaCalendar {
      /** cal-… */
      id: string;
      name: string | null;
      slug: string | null;
      url: string | null;
      /** The owner's own website, e.g. "https://modal.com". */
      website: string | null;
    }
    
    interface LumaHost {
      id: string | null;
      name: string;
      /** https://www.linkedin.com/in/<slug>; null for a company page or none. */
      linkedin: string | null;
      /** https://x.com/<handle> */
      x: string | null;
      website: string | null;
      bio: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/luma/listCalendarEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.luma.listCalendarEvents({ calendar: "genai-sf" });
  • listCategoriesLists Luma's discover topic categories with the category slug discoverEvents takes.

    Arguments

    None.

    Returns LumaCategory[]

    interface LumaCategory {
      slug: string;
      name: string;
      eventCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/luma/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.luma.listCategories();
  • listPlacesLists every city Luma's discover page covers, with the place slug discoverEvents takes.

    Arguments

    None.

    Returns LumaPlace[]

    interface LumaPlace {
      slug: string;
      name: string;
      eventCount: number | null;
      timezone: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/luma/listPlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.luma.listPlaces();

Use it from code