Skip to content

Events

Community events: events, sessions, guests, check-in, tasks, expenses, and photos. The event-guest tools from the former interview MCP (guest add/link + Discord-id resolution for dispatch) now live here.

Endpoint https://events.mcp.devfellowship.com/mcp
Tools 24 in 6 groups
Package packages/dfl-mcp-events
Auth Your dfl-auth login token as Authorization: Bearer <token>. Every call runs as you, under RLS. See Auth & security.
.mcp.json
{
"mcpServers": {
"dfl-events": {
"type": "http",
"url": "https://events.mcp.devfellowship.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
}
}
}

Other clients (Cursor, VS Code, codex, the Anthropic SDK): see Getting started, step 3.

Backing dataevents schema (events, sessions, guests, expenses, photos, tasks).

Find, create and edit events.

list_events

List all events with optional filters.

List Events

List all events with optional filters. Each event carries strategy_business_unit_id (its business unit in strategy.business_units).

ParameterTypeRequiredDescription
limitnumbernoMaximum number of events to return (default: 50, max: 100)
offsetnumbernoNumber of events to skip (for pagination)
searchstringnoSearch by event name.
strategy_business_unit_idstringnoOnly events of this business unit (UUID of strategy.business_units)

get_event

Get a specific event by ID, including strategy_business_unit_id (its business unit in strategy.business_units).

Get Event

Get a specific event by ID, including strategy_business_unit_id (its business unit in strategy.business_units).

ParameterTypeRequiredDescription
idstringyesThe UUID of the event.

create_event

Create a new event in a business unit (strategy_business_unit_id is required).

Create Event

Create a new event in a business unit (strategy_business_unit_id is required).

ParameterTypeRequiredDescription
namestringyesEvent name.
strategy_business_unit_idstringyesBusiness unit of the event (UUID of strategy.business_units)
descriptionstringnoEvent description.
locationstringnoEvent location.
latitudenumbernoEvent latitude.
longitudenumbernoEvent longitude.
start_atstringnoEvent start timestamp (ISO format)
end_atstringnoEvent end timestamp (ISO format)

update_event

Update an existing event.

Update Event

Update an existing event.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event to update.
namestringnoEvent name.
strategy_business_unit_idstringnoMove the event to this business unit (UUID of strategy.business_units)
descriptionstringnoEvent description.
locationstringnoEvent location.
latitudenumbernoEvent latitude.
longitudenumbernoEvent longitude.
start_atstringnoEvent start timestamp (ISO format)
end_atstringnoEvent end timestamp (ISO format)

The schedule of an event: its sessions.

list_event_sessions

List sessions for an event with optional filters.

List Event Sessions

List sessions for an event with optional filters.

ParameterTypeRequiredDescription
event_idstringyesFilter by event ID.
limitnumbernoMaximum number of sessions to return (default: 50, max: 100)
offsetnumbernoNumber of sessions to skip (for pagination)
searchstringnoSearch by session title.

create_event_session

Create a new event session.

Create Event Session

Create a new event session.

ParameterTypeRequiredDescription
event_idstringyesEvent ID.
titlestringyesSession title.
descriptionstringnoSession description.
locationstringnoSession location.
start_timestringnoSession start time (ISO format)
end_timestringnoSession end time (ISO format)
ordernumbernoDisplay order.
guest_idsstring[]noArray of guest UUIDs assigned to the session.

update_event_session

Update an existing event session.

Update Event Session

Update an existing event session.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event session to update.
titlestringnoSession title.
descriptionstringnoSession description.
locationstringnoSession location.
start_timestringnoSession start time (ISO format)
end_timestringnoSession end time (ISO format)
ordernumbernoDisplay order.
guest_idsstring[]noArray of guest UUIDs assigned to the session.

The guest list: add guests, check them in at the door, and find their Discord id.

list_event_guests

List guests for an event with optional filters.

List Event Guests

List guests for an event with optional filters.

ParameterTypeRequiredDescription
event_idstringyesFilter by event ID.
limitnumbernoMaximum number of guests to return (default: 50, max: 100)
offsetnumbernoNumber of guests to skip (for pagination)
rolestringnoFilter by guest role.
member_idstringnoFilter by member ID.
searchstringnoSearch by guest name.

get_event_guest

Get a specific event guest by ID.

Get Event Guest

Get a specific event guest by ID.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event guest.

create_event_guest

Create a new event guest.

Create Event Guest

Create a new event guest.

ParameterTypeRequiredDescription
event_idstringyesEvent ID.
namestringyesGuest name.
emailstringnoGuest email.
phone_numberstringnoGuest phone number.
rolestringnoGuest role.
member_idstringnoLinked member ID.
discord_idstringnoLinked Discord user id (snowflake)
tagsobjectnoArbitrary tags (JSON object)

update_event_guest

Update an existing event guest.

Update Event Guest

Update an existing event guest.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event guest to update.
namestringnoGuest name.
emailstringnoGuest email.
phone_numberstringnoGuest phone number.
rolestringnoGuest role.
member_idstringnoLinked member ID.
discord_idstringnoLinked Discord user id (snowflake)
check_in_atstringnoCheck-in timestamp (ISO format)
tagsobjectnoArbitrary tags (JSON object)

check_in_guest

Check in an event guest by setting check_in_at to the current timestamp.

Check In Guest

Check in an event guest by setting check_in_at to the current timestamp.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event guest to check in.

add_event_guest

Add or link a guest for an event (the interview dispatch audience).

Add Event Guest

Add or link a guest for an event (the interview dispatch audience). Stores phone_number (WhatsApp), discord_id (Discord-only guests), member_id (link to a member, nullable), role/tags (e.g. cohort).

ParameterTypeRequiredDescription
event_idstringyesEvent id (event_management.events)
namestringyesGuest display name.
emailstringnoGuest email.
phone_numberstringnoWhatsApp number in E.164-ish digits (for channel=whatsapp dispatch)
discord_idstringnoDiscord user id / handle (for channel=discord dispatch; non-member guests)
member_idstringnoLinked member id (nullable for non-member guests)
backfill_discordbooleannoWhen member_id is set and no discord_id is given, backfill discord_id from the linked profile (default true)
rolestringnoGuest role, e.g. "lider", "fellow".
tagsobjectnoArbitrary tags JSON (e.g. {"cohort":"lideres"})

resolve_discord_id

Preview how a recipient resolves to a Discord id for channel=discord dispatch, via precedence: event_guests.discord_id override > member→profile (profiles.discord_user_id) > none.

Resolve Discord Id (preview)

Preview how a recipient resolves to a Discord id for channel=discord dispatch, via precedence: event_guests.discord_id override > member→profile (profiles.discord_user_id) > none. Read-only; sends nothing. Returns { resolved, source, masked_discord_id, reason }.

ParameterTypeRequiredDescription
guest_idstringnoevent_management.event_guests.id — checked first for an explicit override.
member_idstringnopublic.members.id — falls back to the linked profile discord_user_id.

The to-do list of an event.

list_event_tasks

List tasks for an event with optional filters.

List Event Tasks

List tasks for an event with optional filters.

ParameterTypeRequiredDescription
event_idstringyesFilter by event ID.
limitnumbernoMaximum number of tasks to return (default: 50, max: 100)
offsetnumbernoNumber of tasks to skip (for pagination)
assignee_idstringnoFilter by assignee (member) ID.
statusenumnoFilter by status. One of: todo, in_progress, done.
searchstringnoSearch by task title.

create_event_task

Create a new event task.

Create Event Task

Create a new event task.

ParameterTypeRequiredDescription
event_idstringyesEvent ID.
titlestringyesTask title.
descriptionstringnoTask description.
assignee_idstringnoAssignee (member) ID.
statusenumnoTask status. One of: todo, in_progress, done.
start_datestringnoStart date (ISO format)
due_datestringnoDue date (ISO format)

update_event_task

Update an existing event task.

Update Event Task

Update an existing event task.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event task to update.
titlestringnoTask title.
descriptionstringnoTask description.
assignee_idstringnoAssignee (member) ID.
statusenumnoTask status. One of: todo, in_progress, done.
start_datestringnoStart date (ISO format)
due_datestringnoDue date (ISO format)

What an event costs: record and edit its expenses.

list_event_expenses

List expenses for an event with optional filters.

List Event Expenses

List expenses for an event with optional filters.

ParameterTypeRequiredDescription
event_idstringyesFilter by event ID.
limitnumbernoMaximum number of expenses to return (default: 50, max: 100)
offsetnumbernoNumber of expenses to skip (for pagination)
vendor_categorystringnoFilter by vendor category.
searchstringnoSearch by vendor name.

create_event_expense

Create a new event expense.

Create Event Expense

Create a new event expense.

ParameterTypeRequiredDescription
event_idstringyesEvent ID.
vendor_namestringnoVendor name.
vendor_categorystringnoVendor category.
vendor_emailstringnoVendor email.
vendor_phonestringnoVendor phone.
amount_estimatednumbernoEstimated amount.
amount_paidnumbernoAmount paid.
notestringnoNote.

update_event_expense

Update an existing event expense.

Update Event Expense

Update an existing event expense.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event expense to update.
vendor_namestringnoVendor name.
vendor_categorystringnoVendor category.
vendor_emailstringnoVendor email.
vendor_phonestringnoVendor phone.
amount_estimatednumbernoEstimated amount.
amount_paidnumbernoAmount paid.
notestringnoNote.

The photos of an event and who is tagged in them.

list_event_photos

List photos for an event.

List Event Photos

List photos for an event. Each photo includes its tagged member_ids[].

ParameterTypeRequiredDescription
event_idstringyesFilter by event ID.
limitnumbernoMaximum number of photos to return (default: 50, max: 100)
offsetnumbernoNumber of photos to skip (for pagination)

get_event_photo

Get a specific event photo by ID, including its tagged member_ids[].

Get Event Photo

Get a specific event photo by ID, including its tagged member_ids[].

ParameterTypeRequiredDescription
idstringyesThe UUID of the event photo.

add_event_photo

Add a photo to an event. Inserts the photo, then upserts the tagged members into event_photo_members.

Add Event Photo

Add a photo to an event. Inserts the photo, then upserts the tagged members into event_photo_members.

ParameterTypeRequiredDescription
event_idstringyesEvent ID.
urlstringyesPhoto URL (must be a valid URL)
captionstringnoPhoto caption.
sort_ordernumbernoDisplay sort order.
member_idsstring[]noArray of member UUIDs tagged in the photo.

update_event_photo

Update an event photo. Updates caption/sort_order and, when member_ids is provided, re-syncs event_photo_members to exactly that set.

Update Event Photo

Update an event photo. Updates caption/sort_order and, when member_ids is provided, re-syncs event_photo_members to exactly that set.

ParameterTypeRequiredDescription
idstringyesThe UUID of the event photo to update.
captionstringnoPhoto caption.
sort_ordernumbernoDisplay sort order.
member_idsstring[]noArray of member UUIDs tagged in the photo. When provided, replaces the full member set.