loyaltyvip

LoyaltyVIP — JavaScript / TypeScript developer tools

Official SDK, CLI, and MCP server for LoyaltyVIP — the privacy-first casino player intelligence platform. Search the public U.S. casino directory (rewards programs + tier ladders) with no key, and access a player's own loyalty data with a personal API key.

• API docs: https://loyaltyvip.com/developers
• OpenAPI 3.1: https://loyaltyvip.com/openapi.json
• Auth guide: https://loyaltyvip.com/auth.md
• Full agent reference: https://loyaltyvip.com/llms-full.txt

Packages

Package	What it is	Install
@loyaltyvip/sdk	Typed, zero-dependency REST client	npm i @loyaltyvip/sdk
@loyaltyvip/cli	Command-line interface	npm i -g @loyaltyvip/cli
@loyaltyvip/mcp	Model Context Protocol server (stdio)	npx -y @loyaltyvip/mcp

Quickstart (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 server

Add to your MCP client (e.g. Claude Desktop):

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

The key is optional — directory tools (search_casinos, get_casino, list_rewards_programs) work without it. player_action needs a key. An HTTP (Streamable) MCP transport is also live at https://loyaltyvip.com/mcp.

Develop

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

License

MIT © movaMedia. LoyaltyVIP is independent and not affiliated with any casino brand. It is a record-keeping and analytics tool — not a gambling product.