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.
- Site
- partiful.com
- 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/partifulEvery 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/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.
Read 2
discoverEventsLists the public events Partiful's explore page shows for one region (sf, nyc, la, bos, dc, chi, lon, mia, atx).Arguments
Name Type Required regionstringA 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/discoverEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.partiful.discoverEvents({ region: "sf" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.partiful.discoverEvents({"region": "sf"}))curl -X POST https://api.bowmark.ai/v1/sites/partiful/discoverEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"region":"sf"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringHttps://partiful.com/e/<id>, or the bare id.Yes Returns
PartifulEventinterface 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/getEventCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.partiful.getEvent({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.partiful.getEvent({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/partiful/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.partiful.getEvent({ url: "<url>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/partiful/<function> - OpenAPI
/v1/sites/partiful/openapi.json