Back to Home

GUIDE · MCP SERVER

Walletap is the agent-ready wallet platform.

Wire Walletap into Claude, Cursor, or any MCP-aware tool and your AI can build, issue, update and measure wallet passes — through plain conversation. No code, no API calls to wire up, no separate dashboard to learn.

Walletap was the first wallet platform to ship a Model Context Protocol server, and it's still the only one. The package is open source at github.com/walletap/walletap-mcp, published on npm as @walletap/mcp-server, and exposes every Walletap REST endpoint as a typed MCP tool. If you can describe what you want, you can build it, send it, or measure it.

Capabilities

What it can do

Four capability areas, mapped directly to Walletap's public API. Every tool is described to the AI so it can pick the right one for any request you make.

Template creation

Walletap signs every pass for you, so the agent doesn't need an Apple Developer account or certificates. Templates are created, deep-merged or deleted by name; image fields accept a public URL and the agent uploads it through upload_file_from_url automatically.

“Create a loyalty template for "Aurora Coffee Co." with an 8-stamp card, black background and our logo at https://acme.co/logo.png.”
“Add a "Tier" field to the VIP membership template — populate it from customFields.tier on each issued pass.”

Pass issuance

The agent reads the template's field ids, maps them to templateFields / customFields at issuance, and delivers the pass by email, SMS, or returns the Add-to-Wallet links. Batch issuance up to 10 passes per call.

“Issue a VIP pass to ana@example.com with 1,200 points.”
“Send a coffee stamp card to +385 91 234 5678 with one stamp already collected.”

Updates & push

Patch a single pass and Walletap propagates the change to Apple, Google and Huawei Wallets automatically. Per-template push notifications fan out to every active pass; the agent can write the message inline.

“Add a stamp to Marko's coffee card and notify him.”
“Push a "Doors open at 19:00" notification to every pass holder of the Stellar Echoes event template.”

Reads & analytics

The agent can list, fetch and inspect templates, passes, files, locations, readers and sub-accounts. Read-only tools are clearly marked so the agent never accidentally mutates state when you ask a question.

“List all templates I have under the loyalty type.”
“Fetch the pass for member 8821-447-019 — what tier are they on?”
“Show me everything I uploaded to the file store this month.”

Real example

A walkthrough

The owner of Aurora Coffee Co. opens Claude and types a single prompt:

Set up a loyalty card for Aurora Coffee Co.. Eight stamps to a free latte. Use our logo at https://tucanocoffee.com/brand/logo.png. Then issue one to marko@example.com with 2 stamps already collected.

The agent, via the Walletap MCP server, does this end to end:

  1. Calls upload_file_from_url with the logo URL → receives a file_… id with 1×/2×/3× variants.
  2. Calls create_template with { name: "Aurora Coffee Co.", type: "loyalty", pass: { backgroundColor: "#0E0E0E", logo: { fileId: "file_…" }, useStampCollection: true, stampCount: 8 } }.
  3. Calls create_pass with the new templateId, passing customFields.collectedStamps = 2 and the recipient's email.
  4. Reports back: template id, pass id, and the Apple / Google / Huawei wallet links.

Total elapsed time: under thirty seconds, no dashboard clicks, no API code written. The shop owner reads the result and the customer's phone receives the pass.

Five minutes

Setup

The MCP server runs locally on your machine and connects to api.walletap.io with your API key. To install:

# Try it once with npx
npx @walletap/mcp-server

# Or install globally
npm install -g @walletap/mcp-server

Then add it to your MCP client. For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "walletap": {
      "command": "npx",
      "args": ["-y", "@walletap/mcp-server"],
      "env": {
        "WALLETAP_API_KEY": "wtap_sk_..."
      }
    }
  }
}

Grab your API key from app.walletap.io → Settings → API keys. Restart Claude and ask it to “list my Walletap templates” — if the answer comes back, you're done. The same config works in Cursor, Continue, Cline, and any other MCP-aware client.

The agent era

Why it matters

Building wallet passes used to require a developer, a designer, a marketer, and a project manager working through three vendors and an Apple Developer membership. With MCP, the marketer talks to the agent and ships in an afternoon. The platform stops being a UI you learn and starts being a system you describe.

Walletap was built around an API-first contract from day one — the MCP server is a natural extension of that. Every endpoint is exposed; every tool is typed; every change is auditable. We ship the same machinery the dashboard uses, just spoken instead of clicked.

Try it.

Get an API key, install the server, and start a conversation. If you run into anything, email support@walletap.io.

Get an API key
Walletap is the agent-ready wallet platform — Walletap Documentation | Walletap