Partiful

@pipeworx/partiful

Partiful 探索页面上的公开活动列表——包括 Partiful 展示的派对、快闪活动、座谈会和聚会的标题、时间、地点、主办方名称及 RSVP 汇总人数。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1807+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• partiful_explore(region?) — 浏览公开探索页面。传入区域代码（nyc、la、sf、dc、chi、bos、atx、mia），可查看该城市更丰富的主题版块；省略则显示跨城市的顶层趋势概览（仅限纽约、洛杉矶和旧金山）。
• partiful_event(event_id) — 获取单场活动的完整公开详情：标题、描述、开始／结束时间、地点、图片、主办方显示名称及 RSVP 汇总人数。绝不会返回宾客名单或联系方式。

认证

无需密钥。无需任何账号、登录或 API 密钥——匿名访客也可以查看探索页面和活动页面。

数据源

• Partiful 的公开活动列表——Partiful 提供给所有访客（无论是否登录）的探索轮播内容和单场活动页面。

备注

• Partiful 使用 Next.js 应用在服务端渲染 /explore 及单场活动页面，并将完整的公开字段活动数据放在纯 HTML 中的 __NEXT_DATA__ JSON 数据块里。无需单独调用 API，也无需执行 JS——此程序包会直接解析该数据块。
• 不带区域参数的 /explore 只包含纽约、洛杉矶和旧金山的少量预置趋势概览（每个城市约 5 场活动）。按区域访问探索页面，则会进入该城市单独且内容丰富得多的页面，最多包含十多个主题版块（万圣节派对、快闪活动与市集、结识新朋友等）——如果需要全面了解某个城市，请使用此方式。
• 此路由仅支持 8 个区域代码（于 2026-10-13 实时测试）：nyc、la、sf、dc、chi、bos、atx、mia。尝试过的其他所有候选项（芝加哥、西雅图、伦敦、费城、休斯敦、圣迭戈、丹佛、亚特兰大、纳什维尔、波特兰、多伦多等）均返回 404。没有更广泛的城市／地理位置查询参数——这就是 Partiful 提供的全部范围。
• 从结构上看，宾客名单永远不会公开：向活动页面发起未认证请求时，Partiful 本身会返回 guest: null，因此即使此程序包尝试展示，也没有任何信息可泄露。会返回主办方显示名称（活动页面向所有访客公开显示）；不会展示主办方照片、电话号码、电子邮件地址或 RSVP 表单答案。
• location 会规范化 Partiful 的两种地点格式：structured（街区、显示名称、地址行、Google Maps 链接）和 freeform（单个地址字符串）。私密／未公开的活动以及从未存在过的 ID 均会正常返回 404——partiful_event 会报出明确错误，而不是返回不完整的记录。

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "partiful": {
      "url": "https://gateway.pipeworx.io/partiful/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/partiful/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是判断当天实际范围的权威依据。

这是有意为之，并非意外的多路复用。元工具让范围受限的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义带来的上下文开销超过了路由的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和同一组 1807+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/partiful_explore \
  -H 'Content-Type: application/json' \
  -d '{"region":"la"}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/partiful_explore。查找工具：使用 {"query":"..."} 发送 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账号，也无需通过网关往返调用：

{
  "mcpServers": {
    "partiful": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-partiful"]
    }
  }
}

或者直接运行，确认它能启动：

npx -y @pipeworx/mcp-partiful

它通过 stdin/stdout 使用 MCP 通信，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英文提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Partiful data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT