loyaltyvip

LoyaltyVIP — JavaScript / TypeScript 開発者向けツール

LoyaltyVIP の公式 SDK、CLI、MCP サーバーです。プライバシーを最優先するカジノプレイヤー向けインテリジェンスプラットフォームです。公開されている米国のカジノディレクトリ（リワードプログラムとティアの段階）は、キーなしで検索できます。また、個人用 API キーを使えば、プレイヤー自身のロイヤルティデータにアクセスできます。

• API ドキュメント： https://loyaltyvip.com/developers
• OpenAPI 3.1： https://loyaltyvip.com/openapi.json
• 認証ガイド： https://loyaltyvip.com/auth.md
• エージェント向けリファレンス全文： https://loyaltyvip.com/llms-full.txt

パッケージ

パッケージ	内容	インストール
@loyaltyvip/sdk	型定義付き、依存関係ゼロの REST クライアント	npm i @loyaltyvip/sdk
@loyaltyvip/cli	コマンドラインインターフェース	npm i -g @loyaltyvip/cli
@loyaltyvip/mcp	Model Context Protocol サーバー（stdio）	npx -y @loyaltyvip/mcp

クイックスタート（SDK）

import { LoyaltyVIP } from "@loyaltyvip/sdk";

const lv = new LoyaltyVIP(); // no key needed for the public directory
const { data } = await lv.searchCasinos({ state: "NV", has_rewards: true, limit: 5 });
console.log(data.map((c) => c.name));

// Your own data needs a key (https://loyaltyvip.com/dashboard/developer):
const me = new LoyaltyVIP({ apiKey: process.env.LOYALTYVIP_API_KEY });
console.log(await me.player("tier_status"));

CLI

npx @loyaltyvip/cli casinos --state NV --rewards
npx @loyaltyvip/cli casino bellagio-nv-880e8400
LOYALTYVIP_API_KEY=lvip_live_... npx @loyaltyvip/cli tiers

MCP サーバー

MCP クライアント（例：Claude Desktop）に追加します。

{
  "mcpServers": {
    "loyaltyvip": {
      "command": "npx",
      "args": ["-y", "@loyaltyvip/mcp"],
      "env": { "LOYALTYVIP_API_KEY": "lvip_live_..." }
    }
  }
}

キーは任意です。ディレクトリツール（search_casinos、get_casino、list_rewards_programs）はキーなしで動作します。player_action にはキーが必要です。HTTP（Streamable）MCP トランスポートも https://loyaltyvip.com/mcp で利用できます。

開発

npm install
npm run build      # builds sdk -> cli -> mcp

ライセンス

MIT © movaMedia。LoyaltyVIP は独立したサービスであり、カジノブランドとは提携していません。記録管理と分析のためのツールであり、ギャンブル製品ではありません。