English Français العربية

io.github.ivangr1/walletap

Official registry Finance and payments

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "walletap": {
            "command": "npx",
            "args": [
                "-y",
                "@walletap/mcp-server@0.1.3"
            ],
            "env": {
                "WALLETAP_API_KEY": "<WALLETAP_API_KEY>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is io.github.ivangr1/walletap?

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

How do I install io.github.ivangr1/walletap?

It runs on your machine. In Claude Code: claude mcp add walletap -e 'WALLETAP_API_KEY=<WALLETAP_API_KEY>' -- npx -y @walletap/mcp-server@0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ivangr1/walletap need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ivangr1/walletap open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.ivangr1/walletap?

It is published by ivangr1. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.