Jackpot

Get one execution (deliverable asset) by public_id (requires executions:read). Returns safe metadata, provenance, and, when include_assets is true, the authorized asset card for jackpot.render_asset_gallery. Inaccessible associated assets are omitted. This is not a visual-regression or campaign-comparison tool. No queue/job IDs, provider payloads, or storage paths.

jackpot.get_execution

Source of truth for a brand’s official current identity assets in Jackpot (primary logo / brandmark, approved alternate logos, horizontal lockup, icon, logo on dark, logo on light). Use this when the user asks for the official, current, approved, or governed logo — not jackpot.search_assets. Keyword search is a separate discovery tool and must not be treated as official. Requires brand_public_id from jackpot.list_accessible_brands. Optional identity_role filters to one canonical role. Each identity_roles entry is available, configured_unavailable, or not_configured — never infer a missing role from search. If match_status is none, the role is not configured. If match_status is configured_unavailable, Jackpot has the role assigned but the asset is ineligible (unpublished, unapproved, or unpublished Brand Guidelines). In both cases do_not_substitute is true: do not substitute another search result, do not invent a logo, and do not pick a lookalike file. There is no canonical footer_mark role.

jackpot.get_official_brand_assets

Get the status of a Jackpot MCP operation (attach_asset, preview_edit, generated_result_save, or save_to_jackpot). queued / preparing / generating / finalizing are not success — only status=succeeded means a preview-edit prototype is ready. Succeeded preview edits include an unsaved prototype, conversation preview, credits charged, saved_to_jackpot=false, and allowed_next_actions. Failed edits include failure_category, credits_refunded, and whether retry is allowed. Raw provider errors stay internal.

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

Discover where the user can save into Jackpot. Returns accessible brands plus library Asset folders and Execution (deliverable) folders separately. Inaccessible folders are omitted. Use before jackpot.preview_save_to_jackpot. Does not list external Shopify/WordPress destinations — those remain jackpot.search_destinations.

jackpot.get_save_destinations

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 version history for one authorized Jackpot asset. is_current identifies the active/current version (not necessarily the highest number). Historical versions are not general search hits. Requires assets:read. Does not restore or create versions.

jackpot.list_asset_versions

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 for iframe display). Attach uses the existing medium download-export PNG sibling when available. Never returns or uploads the canonical original. App-only and read-only.

jackpot.prepare_asset_for_chat

Open the Jackpot file picker when Save to Jackpot is missing a usable ChatGPT host file. Call this after jackpot.preview_save_to_jackpot returns source_unavailable / source_fetch_failed with recovery_tool=jackpot.prepare_save_source, or when the user needs to choose/upload the image. Pass any known destination fields (brand, folder, title, target_kind, save_mode) so the widget can retain them; the server reauthorizes destinations on preview and confirm. The widget uses selectFiles/uploadFile + getFileDownloadUrl, then calls preview_save_to_jackpot.

jackpot.prepare_save_source

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

Plan saving a file into Jackpot as an Asset or Execution. Does not create a library asset or execution. Supported sources: (1) jackpot_preview_edit — copies a successful preview-edit already stored in Jackpot; (2) chatgpt_file — this call fetches the file from the openai/fileParams download_url ({download_url, file_id, mime_type?, file_name?}) or an allowlisted HTTPS download_url sidecar. Those hosts are outside Jackpot. An inline data_url is accepted without a host fetch. A generated image that is only visible in chat is NOT automatically available. If the host cannot supply a usable file object, call jackpot.prepare_save_source so the user can select or upload the image, then retry. Do not invent file_id values. If target_kind is omitted, the tool asks Asset vs Execution. save_mode is new_asset (default) or new_version (existing Asset only; never chosen silently). Then confirm with jackpot.save_to_jackpot using the returned save_preview_public_id.

jackpot.preview_save_to_jackpot

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

Confirm a previously planned Save to Jackpot. Requires save_preview_public_id from jackpot.preview_save_to_jackpot, confirm=true, and idempotency_key. Does not accept a new file or destination — changing those requires a new preview. Poll jackpot.get_operation_status for processing. Original Jackpot source files are never overwritten; new_version adds a new current version on the chosen existing Asset.

jackpot.save_to_jackpot

Read-only search of approved Jackpot assets (same derivatives as the Jackpot web app — never originals). This is general library discovery — not the source of truth for official logos. The top result is not official. Do not tell the user a file is the official/current logo unless identity.is_official is true on that card (set only when Jackpot has configured it as identity) or jackpot.get_official_brand_assets returned it. For “the official current logo”, call jackpot.get_official_brand_assets instead of inferring from this search. 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. Sort=newest is created_at, not version control. 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