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.