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.
- Site
- luma.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/lumaOne MCP server for Luma and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
discoverEventsSearch and discover upcoming Luma events in a city by free-text keyword query (retail, loss prevention, robotics.Arguments
Name Type Required placestringYes categorystringNo datestringYYYY-MM-DD, the event's own local day.No querystringFree-text keyword ("retail", "robotics"), matched by Luma's own search within the city.No limitnumberDefault 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/discoverEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.luma.discoverEvents({ place: "sf" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.luma.discoverEvents({"place": "sf"}))curl -X POST https://api.bowmark.ai/v1/sites/luma/discoverEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"sf"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
LumaEventinterface 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/getEventCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.luma.getEvent({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.luma.getEvent({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/luma/getEvent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required calendarstring | LumaCalendarAn event's calendar as returned, its id (cal-…) or url, or any luma.com calendar, profile or event url or slug.Yes pastbooleanNo limitnumberDefault 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/listCalendarEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.luma.listCalendarEvents({ calendar: "genai-sf" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.luma.listCalendarEvents({"calendar": "genai-sf"}))curl -X POST https://api.bowmark.ai/v1/sites/luma/listCalendarEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"calendar":"genai-sf"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.luma.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.luma.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/luma/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listPlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.luma.listPlaces();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.luma.listPlaces())curl -X POST https://api.bowmark.ai/v1/sites/luma/listPlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.luma.listPlaces();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/luma/<function> - OpenAPI
/v1/sites/luma/openapi.json