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.

loyaltyvip js