Skip to main content
Glama
@walletap/mcp-server

@walletap/mcp-server

Official
by walletap

@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

Related MCP server: BotBell MCP Server

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 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

Available Tools

26 tools
create_certificateA
Destructive

Create or renew the Apple Wallet certificate for a template. Usually triggered automatically on template create; this is for manual renewals.

Inputs: templateId (required).

create_locationB
Destructive

Create a new business location for reader deployment and pass management. Use this when setting up a new store, venue, or checkpoint. Locations can be associated with passes and readers for validation.

Inputs: name (required), latitude (required), longitude (required), address, +1 more.

create_passA
Destructive

Create one or more wallet passes for a template. Use this to issue new loyalty cards, event tickets, coupons, or membership passes to customers. Can optionally send the pass link via email or SMS.

Inputs: passes (required), locale, sendToEmail, sendToPhone.

create_sub_accountA
Destructive

Create a new sub-account (team member) with specific permissions and template access. Use this to grant team members limited access to manage specific templates. The sub-account gets their own login credentials.

Inputs: email (required), password (required), displayName (required), permissions, +1 more.

create_templateA
Destructive

Create a new pass template. Only name and type are required. Use pass to override colors, fields, barcode, NFC, and image references. The response returns status: 'active' immediately, but the Apple certificate, Google Wallet class and Stripe meters provision in the BACKGROUND and are written back a few seconds later — so passTypeId / appleCertificates are usually still null in the create response. Re-read the template with get_template before concluding that certificate provisioning failed. NFC: set pass.nfc: true (and enableNFC: true) BEFORE creating; the certificate is issued with the NFC entitlement based on that flag at provision time.

Inputs: name (required), type (required), pass, beacons, +7 more.

delete_fileA
Destructive

Delete a file and all its variants from storage. Templates that still reference the URL keep their JSON intact but the linked image URL will return 404.

Inputs: fileId (required).

delete_locationA
Destructive

Delete a location permanently. Use with caution — readers associated with this location will need reassignment. Subscription is updated automatically.

Inputs: id (required).

delete_sub_accountA
Destructive

Permanently delete a sub-account and revoke all their access. Use with caution — this removes the user's Firebase auth account and all template access records. This cannot be undone.

Inputs: userId (required).

delete_templateA
Destructive

Permanently delete a template and deactivate its Stripe billing meters. Existing passes issued from this template are orphaned. Cannot be undone.

Inputs: templateId (required).

export_passesA
Read-only

Export all passes for a template as CSV data. Use this to get a full data dump of passes for reporting or migration. Returns CSV with columns: Pass ID, External ID, Email, Phone, Name, Member ID, Status, Installation Status, Device Count, Created, Updated.

Inputs: templateId (required), status.

get_fileA
Read-only

Retrieve a file's metadata by id. Returns url, mime_type, size, width, height, variants (1×/2×/3×), purpose, source_url, and timestamps.

Inputs: fileId (required).

get_passA
Read-only

Get a single pass by ID or by externalId + templateId. Returns the pass with wallet download URLs (Apple, Google, Huawei) and installation badge URLs. Use includeTemplate to also get the full template configuration.

Inputs: id, locale, externalId, templateId, +1 more.

get_templateA
Read-only

Fetch a single template by id. Use this to inspect existing field ids (rows, linkRows, header) before issuing passes — the same ids are used as keys in customFields / templateFields at issuance time.

Inputs: templateId (required).

list_locationsA
Read-only

List all locations for the authenticated account. Use this to see available business locations for reader deployment or pass association. Returns location names, addresses, and coordinates.

Inputs: no named parameters.

list_passesA
Read-only

List all passes for a given template with pagination and optional status filtering. Use this to browse passes, check counts, or find passes by their installation status. Returns pass objects with IDs, emails, phones, and device counts.

Inputs: templateId (required), limit, status, endBefore, +1 more.

list_sub_accountsA
Read-only

List all sub-accounts (team members) for the main account. Use this to see who has access and their template permissions. Returns sub-account details with template access counts.

Inputs: no named parameters.

list_templatesA
Read-only

List pass templates owned by this account, cursor-paginated. Returns { object: 'list', data, has_more, next_cursor, total_count }.

Inputs: limit, startingAfter.

notify_passA
Destructive

Send a push notification to a single pass holder via Google Wallet. Use this for targeted messages to individual customers (e.g. balance update, reward earned). For bulk notifications to all pass holders, use send_template_notification instead.

Inputs: title (required), passId (required), content (required), validFrom, +1 more.

search_passesA
Read-only

Search passes within a template by email or phone number. Use this when you need to find a specific customer's pass. Returns matching passes ordered by creation date.

Inputs: templateId (required), searchQuery (required).

send_template_notificationA
Destructive

Send a push notification to every pass holder of a template (Apple, Google, Huawei). Use for announcements that apply to all customers. For individual notifications, use notify_pass.

Inputs: title (required), content (required), templateId (required), validFrom, +1 more.

translate_pass_textA
Read-only

Translate pass text to multiple languages using Google Cloud Translation. Use this to localize pass content (field labels, messages) for international customers. Supports all Google Translate languages.

Inputs: texts (required), sourceLanguage (required), targetLanguages (required).

update_locationA
Destructive

Update an existing location's details. Use this to correct addresses, rename locations, or update coordinates. Only provided fields are updated — omitted fields remain unchanged.

Inputs: id (required), name, address, latitude, +2 more.

update_passA
Destructive

Update an existing pass's fields, stamps, or balance. Use this to modify customer data, add/remove loyalty stamps, adjust balance, or invalidate a pass. Identify the pass by ID or by externalId + templateId.

Inputs: id, isValid, externalId, templateId, +5 more.

update_sub_accountA
Destructive

Update a sub-account's permissions, template access, or active status. Use this to grant/revoke access or deactivate a team member. Only provided fields are updated.

Inputs: userId (required), isActive, displayName, permissions, +1 more.

update_templateA
Destructive

Partial update of an existing template (RFC 7396 merge-patch semantics). Send only the fields you want to change. Updating pass deep-merges with the existing pass JSON, so you can change a single color or add a field without round-tripping the whole pass. locations is the exception: it REPLACES the stored array wholesale (send the full set; [] clears them), because merging geofences by index would strand stale ones. ALREADY-ISSUED PASSES: a stored .pkpass is not rebuilt on every read, so design and artwork changes reliably show up only on passes issued AFTER the update. Verify a change by issuing a fresh pass rather than re-downloading an existing one.

Inputs: templateId (required), name, pass, beacons, +7 more.

upload_file_from_urlA
Destructive

Fetch a public image URL, validate it, and store it in Walletap-managed storage. Returns a file_… id you can reference inside a template's pass design as { "fileId": "file_…" } on any image field (logo, hero, icon, strip, background, stamp, thumbnail). When purpose is supplied the server generates 1×/2×/3× variants at Apple Wallet spec dimensions. Max source size 10 MiB. Accepts PNG, JPEG, WebP, SVG, AVIF, HEIC, GIF, TIFF and ICO; anything with a wallet purpose is transcoded to PNG. Source URLs that resolve to private / loopback IPs are refused (SSRF protection).

USE A URL YOU HAVE ACTUALLY SEEN — one the user gave you, or one you read out of the page you fetched. Do not construct a plausible-looking asset URL from a brand name: guessed Wikimedia and logo-CDN paths are the single most common cause of failure here. If the fetch reports that the source returned 404, the URL is wrong — find a different one rather than retrying, and ask the user for the image if you cannot.

Inputs: url (required), purpose, templateId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 26 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (templates, passes, files, locations, sub-accounts, notifications, translation). Even similar tools like list_passes vs search_passes are clearly separated by browsing vs. finding a specific customer, and notify_pass vs send_template_notification distinguish single vs. bulk. No ambiguity exists.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case (e.g., list_templates, create_pass, update_location, upload_file_from_url). Even longer names like send_template_notification and translate_pass_text follow the same convention. No mixing of styles or vague verbs.

    Tool Count4/5

    26 tools is slightly above the typical well-scoped range, but the server covers a broad domain with multiple resource types (templates, passes, files, locations, sub-accounts, notifications, translation). Each tool contributes to a distinct workflow, and the count is manageable without being bloated.

    Completeness4/5

    The tool surface provides full CRUD for templates, locations, and sub-accounts, and robust pass management (create, read, update, search, export, notify) but lacks a delete_pass tool. File operations lack listing, and certificate management is minimal, but these are minor gaps that do not block core workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage OneSignal push notifications, email, SMS, and user management through natural language. Supports multi-channel messaging, segmentation, templates, analytics, and iOS Live Activities with 50+ tools for complete OneSignal API coverage.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to send push notifications and interactive alerts to iPhone and Mac devices via the BotBell app. It allows AI to receive user replies and manage notification bots for tasks like alerts, reminders, and remote approvals.
      2
      9 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to issue and manage virtual cards, check balances, pull transactions, file disputes, and start KYC via the CardOS API.
      26
      13 npm
      MIT