signupgenius-mcp

signupgenius-mcp

SignUpGenius 用の MCP サーバーです。プロフィール、グループ、サインアップ、レポート、公開サインアップのメタデータ、枠の一覧、RSVP、枠の確保／解除に対応する、15 個の読み取りツールと 4 個の書き込みツールを備えています。

サインアップの読み取りには、認証情報が一切不要です。signupgenius_get_public_signup（タイトル、説明、主催者、必須の質問）と signupgenius_list_slots（日付、時刻、場所、定員、サインアップした人と各エントリーが使用する枠数）は、自分が作成していないものを含め、あらゆる公開シートで利用できます。2 つの枠への書き込みツールである signupgenius_claim_slot と signupgenius_release_slot にはサインイン済みセッションが必要です。また、signupgenius_rsvp と signupgenius_add_group_member と同様に、最初の呼び出しでは書き込みを行いません。MCP のエリシテーションに対応するクライアントでは、確認プロンプトが表示されます（MCP_CONFIRM_ELICITATION=off の場合を除きます）。それ以外のクライアントでは、最初の呼び出しでプレビューと、その書き込みに紐づく一度限りの confirmToken が返されます。同じ引数とトークンを指定して再度呼び出した場合にのみ送信されます。MCP_CONFIRM_MODE（デフォルトは ask-user、設定値は auto、refuse）でこの動作を調整できます。エリシテーションに対応すると表示されるものの、プロンプトが表示されないクライアント（opencode 2.0.x では書き込みがハングします）では、MCP_CONFIRM_ELICITATION=off を設定してください。すべてのクライアントでプレビューとトークンのフローが使われます。その他の値は on として扱われ、stderr に警告が出力されます。

signupgenius_claim_slot と signupgenius_rsvp は、デフォルトでサインイン済みアカウントとしてサインアップします。firstname、lastname、email を省略すると、プロフィールから読み取られます（signupgenius_get_profile の呼び出しと同じです）。家族など、自分以外の人をサインアップする場合にのみ指定してください。指定することもできますが、その場合、エントリーは引き続き自分のアカウントに紐づくため、プレビューには両方のユーザーを示す identityNote と identityDiffersFromAccount: true が含まれます。すべてのプレビューで identity にユーザー情報が表示され、source は account、supplied、mixed のいずれかになります。確認トークンは解決済みのユーザー情報に紐づくため、ある人向けに承認されたプレビューを別の人として送信することはできません。

認証モードは 3 種類あり、次の優先順位で試行されます。一致した最初のモードが使用されます。

1. Pro キーモード。 ドキュメントに記載された Pro API キーを使用します。必要なのは、枠のレポートツール（満枠／空き枠／全参加者）の場合のみです。Pro サブスクリプションが必要です。
2. セッションモード。 通常のメールアドレスとパスワードでログインし、signupgenius.com のダッシュボードが使用するものと同じ Web API を呼び出します。無料アカウントでも利用できます。 SSO／2FA には対応していません。
3. fetchproxy フォールバック（環境変数は不要）。 環境変数が設定されていない場合、サーバーは起動時に、ContextMint Bridge ブラウザー拡張機能（fetchproxy を基盤としています）を介して、サインイン済みの signupgenius.com タブから accessToken／cfid／cftoken Cookie を一度だけ読み取ります。その後、すべての SignUpGenius API 呼び出しは Node から直接行われ、拡張機能がリクエストのホットパスに入ることはありません。拡張機能を一度インストールし（下記のfetchproxy フォールバックを参照）、SignUpGenius にサインインすれば、MCP をすぐに利用できます。

フォールバックを使わない場合は SIGNUPGENIUS_DISABLE_FETCHPROXY=1 を設定してください（認証情報がない場合にハードエラーになります。ヘッドレス CI で便利です）。

ツール

ドメイン	ツール	モード
プロフィール	signupgenius_get_profile	両方
グループ	signupgenius_list_groups、signupgenius_list_group_members、signupgenius_get_group_member、signupgenius_add_group_member（書き込み）	両方
サインアップ	signupgenius_list_created_active、_expired、_all、signupgenius_list_invited、signupgenius_list_signedupfor	両方
サインアップ（追加）	signupgenius_legacy_get_my_signups	セッションのみ
レポート	signupgenius_report_all、signupgenius_report_filled、signupgenius_report_available	キーのみ

セッションモードのサインアップ一覧に関する注意：v3 エンドポイントの signups/created、signups/invited、signups/signedupfor は、1 回のページネーション付き呼び出しで全件を返します（アクティブ用・期限切れ用の URL は別々にありません）。3 つの signupgenius_list_created_* ツールは、セッションモードではすべて同じエンドポイントに対応します。enddate でクライアント側のフィルター処理を行ってください。追加の signupgenius_legacy_get_my_signups は、SignUpGenius ウィザード自体が使用するものと同じバックエンドを呼び出すため、より多くのデータを返すことがあります。

キー以外のモードでレポートを呼び出すと、すぐに失敗します。エラーには、ツール名、必要なモード、現在のモードが示され、SIGNUPGENIUS_USER_KEY を設定するよう案内されます。また、認証不要であらゆるシートのスロットの空き状況を確認できる signupgenius_list_slots も案内されます。

設定

セッションモード（推奨）

[email protected]
SIGNUPGENIUS_PASSWORD=your-password
SIGNUPGENIUS_NAME=Family               # optional, log label only

サーバーは最初のリクエスト時に signupgenius.com にログインし、JWT とセッション Cookie をキャッシュします。401 が返された場合は、通知なしで再ログインします。.env はパスワードファイルと同様に扱ってください。このリポジトリでは Git の追跡対象外ですが、コミットしないでください。

メールアドレスとパスワードによる直接ログインのアカウントのみ対応しています。 Google／Apple／Facebook／Microsoft SSO や 2FA では動作しません。同様の兄弟 MCP と同じ制限があります。

キーモード（Pro のみ）

SIGNUPGENIUS_USER_KEY=your-api-key
SIGNUPGENIUS_NAME=PTA Org              # optional

SignUpGenius の Pro Tools → API Management でユーザーキーを確認してください。

fetchproxy フォールバック（環境変数不要）

ContextMint Bridge ブラウザー拡張機能をリリースページからインストールします（Chrome の場合は、chrome zip をダウンロードして解凍し、デベロッパーモードをオンにして chrome://extensions から展開済みの拡張機能を読み込みます。Safari 版はまだありません。公開ダウンロードのない ContextMint アプリに同梱される予定なので、今のところは Chrome を使用してください）。signupgenius.com にサインインし、MCP の設定から env ブロックを削除します。MCP は起動時に accessToken／cfid／cftoken Cookie を一度読み取り、セッションモードでのログインと同様に使用します。パスワードをコピー＆ペーストする必要はありません。

ContextMint Bridge は、同じメンテナーによる fetchproxy ブラウザー拡張機能の新しい名称です。fetchproxy のREADMEからも参照できます。ソースコードはnullnet-app/contextmint-bridgeで公開されています。自分でビルドするか、リリース zip と同じ場所に公開されている .sha256 ファイルを使って、リリース zip のチェックサムを検証してください（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

スロットの REPORT ツールには、引き続き Pro キーモードが必要です。ドキュメントに記載された v2/k Pro API を呼び出す方法は、SIGNUPGENIUS_USER_KEY のみです。また、これらのツールの対象はオーナーのシートのみで、キーの所有者が作成したシートに限り結果を返します。誰のシートでも空き状況や参加者を確認するには、認証不要の signupgenius_list_slots を使用してください。

両方を同時に設定

Pro キーとメールアドレス／パスワードの両方を設定します。キーモードが優先されます。一部のアカウントで Pro を利用しつつ、ほかのアカウントでは通常のログインを使いながらレポートを取得したい場合に便利です。

高度なオーバーライド

環境変数	デフォルト値	用途
SIGNUPGENIUS_BASE_URL	key: https://api.signupgenius.com/v2/k session: https://api.signupgenius.com/v3	JSON API のベース URL をオーバーライドします。
SIGNUPGENIUS_LEGACY_BASE_URL	https://www.signupgenius.com	/SUGboxAPI.cfm?go=… のレガシー呼び出しに使用するホストをオーバーライドします。
SIGNUPGENIUS_LOGIN_URL	https://www.signupgenius.com	ログインフォームのホストをオーバーライドします。
SIGNUPGENIUS_DISABLE_FETCHPROXY	未設定	1 に設定すると、fetchproxy へのフォールバックをスキップします（認証情報がない場合はエラーになります）。

利用規約に関する注意

SignUpGenius の利用規約では、通常、スクリプトや自動化によるアクセスが禁止されています。セッションモードは「自分のアカウントを使う場合は自己責任」です。個人的な自動化には問題ありませんが、大規模に実行したり、自分が所有していないアカウントで実行したりすべきではありません。

ローカル開発

npm install
npm run build
npm test

上記の環境変数を設定して dist/bundle.js を MCP ホストに指定するか、.env を作成してから npm run dev を実行してください。

テスト：vitest、行／分岐／関数カバレッジ 100％。SignUpGenius API に対するエンドツーエンドテストは、意図的に CI に含めていません。実行には実際の認証情報が必要です。

メモ

• Pro v2/k API は user_key クエリパラメーターで認証します。セッション API は JWT Bearer とセッション Cookie を使用します。クライアントは、設定された環境変数に応じて適切な方式を選びます。
• どのインターフェースでリクエストを処理した場合も、すべてのレスポンスエンベロープは { data, message, success }（小文字）に正規化されます。レガシーな SUGboxAPI ディスパッチャーの大文字のエンベロープは、内部で書き換えられます。
• signupgenius_healthcheck は、使用中の認証情報を credential.source として報告します。値は api key、email/password session、fetchproxy session、または認証設定が後回しにされた場合の <mode> (auth not configured)（例：session (auth not configured)）のいずれかです。**2.1.9 で変更：**メールアドレス／パスワードでのログインは以前 fetchproxy session と報告され、設定を後回しにした場合は fetchproxy session または api key と報告されていました。古い文字列に一致する処理があれば更新してください。
• アカウントなしで Pro v2/k インターフェースをテストする場合、SignUpGenius が公開している固定のデモキーを使用できます：V0FzMkxZcmVOZlVnclZMVEl6dGhWQT09。

AI（Claude）が開発・保守しています。ご自身の判断でご利用ください。

規約への同意

この MCP サーバーを使用することで、以下の事項を認識し、同意したものとみなされます。

1. このサーバーは、お客様自身の SignUpGenius アカウントにアクセスします。 認証にはお客様自身の認証情報を使用します。他者のアカウントや登録情報にアクセスすることはなく、またアクセスできません。

2. このサーバーの使用には、SignUpGenius の利用規約が適用されます。これは、signupgenius.com を直接利用する場合と同様です。ここで特に関係する条項は次のとおりです。

ユーザーは、サービスへのアクセスを制限するために当社が設けたロボット排除ヘッダーやその他の措置を回避したり、サービスをスクレイピング、スパイダー、またはクロールするためにソフトウェア、技術、またはデバイスを使用したりしてはなりません。

また、次のように定められています。「お客様は、アカウントのユーザー名とパスワードの機密性を維持する責任を負います……お客様は、ユーザー認証情報に関連して発生するあらゆる活動または行為について責任を負うことに同意します。」

このサーバーでツールを呼び出すたびに、メンテナーが 2026-05-23 に確認したこれらの規約に同意することになります。特に、SignUpGenius は有料プラン向けに公式 API を提供しています。可能な場合は、この MCP が利用するエンドポイントよりも公式 API を優先してください。

3. 個人での主催者／参加者としての利用に限ります。 このプロジェクトは SignUpGenius, Inc. と提携、承認、後援、または協力関係にありません。認証済みのユーザーが自身の登録やグループを管理するための個人用自動化ツールです。他の主催者の登録情報のスクレイピング、参加者へのスパム送信、または偽のグループメンバーの一括追加には使用しないでください。

4. 安定性は保証されません。 このサーバーは、SignUpGenius が予告なく変更する可能性のある内部エンドポイントを呼び出す場合があります。このサーバーのツールが動作しなくなった場合、正式な対処方法は、利用可能であれば公式 API を使用することです。

5. このサーバーを SignUpGenius アカウントに関連して使用した結果については、お客様が全責任を負います。レート制限、アカウントに関する警告、アカウント停止、またはその他の措置が含まれます。利用規約に従い、お客様の認証情報を使って行われたすべての行為は、お客様によるものとみなされます。SignUpGenius から使用について異議を申し立てられた場合は、このサーバーの使用を中止してください。

このセクションは、メンテナーが誠意をもって作成した規約の要約であり、法律上の助言ではありません。また、SignUpGenius の実際の利用規約を変更したり、これに優先したりするものではありません。