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.
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.
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.
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.
Real example
A walkthrough
The owner of Aurora Coffee Co. opens Claude and types a single prompt:
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:
- Calls
upload_file_from_urlwith the logo URL → receives afile_…id with 1×/2×/3× variants. - Calls
create_templatewith{ name: "Aurora Coffee Co.", type: "loyalty", pass: { backgroundColor: "#0E0E0E", logo: { fileId: "file_…" }, useStampCollection: true, stampCount: 8 } }. - Calls
create_passwith the new templateId, passingcustomFields.collectedStamps = 2and the recipient's email. - 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.
Two minutes
Connect to your AI
The recommended path is the hosted MCP server at https://mcp.walletap.io. Authentication is OAuth — first call walks you through Walletap sign-in and consent. No install, no local config. Pick your client below.
Claude · one click
Click the button — claude.ai opens with name + URL pre-filled. Review, confirm, sign in to Walletap, approve. Then ask Claude: “list my Walletap templates”.
Add to Claude →Cursor · one click
Click below — cursor.com hands off to the Cursor app, which opens the MCP settings page with the Walletap server pre-filled. Click Install, sign in, approve.
Add to Cursor →ChatGPT · Apps (developer mode)
ChatGPT now uses Apps (the Apps SDK) — they replace the older Connectors / Plugins flow. To connect Walletap as a personal app you first turn on developer mode, then add the MCP server URL:
- Open chatgpt.com, go to Settings → Apps & Connectors → Advanced settings and toggle Developer mode on.
- Back in Settings → Apps & Connectors, click Create.
- Name:
Walletap. Description: “Issue Apple & Google Wallet passes.” URL:https://mcp.walletap.io. - Save → sign in to Walletap on the OAuth popup → approve.
- In a new chat, click the + button by the composer → More, pick Walletap. Write tools (create_template, create_pass…) will ask for confirmation the first time you use them.
This adds Walletap as a private app for your account only. For organization-wide or public availability, submit Walletap through the OpenAI Apps dashboard.
Codex CLI · TOML config
OpenAI's Codex CLI reads MCP servers from ~/.codex/config.toml:
# ~/.codex/config.toml
[mcp_servers.walletap]
type = "http"
url = "https://mcp.walletap.io"Gemini · programmatic
Google AI Studio and the Gemini API support remote MCP servers, but there is no point-and-click install today — you wire it up via the Gemini SDK plus the MCP TypeScript client. Authenticate Walletap with an API key from app.walletap.io → Settings → API keys:
// Gemini SDK + MCP TypeScript client — connect once, expose every Walletap
// tool as a Gemini tool call. Auth is via Walletap API key (no UI step yet).
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import { GoogleGenAI } from "@google/genai";
const transport = new StreamableHTTPClientTransport(
new URL("https://mcp.walletap.io"),
{ requestInit: { headers: { "X-API-Key": process.env.WALLETAP_API_KEY } } }
);
const mcp = new Client({ name: "gemini-walletap", version: "0.1.0" });
await mcp.connect(transport);
const { tools } = await mcp.listTools();
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const chat = ai.chats.create({
model: "gemini-2.5-pro",
config: { tools: [{ functionDeclarations: tools.map(t => ({
name: t.name, description: t.description, parameters: t.inputSchema,
})) }] },
});Local · stdio fallback
For clients that don't yet speak remote MCP over OAuth — Claude Desktop, Continue, Cline, Zed, custom integrations — run the server locally via npx. The same config works in any MCP-aware tool that accepts a stdio command:
{
"mcpServers": {
"walletap": {
"command": "npx",
"args": ["-y", "@walletap/mcp-server"],
"env": {
"WALLETAP_API_KEY": "wtap_sk_..."
}
}
}
}Grab the API key from app.walletap.io → Settings → API keys.
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.