{
  "markdown": "# @walletap/mcp-server\n\nIssue and manage Apple Wallet & Google Wallet passes from any AI assistant.\n\n## Quick Start\n\n```bash\nnpx @walletap/mcp-server\n```\n\nOr install globally:\n\n```bash\nnpm install -g @walletap/mcp-server\nwalletap-mcp\n```\n\n## Authentication\n\nSet your Walletap API key as an environment variable:\n\n```bash\nexport WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxx\n```\n\nYou can find your API key in the [Walletap dashboard](https://app.walletap.io) under Settings.\n\n## Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"walletap\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@walletap/mcp-server\"],\n      \"env\": {\n        \"WALLETAP_API_KEY\": \"wt_live_xxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n## Cursor / Windsurf\n\nAdd to `.cursor/mcp.json` or `.windsurf/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"walletap\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@walletap/mcp-server\"],\n      \"env\": {\n        \"WALLETAP_API_KEY\": \"wt_live_xxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n## HTTP Remote Mode\n\nFor self-hosted deployments, n8n, Make, or Zapier AI:\n\n```bash\nwalletap-mcp --transport http\n```\n\nThis starts an HTTP server (default port 3001) exposing:\n- `POST /mcp` — JSON-RPC endpoint\n- `GET /mcp/sse` — Server-Sent Events for streaming\n- `GET /health` — Health check\n\nDocker example:\n\n```dockerfile\nFROM node:22-alpine\nRUN npm install -g @walletap/mcp-server\nENV WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxx\nENV MCP_PORT=3001\nEXPOSE 3001\nCMD [\"walletap-mcp\", \"--transport\", \"http\"]\n```\n\n## Tools Reference\n\n| Tool | What it does | Key inputs |\n|------|-------------|------------|\n| `list_passes` | List passes for a template with pagination | `templateId`, `status`, `limit` |\n| `search_passes` | Search passes by email or phone | `templateId`, `searchQuery` |\n| `export_passes` | Export passes as CSV | `templateId`, `status` |\n| `get_pass` | Get a single pass with wallet URLs | `id` or `externalId`+`templateId` |\n| `create_pass` | Create one or more wallet passes | `passes[]`, `sendToEmail`, `sendToPhone` |\n| `update_pass` | Update pass fields, stamps, or balance | `id`, `templateFields`, `stampOperation`, `balanceOperation` |\n| `notify_pass` | Send notification to one pass holder | `passId`, `title`, `content` |\n| `list_templates` | List all pass templates | `limit`, `startAfter` |\n| `create_template` | Create a new template | `name`, `type` |\n| `update_template` | Update template config/design | `templateId`, `data` |\n| `delete_template` | Delete a template | `templateId` |\n| `send_template_notification` | Notify all pass holders in a template | `templateId`, `title`, `content` |\n| `create_certificate` | Create Apple Wallet certificate | `templateId` |\n| `list_locations` | List all business locations | — |\n| `create_location` | Create a new location | `name`, `latitude`, `longitude` |\n| `update_location` | Update location details | `id`, `name`, `address` |\n| `delete_location` | Delete a location | `id` |\n| `create_reader` | Create a VTAP NFC reader | `name`, `templateId`, `phone` |\n| `list_sub_accounts` | List team members | — |\n| `create_sub_account` | Create a team member | `email`, `displayName`, `password` |\n| `update_sub_account` | Update team member permissions | `userId`, `permissions`, `templateIds` |\n| `delete_sub_account` | Remove a team member | `userId` |\n| `translate_pass_text` | Translate pass text to multiple languages | `texts`, `sourceLanguage`, `targetLanguages` |\n\n## Example Prompts\n\nHere are things you can say to your AI assistant with Walletap connected:\n\n- **\"Create a loyalty card template called 'Coffee Rewards' and issue a pass to john@example.com\"**\n- **\"Show me all passes for my loyalty template that haven't been installed yet\"**\n- **\"Add 3 stamps to the pass with external ID 'CUST-42' in my stamp card template\"**\n- **\"Send a notification to all pass holders: 'Double points this weekend! Visit any location to earn 2x.'\"**\n- **\"Export all my loyalty passes as CSV for the marketing team\"**\n- **\"Translate our pass labels into Spanish, French, and German\"**\n\n## API Base URL\n\nBy default connects to `https://api.walletap.io`. Override with:\n\n```bash\nexport WALLETAP_API_BASE_URL=https://your-custom-instance.example.com\n```\n\n## License\n\nMIT\n",
  "bytes": 4310,
  "sha": "5b147b4a0a9a24ebae4bbf68f75b26e804c24c1e598d22e4344a84598cb6de10",
  "repo_slug": "ivangr1/walletap-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ivangr1_walletap_5530ddd3/readme"
}