@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

| Tool | What it does | Key inputs | |------|-------------|------------| | list_passes | List passes for a template with pagination | templateId, status, limit | | search_passes | Search passes by email or phone | templateId, searchQuery | | export_passes | Export passes as CSV | templateId, status | | get_pass | Get a single pass with wallet URLs | id or externalId+templateId | | create_pass | Create one or more wallet passes | passes[], sendToEmail, sendToPhone | | update_pass | Update pass fields, stamps, or balance | id, templateFields, stampOperation, balanceOperation | | notify_pass | Send notification to one pass holder | passId, title, content | | list_templates | List all pass templates | limit, startAfter | | create_template | Create a new template | name, type | | update_template | Update template config/design | templateId, data | | delete_template | Delete a template | templateId | | send_template_notification | Notify all pass holders in a template | templateId, title, content | | create_certificate | Create Apple Wallet certificate | templateId | | list_locations | List all business locations | — | | create_location | Create a new location | name, latitude, longitude | | update_location | Update location details | id, name, address | | delete_location | Delete a location | id | | create_reader | Create a VTAP NFC reader | name, templateId, phone | | list_sub_accounts | List team members | — | | create_sub_account | Create a team member | email, displayName, password | | update_sub_account | Update team member permissions | userId, permissions, templateIds | | delete_sub_account | Remove a team member | userId | | translate_pass_text | Translate pass text to multiple languages | texts, 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:

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

License

MIT