Loyaltyvip

io.github.justinmont84Published by GitHub account justinmont84v1.0.1Updated Nov 2, 2026

U.S. casino directory + a player's loyalty data, comps, tiers, and gambling tax docs.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

Lets an assistant search a U.S. casino directory with rewards programs and tier ladders, and read a player's own LoyaltyVIP loyalty and tax data with an API…

What you can do
  • Search and read the public casino directory by name, state, type or rewards availability, and get a casino's details.
  • List and read casino rewards/players-club programs, including earning rules, status-match notes and full tier ladders.
  • Run authenticated player and host actions such as tier status, bankroll status, trips, W-2G listings and tax-year summaries.
When to use it
Useful when someone wants an assistant to look up U.S. casinos and their players-club tiers, or to pull their own LoyaltyVIP loyalty, comp and gambling tax records into a conversation.
Requirements
Runs as a local npm package via npx (Node.js) or as a remote Streamable HTTP endpoint. The public directory tools need no key; player_action requires a personal API key supplied in the LOYALTYVIP_API_KEY environment variable and sent as a Bearer token.
Before you install
The API key is a personal credential that unlocks a player's own data, including trips, W-2G records and tax summaries; keep it out of shared configs and logs. player_action proxies arbitrary player/host actions to the service, so review what it is asked to do. Directory and player data are sent to LoyaltyVIP's servers.

Installation

In SourceWeft

  1. Open Loyaltyvip in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.justinmont84%2Floyaltyvip/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "loyaltyvip": {
      "type": "http",
      "url": "https://loyaltyvip.com/mcp"
    }
  }
}

README

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.

Packages

PackageWhat it isInstall
@loyaltyvip/sdkTyped, zero-dependency REST clientnpm i @loyaltyvip/sdk
@loyaltyvip/cliCommand-line interfacenpm i -g @loyaltyvip/cli
@loyaltyvip/mcpModel Context Protocol server (stdio)npx -y @loyaltyvip/mcp

Quickstart (SDK)

ts
import { LoyaltyVIP } from "@loyaltyvip/sdk";
const lv = new LoyaltyVIP(); // no key needed for the public directoryconst { 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

bash
npx @loyaltyvip/cli casinos --state NV --rewardsnpx @loyaltyvip/cli casino bellagio-nv-880e8400LOYALTYVIP_API_KEY=lvip_live_... npx @loyaltyvip/cli tiers

MCP server

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

json
{  "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

bash
npm installnpm 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.

Source: README.md at commit 6c61b8d

Tools

5

search_casinos

Search the public U.S. casino directory by name, state (two-letter code), type (commercial|tribal|racino), or rewards availability.

Parametersqtypelimitstateoffsethas_rewards

get_casino

Get a casino's detail including its rewards/players-club program and full tier ladder, by slug.

Parametersslugrequired

list_rewards_programs

List casino rewards/players-club programs, optionally filtered by search term or brand.

Parametersbrandlimitsearch

get_rewards_program

Get one rewards/players-club program by id — brand, earning rules, status-match notes, and full tier ladder. (get_casino also returns a casino's program inline.)

Parametersidrequired

player_action

Authenticated. Invoke any LoyaltyVIP player/host action (proxies POST /v1/player). Requires a Bearer API key in the Authorization header. Examples: tier_status, bankroll_status, list_trips, list_w2g, tax_year_summary, host_dashboard.

Parametersactionrequiredparams

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts