eventbrite-mcp

eventbrite-mcp

このプロジェクトは AI（Claude Code）によって開発・保守されています。ご自身の判断でご利用ください。

Eventbrite 用の MCP サーバーです。チケットと注文、主催者データ（イベント、参加者、注文）、ID を指定した公開イベント、および公開イベントの検索に対応しています。Eventbrite が 2019 年にドキュメント化された API から削除し、現在はコンシューマー向けサイトでのみ利用できる機能です。

Eventbrite へのアクセス方法に応じた、2 つのデータ経路があります。

• ドキュメント化された API（eventbriteapi.com/v3）— 個人用 OAuth トークン（EVENTBRITE_TOKEN。無料：こちらから作成）を使用する、サーバー側からの通常の HTTPS 接続です。アカウント、主催者、イベント ID 指定、および参照用ツールで使用します。
• コンシューマー向け探索 API（www.eventbrite.com/api/v3/destination/…）— サイトの WAF がサーバー側クライアントをブロックするため、検索は fetchproxy ブリッジ（ContextMint Bridge 拡張機能）経由で、サインイン済みのご自身の eventbrite.com ブラウザータブから行います。認証済みセッションを再利用します。eb_search_events、eb_resolve_place、eb_event_details、eb_healthcheck で使用します。

すべてのツールは読み取り専用です。

セットアップ

npm install -g @chrischall/eventbrite-mcp

Claude Code（.mcp.json）：

{
  "mcpServers": {
    "eventbrite": {
      "command": "eventbrite-mcp",
      "env": { "EVENTBRITE_TOKEN": "your-private-token" }
    }
  }
}

• EVENTBRITE_TOKEN がなくてもサーバーは起動します。アカウント用ツールは初回使用時にわかりやすいエラーを返し、探索用ツールはそのまま動作します。
• 探索用ツールを使うには、ContextMint Bridge をリリースからインストールしてください（Chrome の zip を解凍して、展開済みの拡張機能として読み込みます。現時点では Chrome を使用してください。Safari のサポートは、まだ一般公開されていない ContextMint アプリに組み込まれる予定です）。eventbrite.com のタブを開いたままにし、1 回限りのペアリングプロンプトを承認してください（このプロンプトでは、検索 POST に必要な csrftoken Cookie の読み取りを許可します）。eb_healthcheck を実行して接続を確認してください（トークンがない場合はブリッジを、トークンがある場合はトークンを確認します）。
• ContextMint Bridge は、名称を変更した fetchproxy ブラウザー拡張機能で、同じメンテナーが提供しています。fetchproxy のREADMEからも案内されています。ソースはnullnet-app/contextmint-bridgeで公開されています。ご自身でビルドするか、リリース zip を同じ場所に公開されている .sha256 ファイルと照合してください（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

ツール

ツール	パス	メモ
eb_me	token	自分のプロフィール
eb_my_orders	token	自分のチケット。イベント情報を展開
eb_my_organizations	token	主催者の組織
eb_org_events / eb_org_attendees / eb_org_orders	token	主催者データ
eb_org_venues / eb_org_discounts / eb_org_ticket_groups / eb_org_webhooks	token	組織スコープのコレクション
eb_org_report	token	売上／参加者の分析。期間指定
eb_event / eb_event_description	token	IDで指定した公開イベント
eb_ticket_classes / eb_ticket_class	token	イベントのチケット種別
eb_event_attendees / eb_event_attendee	token	イベントごとの参加者（changed_since で差分をポーリング）
eb_event_orders	token	イベントごとの注文
eb_event_questions	token	登録時の質問（標準の質問集には canned: true を指定）
eb_order	token	IDで指定した単一の注文
eb_venue / eb_venue_events	token	会場の詳細と開催イベント
eb_organizer / eb_organizer_events	token	主催者プロフィールと開催するすべてのイベント
eb_series_events	token	定期開催シリーズの各回
eb_user	token	公開ユーザープロフィール
eb_reference	token	カテゴリー／サブカテゴリー／形式／タイムゾーン／国／地域
eb_resolve_place	token	場所 → place id（Charlotte, NC → 85981333）、および閲覧用の一覧
eb_search_events	token	コンシューマー向け検索。簡潔な結果には compact: true、ファセットには aggs を指定
eb_event_details	token	イベント詳細の一括取得
eb_healthcheck	token、または bridge	トークンがある場合：GET /users/me/ をプローブし、error.kind（credential_rejected、CDN/WAF のブロックページを示す edge_blocked、timeout、http、transport）を報告します。ない場合：ブリッジの検出先を診断し、トークンがないことを報告します（ブリッジもない場合は no_credential）

検索フロー：eb_resolve_place {location: "Charlotte, NC"} → eb_search_events {q: "blues", place_id: "85981333", compact: true}。

eb_resolve_place は、生のスラッグ（nc--charlotte）も受け付けます。州または国を指定しない市名だけの場合は、推測せずに拒否されます。

開発

npm install
npm test          # node suite
npm run build     # tsc + esbuild bundle

API 仕様のメモ（収集・検証済み）：docs/EVENTBRITE-API.md。シェルレベルのアクセススキル（curl + fpx、サーバー不要）が skills/eventbrite/ に含まれています。