Jackpot

Get the status of a Jackpot MCP operation (attach_asset, preview_edit, or generated_result_save). Preview-edit results include a short-lived unsaved prototype URL when succeeded.

jackpot.get_operation_status

Estimate credits and prepare a short-lived quote for a Jackpot-owned preview edit. Does not charge credits or modify the original asset. Requires assets:preview_edit. Pass the returned quote_public_id to jackpot.create_preview_edit with confirm=true.

jackpot.get_preview_edit_quote

List the organizations and brands available through this Jackpot connection, grouped by organization, with the effective role and capability summary per brand. Read-only; performs no asset search. Results follow the user's live Jackpot permissions and this connection's grant restrictions (never every organization in the system).

jackpot.list_accessible_brands

List collections the user can view in authorized brands (requires collections:read). Uses the same CollectionPolicy visibility and public_id values as jackpot.get_asset_search_facets. Filter by brand_public_ids, query, and type (manual|automated). Then use jackpot.get_collection or jackpot.search_assets with collection_public_ids.

jackpot.list_collections

List configured external integration connections (e.g. Shopify stores, WordPress sites) you are authorized to use, with their capabilities and brand assignments.

jackpot.list_integration_connections

Prepare a ChatGPT editing copy of a selected Jackpot asset for the gallery widget. Default edit_mode is preview_prototype (largest existing WebP/JPEG/PNG preview). Never returns or uploads the canonical original. App-only and read-only.

jackpot.prepare_asset_for_chat

Preview attaching an authorized Jackpot asset to a connected destination. Read-only: does not upload or mutate destination content. Use the returned preview_public_id with jackpot.attach_asset confirm=true.

jackpot.preview_asset_attachment

Preview a controlled metadata update for an authorized Jackpot asset (title and tags). Read-only: does not mutate the asset. Returns an exact before/after diff and update_preview_public_id for jackpot.apply_asset_metadata_update.

jackpot.preview_asset_metadata_update

Refresh short-lived signed thumbnail URLs for assets currently visible in the Jackpot gallery widget. Callable from the MCP Apps iframe only. Never exposes signed URLs to the model.

jackpot.refresh_gallery_thumbnails

Render an inline Jackpot visual asset gallery (MCP Apps iframe). Pass asset_ids from jackpot.search_assets / jackpot.get_collection (max 20; prefer 10), OR collection_public_id to show that collection visually (requires collections:read). Prefer jackpot.show_asset_gallery for one-shot search→gallery. Use whenever the user asks to see, browse, compare, or choose assets visually. Do not paste markdown images or signed URLs — this tool mounts the gallery component.

jackpot.render_asset_gallery

Save a successful Jackpot preview-edit prototype as a NEW asset (requires confirm=true, assets:create, and assets:preview_edit). Pass the preview-edit operation_public_id only — never a signed URL or storage path. Does not overwrite the source asset. Poll jackpot.get_operation_status for the new asset identity.

jackpot.save_generated_result

Read-only search of approved Jackpot assets (same derivatives as the Jackpot web app — never originals). Discover filters first with jackpot.get_asset_search_facets. Supports: keyword (optional when structured filters are set); brand_public_ids; folder_public_ids (library categories — flat OR within facet); collection_public_ids; tags (any-of); attribute_filters [{field_key, operator: equals|in|contains|exists, value}]; types; approval_state; orientation; created_after/before; sort (newest|oldest|most_viewed|most_downloaded); activity_window (all_time|30_days|90_days) for engagement sorts; pagination (default 10, max 50). Filters across facet types are AND. Inaccessible public IDs never broaden results. most_viewed uses asset drawer/large_view metrics (not grid impressions). Ranked relevance is not supported. For a visual MCP Apps gallery prefer jackpot.show_asset_gallery (one-shot), or after this tool call jackpot.render_asset_gallery with asset public_ids from gallery_handoff. Do not paste markdown images or signed CDN URLs.

jackpot.search_assets

Search destinations (e.g. Shopify products, WordPress posts/pages) on a connected external service, in a provider-neutral shape.

jackpot.search_destinations

Search executions (Jackpot deliverable assets at /app/executions) the user can view (requires executions:read). Public IDs only. Filter by brand, deliverable folder type/name, status, and dates. Then call jackpot.get_execution and optionally jackpot.render_asset_gallery with the execution’s asset public_id. Not IntegrationOperation or EBI multi-asset wrappers.

jackpot.search_executions

One-shot visual browse: search approved Jackpot assets and mount the MCP Apps gallery iframe in a single call. Prefer this when the user asks to see, browse, or show assets visually. Supports query, brand_public_ids, collection_public_ids, types, tags, sort, and title. Max 10 assets. Do not paste markdown images or signed URLs. For data-only search without the iframe, use jackpot.search_assets instead.

jackpot.show_asset_gallery