realevents

RealEvents MCP サーバー

MCP 互換の AI アシスタントから、RealEvents のイベントを作成・管理できます。

ドキュメントとインストール用スニペット：https://realevents.co/mcp

インストール

{
  "mcpServers": {
    "realevents": {
      "command": "npx",
      "args": ["-y", "realevents-mcp"]
    }
  }
}

macOS の Claude Desktop では、設定ファイルは ~/Library/Application Support/Claude/claude_desktop_config.json にあります。その他のクライアントについては、それぞれの MCP ドキュメントを参照してください。

エージェントスキル

skills/realevents/SKILL.md では、これらのツールを使用するタイミングと 方法についてアシスタントに説明します。適切なタイムゾーンでのイベント作成、管理リンクの 返却、以下の参加人数とゲストリストのルールなどが含まれます。 skills/realevents フォルダーを、上記のサーバー設定と一緒にクライアントのスキルディレクトリへコピーしてください（Claude Code の場合は ~/.claude/skills/）。

ツール

公開ツール。トークンは不要です。

ツール	説明
list_public_events	今後開催される公開イベントを閲覧します。形式、期間、検索語で絞り込めます。
get_event	スラッグを指定して、イベントの公開詳細を取得します。スラッグ変更後も古いリンクをたどれます。
register_for_event	参加者の出欠を登録します。参加、未定、不参加を選べ、同伴者とメモも追加できます。
create_event	新しいイベントページを作成します。公開リンクと管理リンクを返します。

主催者向けツール。すべて管理トークンが必要です。

ツール	説明
get_manage_event	ゲストリストを含む、イベントの詳細情報を取得します。
list_registrations	ゲストリストのみを取得します。参加確定、未定、辞退で絞り込むこともできます。
get_event_stats	ページビュー、参加人数、残り定員、閲覧から参加への転換率を取得します。
update_event	イベントの詳細や設定を変更します。
duplicate_event	イベントをコピーし、1週間後の日付で新しい下書きを作成します。
cancel_event	イベントをキャンセル済みとしてマークします。ページはオンラインのままです。
set_cover	公開画像 URL からカバー画像を設定します。
list_comments	ゲストとのやり取り（質問、返信、リアクション）を読み込みます。
post_comment	主催者としてスレッドに投稿します。出欠を登録したすべてのゲストに表示されます。

コメント機能は、主催者が有効にしたイベントでのみ使えます（allow_comments: true を指定して update_event を実行します）。有効になるまでは、どちらのコメントツールもその旨を示すメッセージを返します。

カバー画像

set_cover が受け取るのは公開画像 URLであり、ファイルではありません。MCP ツールの引数は JSON テキストなので、アシスタントからローカル画像をサーバーに渡すことはできません。画像が ユーザーのコンピューターにある場合は、管理ページからアップロードするほうが便利です（ドラッグ＆ ドロップ、プレビュー、トリミングに対応）。幅は 1200px 以上がおすすめです。画像が小さい場合、 set_cover はサムネイルを黙って受け付けるのではなく、その旨を伝えます。

タイムゾーン

create_event では、start_datetime とともに timezone（Europe/Paris のような IANA 名）を指定します。 **必ず設定してください。**開始時刻はそのタイムゾーンで解釈され、指定しない場合の既定値は UTC です。 そのため、タイムゾーンを指定せずに 19:00 のイベントを作成すると、ページには 19:00 UTC と表示され、 UTC 圏外の人には時刻が正しく伝わりません。

末尾に Z を付けない現地時刻を指定してください。

start_datetime: "2026-06-15T19:00:00"
timezone:       "Europe/Paris"

参加人数は実人数でカウントされます

イベントの参加人数は実人数です。参加が確定したゲストと、そのゲストが連れてくる全員を合計します。3人を連れて到着したゲストは、空きがまだ表示されているイベントでも、空き枠を4つ使用するため、そのグループの参加が断られる場合があります。その場合、エラーには残りの枠数が示されるため、失敗として報告するのではなく、人数を減らして再試行できます。

同伴者を追加できるのは回答がconfirmedの場合のみで、イベントごとのplus_ones_limitを上限とします（0の場合は無効です）。主催者が人数ではなく名前を集める場合、申告されたゲスト全員に名前が必要です。get_eventでは両方の設定を確認できます。

管理トークン

create_eventで作成したイベントは、manage_tokenを返します。保存してください。後からイベントを管理する唯一の方法です。

毎回渡さずに済むよう、デフォルトのトークンを設定するには、次のようにします。

{
  "mcpServers": {
    "realevents": {
      "command": "npx",
      "args": ["-y", "realevents-mcp"],
      "env": {
        "REALEVENTS_MANAGE_TOKEN": "your-token"
      }
    }
  }
}

セキュリティ

npm Provenanceで署名され、GitHub Actionsを通じてこのリポジトリからビルドされています。公開された各バージョンは、ビルドに使用された正確なコミットとワークフローの実行まで追跡できます。

リンク

• realevents.co
• ドキュメント
• GitHubリポジトリ
• MCP Registryの掲載ページ

メンテナー向け：公開チェックリスト

新しいバージョンを公開する前に、次の手順を実行してください。

1. package.jsonのversionを更新します
2. mcpName: "io.github.ykastelnik/realevents"が引き続き含まれていることを確認します
3. server.jsonのversionとpackages[0].versionを更新して一致させます
4. vX.Y.Zのタグを付けてプッシュします。publish.ymlワークフローがnpmへの公開を処理します
5. ローカルで./mcp-publisher publishを実行し、MCP Registryの掲載情報を同期します

ライセンス

MIT