rightos-mcp

@i-s3/rightos-mcp — RightOS MCP サーバー

RightOS 用の MCP（Model Context Protocol） サーバーです。HTTP コードを書かずに、AI エージェントが行列、クリニックの待ち時間、EV 充電、イベント、荷物の受け取り用のデジタル QR チケットを発行、確認、譲渡できます。

コーディングエージェントの場合： npx -y @i-s3/rightos-mcp とデモキー rk_demo_00000000000000000000 から始めてください。完全なドキュメント：llms-full.txt · OpenAPI · ai.txt

RightOS が確認するのは、有効な権利が存在することだけであり、人物の身元ではありません。エンドユーザーの氏名、電話番号、生年月日は必要ありません。

RightOS はタクシーや配車サービスではありません。車両の手配、運賃の設定、ドライバーの割り当て、配車の仲介は行いません。

セットアップ

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

{
  "mcpServers": {
    "rightos": {
      "command": "npx",
      "args": ["-y", "@i-s3/rightos-mcp"],
      "env": {
        "RIGHTOS_API_KEY": "rk_live_..."
      }
    }
  }
}

RIGHTOS_API_KEY は任意です。設定しない場合は、公開ツール（プラン、トークン検索、確認、譲渡、保有者によるキャンセル、ロケーションポリシー、ポリシープリセット）のみ利用できます。組織を登録してキーを取得してください。無料プランがあり、クレジットカードは不要です。

共有デモ組織で試すには、RIGHTOS_API_KEY に rk_demo_00000000000000000000 を設定してください。

ツール

公開（API キー不要）：

ツール	説明
list_plans	料金プランの一覧を表示します（全世界で統一）
get_token	ID で Right Token を取得します（秘密コードは返しません）
verify_token	検証コードを使ってトークンを確認します
transfer_token	再キー設定によってトークンを譲渡します（旧コードは無効になります）
holder_cancel_token	現在の保有者としてトークンを自己キャンセルします（ポリシーで許可される場合）
get_location_policy	ロケーションの有効なポリシーを取得します（透明性確保のため公開）
list_policies	業種プリセットと国別オーバーレイの一覧を表示します（JP/US/GB/KR/TW/FR/DE/IT/ES/AU）

運営者（RIGHTOS_API_KEY が必要）：

ツール	説明
list_locations	組織のロケーション一覧を表示します
create_location	ロケーションを作成します（種類によって業種ポリシーのプリセットが決まります）
set_location_policy	ロケーションのポリシーを上書きまたはリセットします
get_policy_history	ポリシー変更の監査ログを表示します（追記専用、新しい順）
issue_token	デジタル QR チケットを発行します（コードとウォレット URL は一度だけ返されます）
use_token	サービス提供後、チケットを使用済みにします
cancel_token	チケットをキャンセルします
export_data	組織の全データを JSON としてエクスポートします（ロックインなし）
list_webhooks	アウトバウンド Webhook の一覧を表示します（署名シークレットは含まれません）
create_webhook	Webhook を登録します — 配信には HMAC-SHA256 署名が付き、シークレットは一度だけ返されます
delete_webhook	Webhook を削除します

プロンプトの例

• 「メインカウンター用の行列チケットを発行して、ウォレット URL を教えてください。」
• 「このチケットを確認してください：tok_...、コードは K7MP-... です。」
• 「EV 充電ロケーションを譲渡不可にしてください。」（業種プリセットですでに譲渡不可です。エージェントは get_location_policy で確認できます）

リソース

• MCP セットアップ（人間向け）
• ai.txt · llms.txt · llms-full.txt
• OpenAPI 3.1 仕様
• TypeScript SDK @i-s3/rightos · Python SDK rightos-sdk
• MCP Registry（公開済み）：io.github.suomimasuda/rightos-mcp

ライセンス

MIT © I-S3 Inc.