@walletap/mcp-server
OfficialEnables management of Apple Wallet passes, including creating templates, issuing and updating passes, sending notifications to pass holders, and exporting pass data as CSV.
Enables management of Google Wallet passes, including creating templates, issuing and updating passes, sending notifications to pass holders, and exporting pass data as CSV.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@walletap/mcp-server Create a loyalty card template called 'Coffee Rewards' and issue a pass to john@example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@walletap/mcp-server
Issue and manage Apple Wallet & Google Wallet passes from any AI assistant.
Quick Start
npx @walletap/mcp-serverOr install globally:
npm install -g @walletap/mcp-server
walletap-mcpRelated MCP server: BotBell MCP Server
Authentication
Set your Walletap API key as an environment variable:
export WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxxYou 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 httpThis starts an HTTP server (default port 3001) exposing:
POST /mcp— JSON-RPC endpointGET /mcp/sse— Server-Sent Events for streamingGET /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 for a template with pagination |
|
| Search passes by email or phone |
|
| Export passes as CSV |
|
| Get a single pass with wallet URLs |
|
| Create one or more wallet passes |
|
| Update pass fields, stamps, or balance |
|
| Send notification to one pass holder |
|
| List all pass templates |
|
| Create a new template |
|
| Update template config/design |
|
| Delete a template |
|
| Notify all pass holders in a template |
|
| Create Apple Wallet certificate |
|
| List all business locations | — |
| Create a new location |
|
| Update location details |
|
| Delete a location |
|
| Create a VTAP NFC reader |
|
| List team members | — |
| Create a team member |
|
| Update team member permissions |
|
| Remove a team member |
|
| Translate pass text to multiple languages |
|
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.comLicense
MIT
Available Tools
26 toolscreate_certificateADestructive
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_locationBDestructive
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_passADestructive
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_accountADestructive
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_templateADestructive
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_fileADestructive
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_locationADestructive
Delete a location permanently. Use with caution — readers associated with this location will need reassignment. Subscription is updated automatically.
Inputs: id (required).
delete_sub_accountADestructive
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_templateADestructive
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_passesARead-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_fileARead-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_passARead-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_templateARead-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_locationsARead-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_passesARead-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_accountsARead-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_templatesARead-only
List pass templates owned by this account, cursor-paginated. Returns { object: 'list', data, has_more, next_cursor, total_count }.
Inputs: limit, startingAfter.
notify_passADestructive
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_passesARead-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_notificationADestructive
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_textARead-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_locationADestructive
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_passADestructive
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_accountADestructive
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_templateADestructive
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_urlADestructive
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
Scored across 26 tools
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.
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.
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.
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
Related MCP Connectors
Create, update and message Apple Wallet and Google Wallet passes and loyalty cards.
Create, update, and revoke Apple Wallet and Google Wallet passes from any MCP client.
Create signed Apple Wallet passes (.pkpass), singly or in bulk: boarding passes, tickets, coupons.
Design and launch Apple Wallet and Google Wallet loyalty stamp cards for your shop, café or salon.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceEnables 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.29 npm1MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Apple App Store Connect resources like apps, builds, TestFlight, and reviews through natural language.2014 npmMIT

CardOS MCP Serverofficial
AlicenseAqualityCmaintenanceEnables AI assistants to issue and manage virtual cards, check balances, pull transactions, file disputes, and start KYC via the CardOS API.2613 npmMIT