Agent C — App Store Screenshots

The user's apps in Agent C, with how many screenshots each has uploaded.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Add an app by its App Store link (imports name, icon, description), or by name if it isn't released yet. Importing a live app takes ~10-30s; poll list_apps until status is 'ready'.

{
  "type": "object",
  "properties": {
    "app_store_url": {
      "type": "string",
      "description": "e.g. https://apps.apple.com/us/app/…/id123456789"
    },
    "name": {
      "type": "string",
      "description": "Only for apps not on the App Store yet"
    }
  },
  "required": [],
  "additionalProperties": false
}

Best way to upload screenshots from files on disk: returns a one-time URL (valid 30 min) to POST the image files to with curl (multipart field 'files', up to 10 per request). Use this instead of upload_screenshots when you have a shell, so large images don't pass through the conversation.

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "app_id from list_apps / add_app"
    },
    "replace": {
      "type": "boolean",
      "default": true,
      "description": "First upload clears the app's old screenshots"
    }
  },
  "required": [
    "app_id"
  ],
  "additionalProperties": false
}

Upload 1-10 raw screenshots of the app (plain captures of the real UI, ideally 4-10, in the order you'd like them considered). Each item is base64 image data (PNG/JPEG) or a public https URL. By default replaces the app's screenshot library.

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "app_id from list_apps / add_app"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 10
    },
    "replace": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "app_id",
    "images"
  ],
  "additionalProperties": false
}

Claude art-directs a full App Store screenshot set from the uploaded screenshots: opening shot, headline per slide, close-ups, palette. Returns watermarked preview images, the slide list and a link to open it in the Agent C studio. Takes ~40-60 seconds.

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "app_id from list_apps / add_app"
    },
    "opener": {
      "type": "string",
      "enum": [
        "auto",
        "hand",
        "icon",
        "photo",
        "phone"
      ],
      "default": "auto",
      "description": "Opening slide: hand holding the phone, big app icon, lifestyle photo, or a plain phone. auto lets Claude pick."
    },
    "focus": {
      "type": "string",
      "description": "Optional: what to emphasize (feature, audience, angle)."
    },
    "device": {
      "type": "string",
      "enum": [
        "iphone_69",
        "iphone_65",
        "ipad_13"
      ],
      "default": "iphone_69"
    },
    "include": {
      "type": "string",
      "enum": [
        "screenshots",
        "both",
        "header"
      ],
      "default": "screenshots",
      "description": "What to make: the screenshot set, screenshots + the App Store product page header (iOS 27), or only the header"
    }
  },
  "required": [
    "app_id"
  ],
  "additionalProperties": false
}

Current slides, unlock status and fresh preview images for a set.

{
  "type": "object",
  "properties": {
    "set_id": {
      "type": "string",
      "description": "set_id returned by design_set"
    }
  },
  "required": [
    "set_id"
  ],
  "additionalProperties": false
}

Change one slide (headline, subline, screenshot, layout, position, or remove it), the opening shot, the device size, or the App Store header (header_*). Re-renders previews. Free.

{
  "type": "object",
  "properties": {
    "set_id": {
      "type": "string",
      "description": "set_id returned by design_set"
    },
    "slide": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based slide number to change"
    },
    "headline": {
      "type": "string",
      "description": "Wrap words in *stars* to color them"
    },
    "subline": {
      "type": "string"
    },
    "screenshot": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based screenshot to show on this slide"
    },
    "layout": {
      "type": "string",
      "enum": [
        "standard",
        "closeup",
        "tilt"
      ]
    },
    "move_to": {
      "type": "integer",
      "minimum": 1
    },
    "remove": {
      "type": "boolean"
    },
    "opener": {
      "type": "string",
      "enum": [
        "hand",
        "icon",
        "photo",
        "phone"
      ]
    },
    "device": {
      "type": "string",
      "enum": [
        "iphone_69",
        "iphone_65",
        "ipad_13"
      ]
    },
    "header_headline": {
      "type": "string",
      "description": "App Store header headline (*stars* color words). No prices, URLs, platform names or #1 claims."
    },
    "header_subline": {
      "type": "string"
    },
    "header_layout": {
      "type": "string",
      "enum": [
        "photo",
        "phones",
        "icon",
        "hand"
      ],
      "description": "Header visual: lifestyle photo, three phones, big icon, or a hand holding the phone"
    },
    "include": {
      "type": "string",
      "enum": [
        "screenshots",
        "both",
        "header"
      ],
      "default": "screenshots",
      "description": "What to make: the screenshot set, screenshots + the App Store product page header (iOS 27), or only the header"
    }
  },
  "required": [
    "set_id"
  ],
  "additionalProperties": false
}

Unlock clean, full-resolution files for a set. Uses a free unlock if the user has one; otherwise returns a $9.99 Stripe checkout link the USER must open and pay. Studio subscribers are already unlocked. Ask the user before calling.

{
  "type": "object",
  "properties": {
    "set_id": {
      "type": "string",
      "description": "set_id returned by design_set"
    }
  },
  "required": [
    "set_id"
  ],
  "additionalProperties": false
}

Render the unlocked set at exact App Store pixels without watermark and return download links (valid 7 days). Includes the product page header (3840x1646) and search-results image (3840x2560) when the set has a header.

{
  "type": "object",
  "properties": {
    "set_id": {
      "type": "string",
      "description": "set_id returned by design_set"
    }
  },
  "required": [
    "set_id"
  ],
  "additionalProperties": false
}

Upload the unlocked set into the app's editable version in App Store Connect, replacing that language's screenshots for this device size. Never submits for review. Requires the user to have connected App Store Connect in Agent C. If the app has no editable version, ask the user, then call with create_version=true.

{
  "type": "object",
  "properties": {
    "set_id": {
      "type": "string",
      "description": "set_id returned by design_set"
    },
    "create_version": {
      "type": "boolean",
      "default": false
    },
    "locale": {
      "type": "string",
      "default": "en-US"
    }
  },
  "required": [
    "set_id"
  ],
  "additionalProperties": false
}