PassFast

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Remote HTTPS MCP for Apple + Google Wallet passes. Paste sk_live_ once.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "PassFast": {
      "url": "https://passfa.st/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (47)

• generatePass

  Generate a wallet pass Generates a wallet pass from a published template. For Apple passes (default), returns a signed `.pkpass` binary file directly. For Google passes (`wallet_type: "google"`), returns a JSON object containing a `save_url` that the user can open to add the pass to Google Wallet. When `wallet_type: "both"`, generates both Apple and Google passes in a single call. The response is always JSON with `apple` and `google` keys. Partial success is allowed — if one wallet fails, the other is still returned with a warning. Returns 201 if at least one succeeds. The pass ID is returned in the `X-Pass-Id` response header (for single-wallet). If the app has a validation webhook configured, the webhook is called once before generation (not per wallet type). A webhook rejection returns 403; a webhook error returns 502 (fail-closed). **Scope:** `passes:create` Maps to OpenAPI operationId `generatePass` — POST /generate-pass. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • template_id (required) — string — ID of the published template to use.
  • serial_number (required) — string — Unique serial number for this pass.
  • data (required) — object — Dynamic field values merged into the template structure.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • locations — array — GPS locations where the pass is relevant (shown on lock screen). Overrides template defaults if provided.
  • expires_at — string — Optional expiration timestamp for the pass.
  • external_id — string — Optional external identifier for cross-system lookups.
  • wallet_type — string — Target wallet platform. Defaults to `apple`. When set to `google`, the response is a JSON object with a `save_url` instead of a binary .pkpass file. When set to `both`, generates both Apple and Google passes in one call and returns a JSON object with `apple`, `google`, and `warnings` keys.
  • max_distance — number — Maximum distance in meters from a location for lock screen relevance.
  • get_or_create — boolean — When true, if a pass with the same serial_number already exists and is active, return the existing .pkpass (200) instead of a 409 error. The response includes an `X-Pass-Existed: true` header. If the existing pass is voided/expired, returns 409. When false (default), duplicate serials always return 409.
  • relevant_date — string — ISO 8601 date when the pass is relevant (appears on lock screen).
  • strip_image_id — string — Override the template's strip/hero image for this pass only. The referenced image must belong to the same app and have purpose `strip` (or a `strip_*` variant). Applied to Apple `strip.png` and Google `heroImage` atomically (same value for both wallets in `wallet_type: "both"`). Omit or send `null` to use the template's strip image.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• getBatchGenerateLimits read-only

  Batch generate limits Public metadata for `POST /passes/batch`. No authentication. Returns the hard row cap (100), sync mode, auth summary, and stable error codes. This path is on the site host (`https://passfa.st/api`), not `https://api.passfa.st/functions/v1`. MCP tool: `getBatchGenerateLimits`. Maps to OpenAPI operationId `getBatchGenerateLimits` — GET /passes/batch. Public endpoint — no API key required. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• batchGeneratePasses

  Batch generate wallet passes Generate up to 100 wallet passes in one **synchronous** request. Each accepted row is one `POST /generate-pass` (same free-100 and card-on-file gates as a single generate). Optional `POST /share-pass/create` per successful row when `create_share_links` is true (default). **Host:** `https://passfa.st/api/passes/batch` (site / Vercel preview). This is not an `api.passfa.st` Edge Function. MCP tool: `batchGeneratePasses` (secret key `sk_live_` only) — same path and body as this operation. **Auth:** `Authorization: Bearer sk_live_…` or `pk_live_…` (scope `passes:create`). A Supabase user JWT is also accepted (dashboard session). Send `X-App-Id` for multi-app orgs and `X-Org-Id` as elsewhere. **Body:** mapped `rows` (same shape the dashboard posts) **or** raw `csv` plus optional `column_map`. Do not send both. **Limits:** more than 100 rows → `400 row_limit_exceeded` **before** any generate. Empty body / empty CSV → `400 empty_batch` or `invalid_csv`. Bad template → `400 invalid_template`. Missing or invalid Bearer → `401 unauthorized`. **Billing:** a row that hits the free-100 / card gate returns the same `402` codes as generate-pass (`free_limit_reached`, `subscription_canceled`, `payment_past_due`). Remaining rows stop. Already-created rows stay. HTTP `402` is returned only when **zero** rows succeeded; a later-row 402 after some successes is HTTP `200` with `stopped_reason` and per-row results. **Partial failures:** other per-row errors (validation, duplicate serial, share-link warning) continue. The response lists every processed row. **Scope:** `passes:create` Maps to OpenAPI operationId `batchGeneratePasses` — POST /passes/batch. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • template_id (required) — string — ID of a published template.
  • csv — string — Raw CSV text with a header row. Do not send together with rows.
  • rows — array — Mapped rows (dashboard / scripts). Do not send together with csv.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • column_map — object — Optional CSV header map when `csv` is sent.
  • wallet_type — string
  • create_share_links — boolean — When true, call POST /share-pass/create after each successful generate.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• listPasses read-only

  List passes Returns a paginated list of passes for the current app. **Scope:** `passes:read` Maps to OpenAPI operationId `listPasses` — GET /manage-passes. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • limit — integer — Maximum number of results to return.
  • offset — integer — Number of results to skip.
  • status — string — Filter by pass status.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • external_id — string — Filter by external ID.
  • template_id — string — Filter by template ID.
  • wallet_type — string — Filter by wallet platform type.
  • created_after — string — Only return passes created after this timestamp.
  • serial_number — string — Filter by serial number.
  • created_before — string — Only return passes created before this timestamp.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• getPass read-only

  Get a pass Returns the full details of a single pass. **Scope:** `passes:read` Maps to OpenAPI operationId `getPass` — GET /manage-passes/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Pass ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• updatePass

  Update a pass Updates the dynamic data of an active pass. Optionally sends a push notification to registered devices so they fetch the updated pass. At least one of `data`, `expires_at`, `locations`, `relevant_date`, or `max_distance` is required. **Scope:** `passes:manage` Maps to OpenAPI operationId `updatePass` — PATCH /manage-passes/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Pass ID.
  • data — object — New dynamic field values to merge into the pass.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • locations — array — GPS locations where the pass is relevant (overrides template defaults).
  • expires_at — string — Expiration timestamp (set to null to remove expiration).
  • push_update — boolean — If true, send a push notification to registered devices.
  • max_distance — number — Maximum distance in meters from a location for lock screen relevance.
  • relevant_date — string — ISO 8601 date when the pass is relevant (lock screen).
  • strip_image_id — string — Override the template's strip/hero image for this pass. The referenced image must belong to the same app and have purpose `strip` (or a `strip_*` variant). Applied to Apple `strip.png` and Google `heroImage` atomically (synced to the sibling pass for dual-wallet). Send `null` to clear the override and revert to the template's strip image. Omit the field to leave the current override unchanged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• getPassBySerial read-only

  Get a pass by serial number Returns the full details of a single pass looked up by serial number. When a serial has both Apple and Google passes, use `?wallet_type=` to select which one (defaults to `apple`). **Scope:** `passes:read` Maps to OpenAPI operationId `getPassBySerial` — GET /manage-passes/serial/{serial_number}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • serial_number (required) — string — Pass serial number (unique within app + wallet type).
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • wallet_type — string — Wallet type to look up when a serial number has both Apple and Google passes. Defaults to `apple` for backward compatibility.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• updatePassBySerial

  Update a pass by serial number Updates the dynamic data of an active pass looked up by serial number. Optionally sends a push notification to registered devices. At least one of `data`, `expires_at`, `locations`, `relevant_date`, or `max_distance` is required. When a serial has both Apple and Google passes, use `?wallet_type=` to select which one (defaults to `apple`). **Scope:** `passes:manage` Maps to OpenAPI operationId `updatePassBySerial` — PATCH /manage-passes/serial/{serial_number}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • serial_number (required) — string — Pass serial number (unique within app + wallet type).
  • data — object — New dynamic field values to merge into the pass.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • locations — array — GPS locations where the pass is relevant (overrides template defaults).
  • expires_at — string — Expiration timestamp (set to null to remove expiration).
  • push_update — boolean — If true, send a push notification to registered devices.
  • wallet_type — string — Wallet type to look up when a serial number has both Apple and Google passes. Defaults to `apple` for backward compatibility.
  • max_distance — number — Maximum distance in meters from a location for lock screen relevance.
  • relevant_date — string — ISO 8601 date when the pass is relevant (lock screen).
  • strip_image_id — string — Override the template's strip/hero image for this pass. The referenced image must belong to the same app and have purpose `strip` (or a `strip_*` variant). Applied to Apple `strip.png` and Google `heroImage` atomically (synced to the sibling pass for dual-wallet). Send `null` to clear the override and revert to the template's strip image. Omit the field to leave the current override unchanged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• downloadPassBySerial read-only

  Download a .pkpass file by serial number Downloads the `.pkpass` binary for an active pass looked up by serial number. When a serial has both Apple and Google passes, use `?wallet_type=` to select which one (defaults to `apple`). **Scope:** `passes:download` Maps to OpenAPI operationId `downloadPassBySerial` — GET /manage-passes/serial/{serial_number}/download. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • serial_number (required) — string — Pass serial number (unique within app + wallet type).
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • wallet_type — string — Wallet type to look up when a serial number has both Apple and Google passes. Defaults to `apple` for backward compatibility.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• voidPassBySerial destructive

  Void a pass by serial number Marks a pass (looked up by serial number) as invalidated and rebuilds the `.pkpass` file with Apple's `voided: true` flag. Registered devices are sent push notifications so the pass appears voided immediately in Apple Wallet. When a serial has both Apple and Google passes, use `?wallet_type=` to select which one (defaults to `apple`). **Scope:** `passes:manage` Maps to OpenAPI operationId `voidPassBySerial` — POST /manage-passes/serial/{serial_number}/void. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • serial_number (required) — string — Pass serial number (unique within app + wallet type).
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • wallet_type — string — Wallet type to look up when a serial number has both Apple and Google passes. Defaults to `apple` for backward compatibility.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• downloadPass read-only

  Download a .pkpass file Downloads the `.pkpass` binary for an active pass. **Scope:** `passes:download` Maps to OpenAPI operationId `downloadPass` — GET /manage-passes/{id}/download. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Pass ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• voidPass destructive

  Void a pass Marks a pass as invalidated and rebuilds the `.pkpass` file with Apple's `voided: true` flag. Registered devices are sent push notifications so the pass appears voided immediately in Apple Wallet. Rebuild failure is non-fatal — the pass is still invalidated at the DB level. **Scope:** `passes:manage` Maps to OpenAPI operationId `voidPass` — POST /manage-passes/{id}/void. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Pass ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• createTemplate

  Create a template Creates a new pass template in draft status. **Scope:** `templates:manage` Maps to OpenAPI operationId `createTemplate` — POST /manage-templates. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • name (required) — string — Human-readable template name.
  • pass_style (required) — string — Apple Wallet pass style.
  • structure (required) — object — Complete pass structure. Drives both Apple `pass.json` emission and Google Wallet class/object JSON. Fields are grouped below by platform, but the single JSONB object carries all of them for dual-wallet templates.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • description — string — Optional description of the template.
  • field_schema — object — Optional JSON schema for validating dynamic data.
  • wallet_types — array
  • icon_image_id — string
  • logo_image_id — string
  • strip_image_id — string
  • google_pass_type — string — Google Wallet class type override. If unset, PassFast auto-maps from the Apple `pass_style` (+ `structure.transitType` for boardingPass): - `generic` → generic - `storeCard` → loyalty (or giftCard via override) - `eventTicket` → eventTicket - `coupon` → offer - `boardingPass` + transitType PKTransitTypeAir → flight - `boardingPass` + transitType Train/Bus/Boat/Generic → transit
  • thumbnail_image_id — string
  • background_image_id — string
  • google_logo_image_id — string
  • google_wide_logo_image_id — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• listTemplates read-only

  List templates Returns all templates for the current app. By default returns non-archived templates. Set `archived=true` to return only archived templates. **Scope:** `templates:manage` Maps to OpenAPI operationId `listTemplates` — GET /manage-templates. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • archived — boolean — When true, return only archived templates instead of active ones.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• getTemplate read-only

  Get a template Returns the full details of a single template. **Scope:** `templates:manage` Maps to OpenAPI operationId `getTemplate` — GET /manage-templates/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Template ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• updateTemplate

  Update a template Updates a draft template. Published templates cannot be modified. **Scope:** `templates:manage` Maps to OpenAPI operationId `updateTemplate` — PATCH /manage-templates/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Template ID.
  • name — string
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • structure — object — Complete pass structure. Drives both Apple `pass.json` emission and Google Wallet class/object JSON. Fields are grouped below by platform, but the single JSONB object carries all of them for dual-wallet templates.
  • pass_style — string — Apple Wallet pass style.
  • description — string
  • field_schema — object
  • wallet_types — array — Wallet platforms this template supports.
  • icon_image_id — string
  • logo_image_id — string
  • strip_image_id — string
  • google_pass_type
  • thumbnail_image_id — string
  • background_image_id — string
  • google_logo_image_id — string
  • google_wide_logo_image_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• deleteTemplate destructive

  Delete a template Soft-deletes a template by marking it as archived. Use `permanent=true` to permanently delete the template and its associated data. **Scope:** `templates:manage` Maps to OpenAPI operationId `deleteTemplate` — DELETE /manage-templates/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Template ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • permanent — boolean — When true, permanently deletes the template instead of archiving it.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• publishTemplate

  Publish a template Publishes a draft template, making it available for pass generation. Published templates cannot be modified. **Scope:** `templates:manage` Maps to OpenAPI operationId `publishTemplate` — POST /manage-templates/{id}/publish. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Template ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• uploadImage

  Upload an image Uploads an image for use in pass templates or per-pass strip overrides. Send as multipart form data with a `purpose` field and a `file` field containing the PNG image. **Upload behaviour by purpose:** - `strip` — **accumulates**. Each upload creates a new image; the returned `id` can be passed as `strip_image_id` on `POST /v1/passes` or `PATCH /v1/passes/{id}` to give individual passes their own banner. Previous `strip` images are NOT deleted — manage them via `DELETE /v1/images/{id}` when no longer referenced. - All other purposes (`icon`, `logo`, `thumbnail`, `background`, `footer`, and all `_2x`/`_3x` variants) — **replace-on-upload**. Uploading a new image of the same purpose deletes the previous one from storage and DB. These are app-wide template assets, not per-pass. **Scope:** `images:manage` Maps to OpenAPI operationId `uploadImage` — POST /manage-images. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • purpose (required) — string — The intended use of the image. `strip` uploads accumulate (for per-pass `strip_image_id` overrides); all other purposes replace existing uploads of the same purpose for the app.
  • file_base64 (required) — string — Base64-encoded file bytes. Maps to the OpenAPI multipart `file` field — same uploadImage (or equivalent) endpoint, not a new API.
  • filename — string — Optional filename sent with the multipart upload.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• listImages read-only

  List images Returns all images for the current app, including signed preview URLs. **Scope:** `images:manage` Maps to OpenAPI operationId `listImages` — GET /manage-images. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• deleteImage destructive

  Delete an image Deletes an image (storage file + DB row). Always succeeds when the image exists. Any template column pointing at this image is silently cleared (the template falls back to no image in that slot — re-attach a new one if needed). Any pass with `strip_image_id` pointing at this image has its override nullified and reverts to the template's strip on next render. Use `GET /manage-images/{id}/usage` first if you need to know the blast radius before deleting. **Scope:** `images:manage` Maps to OpenAPI operationId `deleteImage` — DELETE /manage-images/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Image ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• getImageUsage read-only

  Get image usage / reference counts Report how an image is referenced across templates and passes. Useful before DELETE to confirm an image is unused, or to find which templates a shared asset is attached to. - `template_refs` lists every template column (e.g. `strip_image_id`, `icon_image_id`, `google_logo_image_id`) that references this image. - `pass_refs_count` is the number of passes whose per-pass `strip_image_id` points at this image. - `safe_to_delete` is `true` when `total_refs` is 0. **Scope:** `images:manage` Maps to OpenAPI operationId `getImageUsage` — GET /manage-images/{id}/usage. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Image ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• uploadP12Certificate

  Upload a .p12 certificate bundle Uploads a PKCS#12 (.p12) bundle containing signer certificate and private key. The bundle is decrypted with the provided password, and individual certificates are extracted and stored with AES-256-GCM encryption. **Scope:** `certs:manage` Maps to OpenAPI operationId `uploadP12Certificate` — POST /manage-certs/p12. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • p12_data (required) — string — Base64-encoded .p12 file data.
  • password — string — Password to decrypt the .p12 bundle (if password-protected).
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• uploadCertificate

  Upload a single certificate Uploads a single PEM-encoded certificate or key. **Scope:** `certs:manage` Maps to OpenAPI operationId `uploadCertificate` — POST /manage-certs. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • cert_type (required) — string — Type of certificate being uploaded.
  • cert_data (required) — string — Base64-encoded certificate or key data.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• listCertificates read-only

  List certificates Returns all certificates for the current app. **Scope:** `certs:manage` Maps to OpenAPI operationId `listCertificates` — GET /manage-certs. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• deleteCertificate destructive

  Delete a certificate Deletes a certificate. **Scope:** `certs:manage` Maps to OpenAPI operationId `deleteCertificate` — DELETE /manage-certs/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Certificate ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• uploadGoogleCredentials

  Upload Google credentials Uploads Google service account credentials for Google Wallet pass signing. The service account JSON and issuer ID are stored securely. **Scope:** `certs:manage` Maps to OpenAPI operationId `uploadGoogleCredentials` — POST /manage-certs/google. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • service_account_json (required) — object — Google service account JSON key file contents.
  • issuer_id (required) — string — Google Wallet issuer ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• listGoogleCredentials read-only

  List Google credentials Returns all active Google Wallet credentials for the current app. **Scope:** `certs:manage` Maps to OpenAPI operationId `listGoogleCredentials` — GET /manage-certs/google. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• deactivateGoogleCredential destructive

  Deactivate Google credential Deactivates a Google Wallet credential. **Scope:** `certs:manage` Maps to OpenAPI operationId `deactivateGoogleCredential` — DELETE /manage-certs/google/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — Google credential ID.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• testGoogleConnection

  Test Google connection Tests the configured Google Wallet credentials by attempting to authenticate with the Google Wallet API. **Scope:** `certs:manage` Maps to OpenAPI operationId `testGoogleConnection` — POST /manage-certs/google/test. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• testAppleCertificates

  Test Apple certificates Generates an ephemeral test `.pkpass` file to verify that the uploaded Apple signing certificates are valid and complete. The test pass is not stored — it is returned directly as a binary download. **Scope:** `certs:manage` Maps to OpenAPI operationId `testAppleCertificates` — POST /manage-certs/test. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• getOrganization read-only

  Get organization details Returns the current organization's settings. **Scope:** `org:read` Maps to OpenAPI operationId `getOrganization` — GET /manage-org. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• updateOrganization

  Update organization settings Updates the current organization's settings, including APNs credentials. **Scope:** `org:manage` Maps to OpenAPI operationId `updateOrganization` — PATCH /manage-org. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • name — string — Organization display name.
  • slug — string — URL-friendly slug.
  • apns_key_id — string — Apple Push Notification service Key ID.
  • apns_key_p8 — string — APNs .p8 private key contents.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• getApp read-only

  Get current app details Returns the current app's settings. **Scope:** `org:read` Maps to OpenAPI operationId `getApp` — GET /manage-org/app. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• createApp

  Create a new app Creates a new app within the organization. **Scope:** `org:manage` Maps to OpenAPI operationId `createApp` — POST /manage-org/app. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • name — string — App display name.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• updateApp

  Update app settings Updates the current app's settings, including webhook configuration. Set `regenerate_webhook_secret` to `true` to generate a new webhook signing secret; the new secret is returned in `webhook_secret_raw` (shown only once). **Scope:** `org:manage` Maps to OpenAPI operationId `updateApp` — PATCH /manage-org/app. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • name — string — App display name.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • webhook_url — string — URL for async event webhook delivery.
  • signing_mode — string — Apple signing mode. `managed` uses platform credentials; `custom` uses your own.
  • apple_team_id — string — Apple Developer Team ID.
  • google_signing_mode — string — Google signing mode. `managed` uses platform credentials; `custom` uses your own.
  • onboarding_completed — boolean — Whether onboarding has been completed for this app.
  • pass_type_identifier — string — Apple pass type identifier (e.g., pass.com.example.myapp).
  • validation_webhook_url — string — URL for pre-generation validation webhooks.
  • regenerate_webhook_secret — boolean — Set to true to regenerate the webhook signing secret.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• deleteApp destructive

  Deactivate an app Deactivates the current app. This does not permanently delete data. **Scope:** `org:manage` Maps to OpenAPI operationId `deleteApp` — DELETE /manage-org/app. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• testWebhook

  Test the validation webhook Sends a sample validation webhook payload to the configured URL and returns the result. **Scope:** `org:manage` Maps to OpenAPI operationId `testWebhook` — POST /manage-org/app/test-webhook. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• getManagedSigningStatus read-only

  Check managed signing availability Returns whether managed (platform) signing credentials are available for Apple and Google wallets. When `apple_ready` or `google_ready` is `true`, apps can use `signing_mode: "managed"` or `google_signing_mode: "managed"` without uploading their own credentials. **Scope:** `org:read` Maps to OpenAPI operationId `getManagedSigningStatus` — GET /manage-org/managed-signing-status. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• listWebhookEvents read-only

  List webhook events Returns a paginated list of webhook event delivery records for the current app. **Scope:** `org:read` Maps to OpenAPI operationId `listWebhookEvents` — GET /manage-org/webhook-events. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • limit — integer — Maximum number of results to return.
  • offset — integer — Number of results to skip.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.
  • event_type — string — Filter by event type.
  • delivery_status — string — Filter by delivery status.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• listApiKeys read-only

  List API keys Returns all API keys for the current organization. **Scope:** `org:manage` Maps to OpenAPI operationId `listApiKeys` — GET /manage-keys. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• createApiKey

  Create an API key Creates a new API key. The response contains `id`, `name`, `key_type`, `key_prefix`, `raw_key`, and `message`. The full raw key is shown only once and cannot be retrieved again. **Scope:** `org:manage` Maps to OpenAPI operationId `createApiKey` — POST /manage-keys. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • name (required) — string — Human-readable label for the key.
  • key_type (required) — string — Key type. Secret keys have full access; publishable keys have limited scopes.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• revokeApiKey destructive

  Revoke an API key Revokes an API key, making it inactive. Revoked keys cannot authenticate. **Scope:** `org:manage` Maps to OpenAPI operationId `revokeApiKey` — PATCH /manage-keys/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — API key ID.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• deleteApiKey destructive

  Delete an API key Permanently deletes an API key. The key **must be revoked first** (via PATCH) before it can be deleted. Attempting to delete an active key returns 400. **Scope:** `org:manage` Maps to OpenAPI operationId `deleteApiKey` — DELETE /manage-keys/{id}. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • id (required) — string — API key ID.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• createShareToken

  Create a share token Creates a public share token for a pass, enabling distribution via URL, QR code, or messaging. The share URL points to a public page where recipients can add the pass to Apple or Google Wallet without logging in. Idempotent — if the pass already has a share token, the existing token is returned (200) instead of creating a new one (201). For dual-wallet passes (same serial number with both Apple and Google), the share token is automatically applied to all sibling passes. **Scope:** `passes:manage` Maps to OpenAPI operationId `createShareToken` — POST /share-pass/create. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • pass_id (required) — string — ID of the pass to share.
  • x_app_id — string — Override X-App-Id for this call. Omit the connection header by default; set it only for multi-app orgs.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• getSharePassMetadata read-only

  Get shared pass metadata Returns public metadata for a shared pass. No authentication required. Used by the public share page to display wallet buttons and pass info. Maps to OpenAPI operationId `getSharePassMetadata` — GET /share-pass/{token}. Public endpoint — no API key required. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • token (required) — string — Share token (32 hex characters).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• downloadSharedPass read-only

  Download shared Apple .pkpass Downloads the Apple `.pkpass` file for a shared pass. No authentication required. Only works for active Apple passes. Maps to OpenAPI operationId `downloadSharedPass` — GET /share-pass/{token}/download. Public endpoint — no API key required. Same PassFast HTTP API, billing, and rate limits. Do not invent other paths.

  Parameters:

  • token (required) — string — Share token (32 hex characters).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.