Documentation
MCP (AI Agents)
Workflows

Workflows

Step-by-step recipes for common tasks using ButterKit’s MCP tools. Each workflow shows the tool calls in order. Your AI agent handles these automatically when you describe what you want in natural language.

Create a Screenshot Set from Scratch

Build a complete set of App Store screenshots from an empty document.

 1. document.list                → get documentId
 2. design.list_size_presets     → find the preset for your device (e.g. "iPhone 6.7\"")
 3. design.create_artboard       → name: "Hero Shot", sizePresetId: <id>
 4. design.create_artboard       → name: "Features", sizePresetId: <id>
 5. design.create_artboard       → name: "Details", sizePresetId: <id>
 6. design.list_templates        → pick a template
 7. design.apply_template        → apply to each artboard
 8. design.upsert_text_block     → set title/subtitle text on each artboard
 9. design.set_device_screenshot → set app screenshots on each device
10. design.set_background        → customize colors/gradients
11. document.save

Localize an Existing Project

Add languages and translate an existing set of artboards and metadata.

1. document.list                   → get documentId
2. localization.list_languages     → see current languages
3. localization.add_language       → languageCode: "es", autoTranslate: true
4. localization.add_language       → languageCode: "ja", autoTranslate: true
5. localization.set_metadata       → write base App Store description
6. localization.translate_metadata → languageCode: "es"
7. localization.translate_metadata → languageCode: "ja"
8. document.save

Upload to App Store Connect

Push screenshots and metadata to App Store Connect for a specific version.

1. asc.check_credentials    → verify API key is configured
2. asc.test_connection      → confirm connectivity
3. asc.list_apps            → find your app's ID
4. asc.list_versions        → find the editable version ID
5. asc.upload_screenshots   → for each locale (en-US, es-ES, ja, ...)
6. asc.upload_metadata      → for each locale

End-to-End: Capture, Design, Localize, Upload

The full pipeline in a single session: create artboards, apply designs, localize into multiple languages, and ship to App Store Connect.

 1. document.list                   → get documentId
 2. design.list_size_presets        → choose device sizes
 3. design.create_artboard (x N)   → create artboards for each screenshot
 4. design.apply_template           → style each artboard
 5. design.upsert_text_block        → set marketing copy
 6. design.set_device_screenshot    → apply app screenshots
 7. localization.add_language (x N) → add target languages with auto-translate
 8. localization.set_metadata       → write base metadata
 9. localization.translate_metadata (x N) → translate metadata per language
10. design.export_artboards         → export for review
11. asc.upload_screenshots          → upload per locale
12. asc.upload_metadata             → upload per locale
13. document.save

Tips

  • You don’t need to memorize these sequences. Describe the outcome you want in plain language (“Translate my screenshots into French, German, and Japanese, then upload everything to App Store Connect”) and the AI agent will figure out the right tool calls.
  • Use design.export_preview at any point to visually inspect an artboard mid-workflow.
  • Always call document.save when you’re happy with the result.

Quick Help

Tool Reference