Walletap

io.github.ivangr1由 GitHub 账号 ivangr1 发布v0.1.3更新于 Oct 24, 2026

Issue and manage Apple Wallet & Google Wallet passes from any AI assistant.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

Walletap 让 AI 助手通过 Walletap API 创建、更新、通知和导出 Apple Wallet 与 Google Wallet 卡券。

可以做什么
  • 列出、搜索、导出和查看卡券,包括钱包链接与 CSV 导出
  • 创建和更新卡券,调整字段、印章或余额
  • 向单个持卡人或整个模板的所有持卡人发送通知
  • 创建、更新和删除卡券模板,并创建 Apple Wallet 证书
  • 管理营业地点和 VTAP NFC 读卡器
  • 管理团队子账号及其权限,并将卡券文案翻译成多种语言
适用场景
适合在 Apple Wallet 或 Google Wallet 上运营会员卡、积分卡、票券或集章卡项目,并希望直接通过对话助手而非后台面板来发卡、更新或通知持卡人的场景。
运行要求
通过 npx 或全局 npm 安装后在本地运行(需要 Node.js)。需要 Walletap 账号,并通过环境变量 WALLETAP_API_KEY 提供 API 密钥。需联网访问 Walletap API,可用 WALLETAP_API_BASE_URL 覆盖接口地址。另提供可选的 HTTP 传输模式用于自托管。
安装前请注意
WALLETAP_API_KEY 中的 API 密钥可访问你的 Walletap 账号,并会以明文写入客户端配置文件。多个工具会写入或删除数据:创建和更新卡券、向持卡人发送通知、删除模板、地点和团队成员,以及创建带密码的子账号。卡券数据和翻译内容会发送到 Walletap API。

安装

在 SourceWeft 中

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

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@walletap/mcp-server

Issue and manage Apple Wallet & Google Wallet passes from any AI assistant.

Quick Start

bash
npx @walletap/mcp-server

Or install globally:

bash
npm install -g @walletap/mcp-serverwalletap-mcp

Authentication

Set your Walletap API key as an environment variable:

bash
export WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxx

You can find your API key in the Walletap dashboard under Settings.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "walletap": {      "command": "npx",      "args": ["-y", "@walletap/mcp-server"],      "env": {        "WALLETAP_API_KEY": "wt_live_xxxxxxxxxxxxxxxxxxxx"      }    }  }}

Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json:

json
{  "mcpServers": {    "walletap": {      "command": "npx",      "args": ["-y", "@walletap/mcp-server"],      "env": {        "WALLETAP_API_KEY": "wt_live_xxxxxxxxxxxxxxxxxxxx"      }    }  }}

HTTP Remote Mode

For self-hosted deployments, n8n, Make, or Zapier AI:

bash
walletap-mcp --transport http

This starts an HTTP server (default port 3001) exposing:

  • POST /mcp — JSON-RPC endpoint
  • GET /mcp/sse — Server-Sent Events for streaming
  • GET /health — Health check

Docker example:

dockerfile
FROM node:22-alpineRUN npm install -g @walletap/mcp-serverENV WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxxENV MCP_PORT=3001EXPOSE 3001CMD ["walletap-mcp", "--transport", "http"]

Tools Reference

ToolWhat it doesKey inputs
list_passesList passes for a template with paginationtemplateId, status, limit
search_passesSearch passes by email or phonetemplateId, searchQuery
export_passesExport passes as CSVtemplateId, status
get_passGet a single pass with wallet URLsid or externalId+templateId
create_passCreate one or more wallet passespasses[], sendToEmail, sendToPhone
update_passUpdate pass fields, stamps, or balanceid, templateFields, stampOperation, balanceOperation
notify_passSend notification to one pass holderpassId, title, content
list_templatesList all pass templateslimit, startAfter
create_templateCreate a new templatename, type
update_templateUpdate template config/designtemplateId, data
delete_templateDelete a templatetemplateId
send_template_notificationNotify all pass holders in a templatetemplateId, title, content
create_certificateCreate Apple Wallet certificatetemplateId
list_locationsList all business locations—
create_locationCreate a new locationname, latitude, longitude
update_locationUpdate location detailsid, name, address
delete_locationDelete a locationid
create_readerCreate a VTAP NFC readername, templateId, phone
list_sub_accountsList team members—
create_sub_accountCreate a team memberemail, displayName, password
update_sub_accountUpdate team member permissionsuserId, permissions, templateIds
delete_sub_accountRemove a team memberuserId
translate_pass_textTranslate pass text to multiple languagestexts, sourceLanguage, targetLanguages

Example Prompts

Here are things you can say to your AI assistant with Walletap connected:

  • "Create a loyalty card template called 'Coffee Rewards' and issue a pass to [email protected]"
  • "Show me all passes for my loyalty template that haven't been installed yet"
  • "Add 3 stamps to the pass with external ID 'CUST-42' in my stamp card template"
  • "Send a notification to all pass holders: 'Double points this weekend! Visit any location to earn 2x.'"
  • "Export all my loyalty passes as CSV for the marketing team"
  • "Translate our pass labels into Spanish, French, and German"

API Base URL

By default connects to https://api.walletap.io. Override with:

bash
export WALLETAP_API_BASE_URL=https://your-custom-instance.example.com

License

MIT

来源:README.md,提交 c9a59ad

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 40%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。