Partiful MCP server for AI agents

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

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

Connect

Just Partiful

An MCP server for Partiful 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/partiful
Every site

One MCP server for Partiful 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 2
  • discoverEventsLists the public events Partiful's explore page shows for one region (sf, nyc, la, bos, dc, chi, lon, mia, atx).

    Arguments

    NameTypeRequired
    regionstring
    A Partiful explore region: sf, nyc, la, bos, dc, chi, lon, mia, atx…
    Yes

    Returns PartifulEvent[]

    interface PartifulEvent {
      id: string;
      url: string;
      shortUrl: string | null;
      title: string;
      /** Partiful's own status word, e.g. "PUBLISHED", read it off a result, never guess one. */
      status: string | null;
      /** ISO instant, UTC. */
      startAt: string | null;
      endAt: string | null;
      timezone: string | null;
    
      localStart: string | null;
      /** "structured" (a picked place) or "freeform" (typed text). */
      locationType: string | null;
      /** The place's name ("Ferry Building"); null for a bare street address. */
      venue: string | null;
      /** One line with the postcode: "590 Howard St, San Francisco, CA 94105". */
      address: string | null;
      addressLines: string[];
      /** The host's own location text, as typed. */
      locationText: string | null;
      neighborhood: string | null;
      approximateLocation: string | null;
      googleMapsUrl: string | null;
      /** null when the page lists none, and on every discoverEvents row: call getEvent. */
      hosts: PartifulHost[] | null;
      /** Guests apply and the host approves; null when the record does not say. */
      requiresApproval: boolean | null;
      /** Going plus approved; null when the host hides the count. */
      guestCount: number | null;
      guestCounts: PartifulGuestCounts;
      atCapacity: boolean;
      description: string | null;
      imageUrl: string | null;
      /** The event's .ics file. */
      calendarUrl: string | null;
      /** The RSVP or application form, in order. null on a discoverEvents row: call getEvent. */
      questions: PartifulQuestion[] | null;
    }
    
    interface PartifulHost {
      id: string;
      name: string;
    }
    
    interface PartifulGuestCounts {
      going: number | null;
      approved: number | null;
      maybe: number | null;
      interested: number | null;
      waitlist: number | null;
    }
    
    interface PartifulQuestion {
      id: string;
      label: string;
      required: boolean;
      /** short_answer, email, linkedin, select… */
      type: string;
      /** A select's choices; [] otherwise. */
      options: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.partiful.discoverEvents({ region: "sf" });
  • getEventReads one public Partiful event page (partiful.com/e/<id>) and returns its title, start and end with timezone, venue name and full street address…

    Arguments

    NameTypeRequired
    urlstring
    Https://partiful.com/e/<id>, or the bare id.
    Yes

    Returns PartifulEvent

    interface PartifulEvent {
      id: string;
      url: string;
      shortUrl: string | null;
      title: string;
      /** Partiful's own status word, e.g. "PUBLISHED", read it off a result, never guess one. */
      status: string | null;
      /** ISO instant, UTC. */
      startAt: string | null;
      endAt: string | null;
      timezone: string | null;
    
      localStart: string | null;
      /** "structured" (a picked place) or "freeform" (typed text). */
      locationType: string | null;
      /** The place's name ("Ferry Building"); null for a bare street address. */
      venue: string | null;
      /** One line with the postcode: "590 Howard St, San Francisco, CA 94105". */
      address: string | null;
      addressLines: string[];
      /** The host's own location text, as typed. */
      locationText: string | null;
      neighborhood: string | null;
      approximateLocation: string | null;
      googleMapsUrl: string | null;
      /** null when the page lists none, and on every discoverEvents row: call getEvent. */
      hosts: PartifulHost[] | null;
      /** Guests apply and the host approves; null when the record does not say. */
      requiresApproval: boolean | null;
      /** Going plus approved; null when the host hides the count. */
      guestCount: number | null;
      guestCounts: PartifulGuestCounts;
      atCapacity: boolean;
      description: string | null;
      imageUrl: string | null;
      /** The event's .ics file. */
      calendarUrl: string | null;
      /** The RSVP or application form, in order. null on a discoverEvents row: call getEvent. */
      questions: PartifulQuestion[] | null;
    }
    
    interface PartifulHost {
      id: string;
      name: string;
    }
    
    interface PartifulGuestCounts {
      going: number | null;
      approved: number | null;
      maybe: number | null;
      interested: number | null;
      waitlist: number | null;
    }
    
    interface PartifulQuestion {
      id: string;
      label: string;
      required: boolean;
      /** short_answer, email, linkedin, select… */
      type: string;
      /** A select's choices; [] otherwise. */
      options: string[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.partiful.getEvent({ url: "<url>" });

Use it from code