build_cloud
ChatGPTSubmit a signed store/web release build after secure signing setup is complete. Call get_build_setup first. If signing or protected files are missing, direct the customer to configure them in the FluxBuilder dashboard. Use build_test for an Android preview that does not require release signing. Args: project_id: Saved project id. outputs: Targets to build: apk, appbundle, ipa, pwa. language_code: Optional build-language ISO code, e.g. en.
build_test
ChatGPTQuick Android preview/test build, emailed to the authenticated customer; not a store release. No release setup, signing material, credentials, or store metadata input is needed. Args: project_id: Saved project id. language_code: Optional build-language ISO code, e.g. en.
capture
ChatGPTScreenshot a project's mobile preview by widget/section or tab-screen _id; use only when pixels matter. Args: project_id: Saved project id. object_id: Widget/section or tab-screen _id (see overview).
catalog_search
ChatGPTSearch live store catalog/blog data. Use returned ids/images/urls for bindings; do not invent catalog ids. Args: project_id: Saved project id (searches its connected store). query: Search text, e.g. summer dresses. Empty = browse: list the first top_k items. resource: product, category, blog, or blog_category. top_k: Max matches.
create
ChatGPTInsert new array items sequentially; preferred for screen/section rebuilds. Args: project_id: Saved project id. items: Ordered entries with schema_name/object. First item needs after_id or parent/array_key; later items append after the previous insert unless targeted. after_id supports $0, $1, $last. Never include _id/_schema in object.
docs_search
ChatGPTSearch FluxBuilder docs for setup/capability questions. Read-only and not project-scoped. Args: query: Question about FluxBuilder docs, e.g. set up Stripe payment. top_k: Max passages.
get_build_setup
ChatGPTRead release-build setup and missing items. Call before set_build_setup or build_cloud, not before build_test. Args: project_id: Saved project id.
inspect
ChatGPTInspect a live design node by its _id; use before editing existing nodes. Args: project_id: Saved project id. target: Node _id exactly as shown by overview (e.g. d369f790), or a dot-path from it. Names/labels are not targets. depth: Child levels to expand; deeper nodes are stubs.
list_projects
ChatGPTShow the authenticated customer's products and any empty slots. Returns: projects with id/name/frameworks/url, license/subscription flags, and is_empty_slot marking empty paid slots.
list_schemas
ChatGPTList schema ids available for a project; use exact ids with lookup. Args: project_id: Saved project id (index is filtered to its frameworks).
lookup
ChatGPTLoad schema/design docs by id; read before create/replace or field edits. Args: project_id: Saved project id (docs are filtered to its frameworks). items: [{id, read?}] where read is schema (fields/refs), design (layout guidance), or both. Use exact ids from list_schemas; default read is schema and widget ids auto-include design guidance. Add read: both for screens when composing visually.
move
ChatGPTReorder an item within its parent array by final position or by after_id. Args: project_id: Saved project id. id: Item _id or dot-path. position: Preferred: start, center, end, or final 0-based index. Overrides after_id. after_id: Sibling _id to place after; omitted means front. Ignored when position is set.
open_project
ChatGPTOpen a saved project and return a short summary. Args: project_id: Saved project id from list_projects.
overview
ChatGPTShow a project's design tree as one-level stubs. Args: project_id: Saved project id. Returns: navigation, structure, standaloneScreens; nodes include _id.
preview_link
ChatGPTPublish the project's current design and return a public live-preview link the customer can open in a browser. Unlike capture (a screenshot), this link renders the actual running app with live navigation. Republish (call again) after design changes to refresh what the link shows. Args: project_id: Saved project id. Returns: A web.fluxbuilder.com/app/{token} link; present it as a preview link to the customer.
remove
ChatGPTDelete visible array items by _id; preferred before rebuilding a screen/section. Args: project_id: Saved project id. ids: Node _ids to delete.
replace
ChatGPTSwap one array item for a new schema at the same position; use update if the type stays the same. Args: project_id: Saved project id. id: Array item _id; position is preserved. schema_name: New schema id. object: Props; never include _id/_schema.
resolve_assets
ChatGPTResolve and write images into existing nodes; use user-provided image URLs directly instead. Args: project_id: Saved project id. queries: One entry per image field: {id, path, type?, query, options?}. id is the target node _id; path the image field path, e.g. image or items.0.image; type is photo (default), icon, avatar, brand_logo, or illustration — for brand_logo pass a domain like apple.com as query; options allows refinements, e.g. orientation/color/role/style/size/theme.
set_build_setup
ChatGPTConfigure non-sensitive release-build metadata; only passed fields change. Read setup first. Signing files, passwords, certificates, keystores, deployment tokens, and service credentials are deliberately not accepted by this MCP tool. Set those in the secure FluxBuilder dashboard. Args: project_id: Saved project id. bundle_id: Reverse-DNS app id, e.g. com.yourbrand.app (not com.example.*). enable_onesignal: Keep a OneSignal push bundle id (default true when bundle_id set). app_name: App display name on the home screen. version_name: Marketing version, e.g. 1.0.0 (pass with build_number). build_number: Build number, e.g. 1 (pass with version_name). outputs: Targets to pre-select: any of 'apk', 'appbundle', 'ipa', 'pwa'.
stop_build
ChatGPTAsk FluxBuilder to stop the active cloud release build for a project.
update
ChatGPTPatch an existing node by _id or dot-path; for targeted in-place edits, not broad screen redesigns. Args: project_id: Saved project id. id: Node _id or dot-path. object: Props to change. Merge keeps omitted keys and merges arrays by item _id. mode: merge patches keys; replace overwrites props but keeps _id/_schema.
whoami
ChatGPTShow the signed-in customer and what they can do; call first after connecting, or when asked about login, account, or available features. Returns: user email/name, project counts with recent projects and their license state, capabilities with suggested prompts, and resource links.