English Français العربية

io.github.ivangr1/walletap

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @walletap/mcp-server
Claude Code 
claude mcp add walletap -e 'WALLETAP_API_KEY=<WALLETAP_API_KEY>' -- npx -y @walletap/mcp-server@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "walletap": {
            "command": "npx",
            "args": [
                "-y",
                "@walletap/mcp-server@0.1.3"
            ],
            "env": {
                "WALLETAP_API_KEY": "<WALLETAP_API_KEY>"
            }
        }
    }
}

متغيرات البيئة

  • WALLETAP_API_KEY Your Walletap API key from app.walletap.io

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @walletap/mcp-server
  2. Quick Start
  3. Authentication
  4. Claude Desktop
  5. Cursor / Windsurf
  6. HTTP Remote Mode
  7. Tools Reference
  8. Example Prompts
  9. API Base URL
  10. License

@walletap/mcp-server

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

Quick Start

npx @walletap/mcp-server

Or install globally:

npm install -g @walletap/mcp-server
walletap-mcp

Authentication

Set your Walletap API key as an environment variable:

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:

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

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

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:

FROM node:22-alpine
RUN npm install -g @walletap/mcp-server
ENV WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxx
ENV MCP_PORT=3001
EXPOSE 3001
CMD ["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 john@example.com"
  • "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:

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

License

MIT

الأسئلة الشائعة

ما هو io.github.ivangr1/walletap؟

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

كيف أثبّت io.github.ivangr1/walletap؟

يعمل على جهازك. في Claude Code: claude mcp add walletap -e 'WALLETAP_API_KEY=<WALLETAP_API_KEY>' -- npx -y @walletap/mcp-server@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ivangr1/walletap إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.ivangr1/walletap مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.ivangr1/walletap؟

ينشره ivangr1. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.