Loyaltyvip

io.github.justinmont84由 GitHub 账号 justinmont84 发布v1.0.1更新于 Nov 2, 2026

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

已验证Streamable HTTP可网页运行位置与生活金融

概览

AI 生成的概览

让助手搜索美国赌场目录及其会员奖励计划与等级阶梯，并凭 API 密钥读取玩家本人的 LoyaltyVIP 忠诚度与税务数据。

可以做什么
  • 按名称、州、类型或是否有奖励计划搜索并查看公开的美国赌场目录详情。
  • 列出并读取赌场会员奖励计划，包括积分规则、等级匹配说明和完整等级阶梯。
  • 执行需认证的玩家与主持人操作，如等级状态、资金状态、行程、W-2G 记录和年度税务汇总。
适用场景
适合需要助手查询美国赌场及其玩家俱乐部等级，或把本人的 LoyaltyVIP 忠诚度、赠送权益和博彩税务记录带入对话的场景。
运行要求
可通过 npx 作为本地 npm 包运行（需 Node.js），也可连接远程 Streamable HTTP 端点。公开目录工具无需密钥；player_action 需要个人 API 密钥，通过环境变量 LOYALTYVIP_API_KEY 提供并以 Bearer 令牌发送。
安装前请注意
该 API 密钥是个人凭据，可访问玩家本人的数据，包括行程、W-2G 记录和税务汇总，请勿写入共享配置或日志。player_action 会把任意玩家/主持人操作转发给服务，使用前应确认具体请求内容。目录与玩家数据会发送至 LoyaltyVIP 的服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Loyaltyvip，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.justinmont84%2Floyaltyvip/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

来源：README.md，提交 6c61b8d

工具

5

search_casinos

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

输入参数qtypelimitstateoffsethas_rewards

get_casino

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

输入参数slug必填

list_rewards_programs

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

输入参数brandlimitsearch

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.)

输入参数id必填

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.

输入参数action必填params

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分