Walletap MCP Server

@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

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