Skip to main content
Glama
mrh-is

partiful-mcp

by mrh-is

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PARTIFUL_USER_IDNoFirebase UID. Found in the same IndexedDB entry as the refresh token (the uid field). Optional.
PARTIFUL_REFRESH_TOKENYesFirebase refresh token for authentication. Required.
PARTIFUL_FIREBASE_API_KEYNoFirebase API key. Defaults to Partiful's public key if not provided.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_all_event_restrictionsA

Get restrictions across all of your Partiful events. Returns a list of per-event restriction records.

get_cohost_requested_eventsA

Get events where you've been asked to cohost. Returns a list of event objects awaiting your cohost response.

get_contacts_filtered_by_eventA

Get contacts that can be invited to a specific Partiful event. Returns the full list of contact objects in one call (the endpoint does not paginate).

get_contactsA

Get your Partiful contact list. Returns an array of contact user profiles (id, name, display name, username).

get_created_cardsA

Get digital cards you've created on Partiful. Returns an array of card objects (id, title, image).

get_discover_curation_optionsA

Get discover-page curation options for a hosted Partiful event (host-only) — the host-side settings controlling how the event can appear on the explore/discover page. Distinct from get_event_discover_info (the resulting discover-page info) and get_event_discover_status (whether it's currently listed).

get_discover_event_item_decoratorsA

Get decorators/metadata for explore page event cards (badges like 'friends going', trending, etc.). Returns decoratorsByEventId, an object of decorator data keyed by event ID.

get_discoverable_eventsA

Get open-invite / discoverable Partiful events for the home page 'Open invite' tab, as an events array. Unlike get_my_rsvps/get_my_upcoming_events_for_home_page/get_my_past_events_for_home_page/get_published_events, these events aren't necessarily ones you've been invited to or RSVPed to — they're publicly discoverable events surfaced to you. Distinct from get_my_saved_events (events you've explicitly bookmarked) and get_my_followed_events (events from people/pages you follow).

get_event_commentsA

Get comments/discussion posted on a Partiful event by ID. Returns an array of comment objects (author, text, timestamp) for that event.

get_event_discover_infoA

Get discover-page info (region, sections, tags) for a Partiful event by ID. Distinct from get_event_discover_status (whether the event is listed at all) and get_discover_curation_options (host-side curation settings).

get_event_discover_statusA

Check whether a Partiful event is listed on explore/discover. Returns the event's discoverability flag/status. Distinct from get_event_discover_info (the region/sections/tags shown once listed) and get_discover_curation_options (host-only settings controlling how it can be listed).

get_event_displayed_host_messagesA

Get the host messages displayed on a Partiful event's page by ID. Returns hostMessages, an array of host announcement/message objects for that event.

get_event_infoA

Get full details for a specific Partiful event by ID, as an event object: title, dates, location, ownership, host/guest display settings, and guest status counts. Works for any event you can view (not just ones you've been invited to), unlike the RSVP-list tools — but unlike those, it does not include the current user's own RSVP (guest) status.

get_event_mediaA

Get photos and media uploaded to a Partiful event by ID. Returns an array of media items (URL, content type, uploader) shared to that event.

get_event_permissionA

Get the current authenticated user's permission level and capability flags (e.g. edit, invite, manage guests) for a Partiful event by ID.

get_event_restrictionsA

Get the restrictions (e.g. minimum age, capacity, approval requirements) configured for a Partiful event by ID. Returns a restrictions array; the real per-restriction shape isn't documented, so entries pass through as-is.

get_event_ticketing_eligibilityA

Check whether a Partiful event by ID is eligible for ticketing. Returns an eligibility boolean and, if ineligible, the reason.

get_followersA

Get the current user's followers on Partiful, as a users array of profile objects. Distinct from get_following (who the current user follows, not who follows them).

get_followingA

Get the user IDs the current user follows on Partiful, as a userIds array. Distinct from get_followers (who follows the current user, not who they follow). Use get_users to resolve these IDs into profiles.

get_guest_payment_infoA

Get ticket payment history for a specific guest on a hosted Partiful event (host-only). Returns a payments array (amounts charged, fees, tax, promo codes used).

get_guestsA

Get the full guest list for a Partiful event by ID. Returns an array of guest RSVP records (guest/event/user IDs and RSVP status) for every invitee.

get_host_promo_codesA

Get promo codes for a Partiful event you're hosting. Returns a list of promo code objects (code, discount, usage limits) for the event.

get_host_ticket_typesA

Get ticket types/tiers for a Partiful event you're hosting. Returns a list of ticket type objects (name, price, quantity, enabled/disabled state).

get_last_questionnaire_answersA

Get the current user's most recent RSVP questionnaire answers, used to prefill future RSVP questionnaires.

get_mutual_guestsA

Get guests you have in common with a specific Partiful event — i.e. people invited to this event who you're also connected to elsewhere. Distinct from get_guests (every guest, not just mutual ones) and get_mutuals (your mutual connections generally, not scoped to one event).

get_mutualsA

Get your mutual connections on Partiful — people you've been at the same events with. Returns an array of user profiles (id, name, display name, username). Not scoped to a single event; use get_mutual_guests instead if the question is about one specific event's guest list.

get_my_communitiesA

Get the Partiful communities you belong to. Returns an array of community objects (id, name).

get_my_followed_eventsA

Get Partiful events you're following, as an events array. Following tracks events from hosts/pages you follow without necessarily RSVPing, distinct from get_my_saved_events (explicitly bookmarked events), get_discoverable_events (open invite public events), and get_my_rsvps (events you've been invited to or RSVPed to).

get_my_past_events_for_home_pageA

Get your past Partiful events for the home page 'All past events' tab, as a pastEvents array. This is the past-only counterpart to get_my_upcoming_events_for_home_page — for the complete unfiltered history (past and future) use get_my_rsvps instead.

get_my_rsvpsA

Get every Partiful event you've been invited to or RSVPed to (any status, any time period), as an events array with the richest per-event data available (RSVP status, guest counts, image, display settings). Broader than get_my_upcoming_events_for_home_page/get_my_past_events_for_home_page (which are time-filtered home-page views) and distinct from get_published_events (events you host rather than attend) and get_discoverable_events/get_my_saved_events/get_my_followed_events (events you haven't necessarily RSVPed to).

get_my_saved_eventsA

Get your saved/bookmarked Partiful events, as an events array. These are events you've explicitly saved for later, distinct from get_discoverable_events (open invite public events), get_my_followed_events (events from people/pages you follow), and get_my_rsvps (events you've been invited to or RSVPed to).

get_my_upcoming_events_for_home_pageA

Get your upcoming Partiful events for the home page 'Upcoming' view, as an upcomingEvents array. This is the future-only, home-page-curated subset — for the complete unfiltered RSVP/invite history use get_my_rsvps, and for hosted-only events regardless of date use get_published_events.

get_payout_summary_for_eventA

Get the host payout summary for a ticketed Partiful event (host-only) — total sales, fees, and amount payable to the host.

get_pending_cohost_request_for_eventA

Get the pending cohost invitation for a Partiful event by ID, if the current user has one outstanding. Returns pendingCohostRequest, the invitation record's fields (id, event, inviter, status), or null if none is pending.

get_published_eventsA

Get all Partiful events you are hosting (any time period), as an events array with title, date, location, and guest counts. Use this instead of get_my_rsvps (which covers events you attend/RSVP to, not necessarily host) or get_my_upcoming_events_for_home_page/get_my_past_events_for_home_page (which are home-page views scoped by time, not by host role).

get_ticket_fee_configA

Get Partiful's ticketing fee configuration (flat fee, fee rate, whether it's a custom rate) for a specific event, or the platform default if no event is given.

get_tickets_for_eventA

Get all tickets sold for a ticketed Partiful event (host-only). Distinct from get_tickets_for_ticket_type (scoped to one ticket type) and get_guest_payment_info (payment history for one guest).

get_tickets_for_ticket_typeA

Get all tickets sold for one ticket type on a hosted Partiful event (host-only). Narrower than get_tickets_for_event (every ticket on the event, all types).

get_users_party_statsA

Get just the party stats (events attended count, events hosted count) for a batch of Partiful user IDs — lighter weight than get_users, which returns full profile info (name, username, profile image) with party stats always baked in as well. Returns statsByUserId, an object of stats keyed by user ID.

get_usersA

Fetch Partiful user profiles by their IDs. Returns per-user name, display name, username, and profile image, with party stats (events attended/hosted) baked into every response. Use get_users_party_stats instead if you only need attended/hosted event counts, not full profile info.

mark_all_notifications_for_event_as_readA

Mark all notifications for a Partiful event as read. This is a write action — it changes state on your account. Only call this when the user's intent is clearly to mark notifications read; do not call it speculatively to 'check' notification state.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mrh-is/partiful-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server