Meetup

@pipeworx/meetup

Meetup のイベントとグループを検索する MCP — Meetup の公開イベント、グループ、トピックカテゴリをキーワード、都市、またはグループで検索できます。キー不要です。

Pipeworx の一部です — AI エージェントを1807以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• meetup_search_events(query, city?, lat?, lon?, radius?, limit?) — 都市の近く（自動ジオコーディング）または緯度・経度の地点周辺で、キーワードに基づいて今後の公開イベントを検索します。各イベントのタイトル、日時、URL、ステータス、種類、主催グループを返します。
• meetup_event(event_id) — 数値の Meetup ID（meetup.com のイベント URL の末尾の番号）を指定して、1件のイベントの詳細を取得します。タイトル、説明、開始・終了時刻、ステータス、種類、会場、主催グループを返します。
• meetup_group(urlname) — urlname（meetup.com/ の直後にあるスラッグ。例：「sfpython」）を指定して、1つのグループの詳細を取得します。名前、説明、場所、タイムゾーン、トピックカテゴリ、設立日を返します。
• meetup_group_events(urlname, limit?, include_past?) — urlname を指定してグループのイベントを取得します。デフォルトでは今後のイベントを返し、include_past: true を指定すると過去のイベントも含めます。

これらのツールはいずれも、参加者／RSVP の一覧、メンバー一覧、その他の個人連絡先データを要求も返却もしません。これは意図的なものであり、見落としではありません（下記の「プライバシー」を参照）。

認証

キー不要です。キーもアカウントも不要で、レート制限の情報も公開されていません。

データソース

• Meetup（meetup.com）：Meetup 自身のウェブサイト検索およびイベント／グループページを支える公開 GraphQL API — イベント、グループ、トピックカテゴリのメタデータ。ダウンロードファイル、フィード、クエリ形式について、それ以上の名称は記載されていません。ルートについては src/index.ts を参照してください。

プライバシー

Meetup のスキーマでは、Event／Group の参加者 RSVP、主催者の身元、メンバー一覧が公開されています。このパックでは、それらのフィールドをどこでも選択していません。すべてのクエリは公開イベント／グループのメタデータ（タイトル、日時、会場、説明、場所）に限定されており、それ以外は取得しません。この方針を維持してください。この注記を読み直さずに、どのクエリにも rsvps、hostRsvps、memberships、organizer、eventHosts、savedBy を追加しないでください。

注意事項

• lat／lon は上流 API 自体が必須としている項目であり、このパックが選んだものではありません。EventSearchFilter／GroupSearchFilter の両方で、これらは非 null として宣言されています。meetup_search_events は Meetup を呼び出す前に、共有の resolvePlace ジオコーダー（@pipeworx/shared、Open-Meteo を使用、キー不要）で city 文字列を座標に変換するため、呼び出し元が生の座標を指定する必要はありません。ただし、ジオコーディングで都市を解決できない場合、ツールは推測せず明確に失敗します。
• radius の単位はマイルです。 上流のフィルターフィールドは単位が記載されていない単なる Float です。米国の既知の都市の半径を用いて実際に検証しました。
• イベント ID とグループ ID は不透明な文字列であり、常に数値のように見えるとは限りません。event_id は meetup.com/{group-urlname}/events/{event-id}/ URL の末尾のパス要素で、グループの urlname は meetup.com/ の直後にあるスラッグです。どちらも、検索せずにもう一方から特定することはできません。両方を取得するには meetup_search_events と meetup_group_events を使います。
• イベントが予定されていない場合、meetup_group_events はエラーではなく total_count: 0 を返します。実在し活動中でもイベントの合間にあるグループ（sfpython で実環境に対して検証済み）は、レスポンスの形式だけでは無効または誤った urlname と区別できません。urlname 自体で meetup_group がエラーになる場合にのみ、「グループが存在しない」ことと「現在イベントがない」ことを区別できます。
• GraphQL エラーは HTTP 200 で返され、トップレベルに errors 配列が含まれます（GraphQL 標準の動作）。不正なクエリや無効な ID でも 200 が返るため、このパックでは res.ok だけを信頼せず、errors を明示的に確認します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/meetup/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共有ツールがおよそ30個リストされています。接続の initialize 応答には正確な範囲が示されており、その日の状況を確認する際の決定的な情報となります。

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックが扱わない質問にも、カタログ全体を検索する ask_pipeworx 経由で回答できるため、2つ目の 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/meetup_search_events \
  -H 'Content-Type: application/json' \
  -d '{"query":"music","lat":40.71,"lon":-74,"radius":20,"limit":5}'

最初の呼び出しにはアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/meetup_search_events を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイ経由の通信も不要です。

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-meetup

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に、initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントとフルゲートウェイのどちらでも利用できます。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT