@qingflow-tech/qingflow-app-builder-mcp 1.0.2 → 1.0.4

package/src/qingflow_mcp/response_trim.py

@@ -263,6 +263,15 @@ def _trim_workspace_list(payload: JSONObject) -> None:
         _trim_item_list(page, "list", allowed=("wsId", "workspaceName", "remark"))
 
 
+def _trim_workspace_get(payload: JSONObject) -> None:
+    workspace = payload.get("workspace")
+    if isinstance(workspace, dict):
+        payload["workspace"] = _pick(
+            workspace,
+            allowed=("wsId", "workspaceName", "remark", "systemVersion", "auth"),
+        )
+
+
 def _trim_app_search_like(payload: JSONObject) -> None:
     payload.pop("apps", None)
     _trim_item_list(payload, "items", allowed=("app_key", "app_name", "package_name"))
@@ -287,34 +296,175 @@ def _trim_file_upload_local(payload: JSONObject) -> None:
 
 
 def _trim_import_schema(payload: JSONObject) -> None:
-    pass
+    columns: list[JSONObject] | None = None
+    if isinstance(payload.get("columns"), list):
+        columns = [item for item in payload.get("columns", []) if isinstance(item, dict)]
+    elif isinstance(payload.get("expected_columns"), list):
+        columns = [item for item in payload.get("expected_columns", []) if isinstance(item, dict)]
+    if columns is not None:
+        payload["columns"] = [_compact_import_column(item) for item in columns]
+    payload.pop("expected_columns", None)
+    payload.pop("schema_fingerprint", None)
+    payload.pop("import_capability", None)
+    payload.pop("request_route", None)
+    payload.pop("verification", None)
+
+    if _looks_like_import_verify(payload):
+        _trim_import_verify_payload(payload)
+        return
+    if "applied_repairs" in payload or "repaired_file_path" in payload:
+        _trim_import_repair_payload(payload)
+        return
+    if "template_url" in payload or "downloaded_to_path" in payload:
+        _trim_import_template_payload(payload)
+        return
+    if "import_id" in payload or "process_id_str" in payload:
+        _trim_import_status_payload(payload)
+        return
 
 
 def _trim_record_schema(payload: JSONObject) -> None:
     payload.pop("legacy_schema", None)
+    template_map = payload.get("payload_template")
+    if not isinstance(template_map, dict):
+        template_map = None
+
+    if "writable_fields" in payload:
+        writable_fields = payload.get("writable_fields")
+        payload.pop("writable_fields", None)
+        required_fields: list[JSONObject] = []
+        optional_fields: list[JSONObject] = []
+        if isinstance(writable_fields, list):
+            for item in writable_fields:
+                compact = _compact_schema_field(item, template_map=template_map)
+                if not compact:
+                    continue
+                if compact.get("required") is True:
+                    required_fields.append(compact)
+                else:
+                    optional_fields.append(compact)
+        payload["required_fields"] = required_fields
+        payload["optional_fields"] = optional_fields
+
+    for key in ("required_fields", "optional_fields", "runtime_linked_required_fields", "fields", "ambiguous_fields"):
+        if key in payload:
+            payload[key] = _compact_schema_fields(payload.get(key), template_map=template_map)
+
+    for key in ("suggested_dimensions", "suggested_metrics", "suggested_time_fields"):
+        if isinstance(payload.get(key), list):
+            payload[key] = [
+                _pick(item, ("field_id", "title")) for item in payload.get(key) if isinstance(item, dict)
+            ]
+
+    for key in ("workflow_node", "view_resolution", "field_count"):
+        payload.pop(key, None)
 
 
 def _trim_record_write(payload: JSONObject) -> None:
+    payload.pop("verification", None)
     data = payload.get("data")
     if not isinstance(data, dict):
         return
+    data.pop("debug", None)
     data.pop("normalized_payload", None)
     data.pop("human_review", None)
     data.pop("action", None)
+    resource = _compact_record_resource(data.get("resource"))
+    if resource:
+        data["resource"] = resource
+    else:
+        data.pop("resource", None)
+    verification = data.get("verification")
+    if isinstance(verification, dict):
+        compact_verification = _pick(
+            verification,
+            (
+                "verified",
+                "verification_mode",
+                "field_level_verified",
+            ),
+        )
+        if compact_verification:
+            data["verification"] = compact_verification
+        else:
+            data.pop("verification", None)
+    for key in ("blockers", "field_errors", "confirmation_requests", "resolved_fields"):
+        value = data.get(key)
+        if value in (None, [], {}, ""):
+            data.pop(key, None)
 
 
 def _trim_record_get(payload: JSONObject) -> None:
-    _keep_nested_keys(payload, ("data", "selection", "view"), allowed=("view_id", "name"))
-    _drop_nested_keys(payload, ("data", "selection"), keys=("columns", "workflow_node_id"))
+    data = payload.get("data")
+    if not isinstance(data, dict):
+        return
+    compact: dict[str, Any] = {}
+    app_key = data.get("app_key")
+    if app_key:
+        compact["app_key"] = app_key
+    record_id = data.get("record_id")
+    if record_id not in (None, ""):
+        compact["record_id"] = str(record_id)
+    record = data.get("record")
+    if isinstance(record, dict):
+        compact["record"] = record
+    normalized_record = data.get("normalized_record")
+    if isinstance(normalized_record, dict):
+        compact["normalized_record"] = normalized_record
+    normalized_ambiguous_fields = data.get("normalized_ambiguous_fields")
+    if isinstance(normalized_ambiguous_fields, dict):
+        compact["normalized_ambiguous_fields"] = normalized_ambiguous_fields
+    payload["data"] = compact
 
 
 def _trim_record_list(payload: JSONObject) -> None:
-    _keep_nested_keys(payload, ("data", "selection", "view"), allowed=("view_id", "name"))
-    _drop_nested_keys(payload, ("data", "selection"), keys=("columns",))
+    data = payload.get("data")
+    if not isinstance(data, dict):
+        return
+    pagination = data.get("pagination") if isinstance(data.get("pagination"), dict) else {}
+    returned_items = pagination.get("returned_items")
+    result_amount = pagination.get("result_amount")
+    limit = pagination.get("limit")
+    truncated = False
+    if isinstance(result_amount, int) and isinstance(returned_items, int):
+        truncated = result_amount > returned_items
+    compact_pagination = {
+        "loaded": True,
+        "page_size": limit,
+        "fetched_pages": 1,
+        "reported_total": result_amount,
+        "truncated": truncated,
+    }
+    selection = data.get("selection") if isinstance(data.get("selection"), dict) else {}
+    view = selection.get("view") if isinstance(selection.get("view"), dict) else {}
+    compact: dict[str, Any] = {
+        "app_key": data.get("app_key"),
+        "items": data.get("items") if isinstance(data.get("items"), list) else [],
+        "pagination": compact_pagination,
+    }
+    if view:
+        compact["view"] = _pick(view, ("view_id", "name"))
+    payload["data"] = compact
 
 
 def _trim_record_analyze(payload: JSONObject) -> None:
-    _drop_deep_keys(payload, {"debug"})
+    summary: dict[str, Any] = {}
+    completeness = payload.get("completeness")
+    if isinstance(completeness, dict):
+        summary["completeness"] = completeness
+    presentation = payload.get("presentation")
+    if isinstance(presentation, dict):
+        summary["presentation"] = presentation
+    ranking = payload.get("ranking")
+    if isinstance(ranking, dict):
+        summary["ranking"] = ranking
+    error = payload.get("error")
+    if isinstance(error, dict):
+        summary["error"] = error
+    if summary:
+        payload["summary"] = summary
+    for key in ("query", "ranking", "ratios", "completeness", "presentation", "error", "debug"):
+        payload.pop(key, None)
 
 
 def _trim_code_block_schema(payload: JSONObject) -> None:
@@ -334,6 +484,229 @@ def _trim_task_get(payload: JSONObject) -> None:
     _drop_deep_keys(payload, {"request_route", "output_profile"})
 
 
+def _trim_task_context_detail(payload: JSONObject) -> None:
+    _drop_deep_keys(payload, {"request_route", "output_profile"})
+
+
+def _trim_record_delete(payload: JSONObject) -> None:
+    data = payload.get("data")
+    if not isinstance(data, dict):
+        return
+    resource = data.get("resource")
+    deleted_ids: list[str] = []
+    if isinstance(resource, dict):
+        raw_ids = resource.get("record_ids") or resource.get("apply_ids") or resource.get("applyIds")
+        if isinstance(raw_ids, list):
+            deleted_ids = [str(item) for item in raw_ids if item not in (None, "")]
+    data["deleted_ids"] = deleted_ids
+    data.setdefault("failed_ids", [])
+    for key in (
+        "resource",
+        "action",
+        "normalized_payload",
+        "human_review",
+        "verification",
+        "blockers",
+        "field_errors",
+        "confirmation_requests",
+        "resolved_fields",
+        "debug",
+    ):
+        data.pop(key, None)
+
+
+def _compact_record_resource(resource: Any) -> dict[str, Any] | None:
+    if not isinstance(resource, dict):
+        return None
+    compact: dict[str, Any] = {}
+    if resource.get("type") not in (None, ""):
+        compact["type"] = resource.get("type")
+    app_key = resource.get("app_key") or resource.get("appKey")
+    if app_key not in (None, ""):
+        compact["app_key"] = app_key
+    record_id = resource.get("record_id")
+    if record_id not in (None, ""):
+        compact["record_id"] = str(record_id)
+    apply_id = resource.get("apply_id") or resource.get("applyId")
+    if apply_id not in (None, "") and "record_id" not in compact:
+        compact["record_id"] = str(apply_id)
+    record_ids = resource.get("record_ids")
+    if isinstance(record_ids, list):
+        compact["record_ids"] = [str(item) for item in record_ids if item not in (None, "")]
+    apply_ids = resource.get("apply_ids") or resource.get("applyIds")
+    if isinstance(apply_ids, list) and "record_ids" not in compact:
+        compact["record_ids"] = [str(item) for item in apply_ids if item not in (None, "")]
+    return compact or None
+
+
+def _compact_schema_fields(items: Any, *, template_map: dict[str, Any] | None) -> list[JSONObject]:
+    if not isinstance(items, list):
+        return []
+    compacted: list[JSONObject] = []
+    for item in items:
+        compact = _compact_schema_field(item, template_map=template_map)
+        if compact:
+            compacted.append(compact)
+    return compacted
+
+
+def _compact_schema_field(item: Any, *, template_map: dict[str, Any] | None) -> JSONObject | None:
+    if not isinstance(item, dict):
+        return None
+    compact: dict[str, Any] = {}
+    field_id = item.get("field_id")
+    if field_id not in (None, ""):
+        compact["field_id"] = field_id
+    title = item.get("title")
+    if title not in (None, ""):
+        compact["title"] = title
+    kind = item.get("kind") or item.get("write_kind")
+    if kind not in (None, ""):
+        compact["kind"] = kind
+    if "required" in item:
+        compact["required"] = bool(item.get("required"))
+    if template_map is not None and isinstance(title, str) and title in template_map:
+        compact["template"] = template_map.get(title)
+    candidate_hint = item.get("candidate_hint")
+    if isinstance(candidate_hint, dict):
+        compact["candidate_hint"] = candidate_hint
+    options = item.get("options")
+    if isinstance(options, list) and options:
+        compact["options"] = options
+    target_app_key = item.get("target_app_key")
+    if isinstance(target_app_key, str) and target_app_key:
+        compact["target_app_key"] = target_app_key
+    searchable_fields = item.get("searchable_fields")
+    if isinstance(searchable_fields, list) and searchable_fields:
+        compact["searchable_fields"] = searchable_fields
+    row_fields = item.get("row_fields")
+    if isinstance(row_fields, list) and row_fields:
+        compact["row_fields"] = _compact_schema_fields(row_fields, template_map=None)
+    return compact or None
+
+
+def _compact_import_column(item: dict[str, Any]) -> dict[str, Any]:
+    compact: dict[str, Any] = {}
+    title = item.get("title")
+    if title not in (None, ""):
+        compact["title"] = title
+    kind = item.get("kind") or item.get("write_kind")
+    if kind not in (None, ""):
+        compact["kind"] = kind
+    compact["required"] = bool(item.get("required"))
+    options = item.get("options")
+    if isinstance(options, list) and options:
+        compact["options"] = options
+    if bool(item.get("accepts_natural_input")):
+        compact["accepts_natural_input"] = True
+    if bool(item.get("requires_upload")):
+        compact["requires_upload"] = True
+    target_app_key = item.get("target_app_key")
+    if isinstance(target_app_key, str) and target_app_key:
+        compact["target_app_key"] = target_app_key
+    target_app_name = item.get("target_app_name")
+    if isinstance(target_app_name, str) and target_app_name:
+        compact["target_app_name"] = target_app_name
+    searchable_fields = item.get("searchable_fields")
+    if isinstance(searchable_fields, list) and searchable_fields:
+        compact["searchable_fields"] = searchable_fields
+    return compact
+
+
+def _looks_like_import_verify(payload: JSONObject) -> bool:
+    return "verification_id" in payload and "can_import" in payload
+
+
+def _trim_import_verify_payload(payload: JSONObject) -> None:
+    issues = payload.get("issues") if isinstance(payload.get("issues"), list) else []
+    issue_summary = _summarize_import_issues(issues)
+    payload["issue_summary"] = issue_summary
+    columns = payload.get("columns")
+    if "expected_columns" not in payload and isinstance(columns, list):
+        payload["expected_columns"] = columns
+    file_name = payload.get("file_name")
+    if not file_name:
+        file_path = payload.get("file_path")
+        if isinstance(file_path, str) and file_path:
+            payload["file_name"] = file_path.split("/")[-1]
+    for key in ("apply_rows", "schema_fingerprint", "import_capability", "file_sha256", "verified_file_sha256", "file_format", "local_precheck_limited"):
+        payload.pop(key, None)
+
+
+def _trim_import_repair_payload(payload: JSONObject) -> None:
+    payload["verification_id"] = payload.get("new_verification_id") or payload.get("verification_id")
+    post_repair_issues = payload.get("post_repair_issues")
+    if isinstance(post_repair_issues, list):
+        payload["post_repair_issue_summary"] = _summarize_import_issues(post_repair_issues)
+    for key in ("new_verification_id", "verification"):
+        payload.pop(key, None)
+
+
+def _trim_import_template_payload(payload: JSONObject) -> None:
+    for key in ("schema_fingerprint", "verification"):
+        payload.pop(key, None)
+
+
+def _trim_import_status_payload(payload: JSONObject) -> None:
+    total_rows = payload.get("total_rows")
+    success_rows = payload.get("success_rows")
+    failed_rows = payload.get("failed_rows")
+    payload["total"] = total_rows
+    if isinstance(success_rows, int) and isinstance(failed_rows, int):
+        payload["finished"] = success_rows + failed_rows
+    elif isinstance(success_rows, int):
+        payload["finished"] = success_rows
+    else:
+        payload["finished"] = None
+    payload["succeeded"] = success_rows
+    payload["failed"] = failed_rows
+    for key in (
+        "matched_by",
+        "source_file_name",
+        "total_rows",
+        "success_rows",
+        "failed_rows",
+        "operate_time",
+        "operate_user",
+        "verification",
+    ):
+        payload.pop(key, None)
+
+
+def _trim_export_payload(payload: JSONObject) -> None:
+    payload.pop("backend_export_id", None)
+
+
+def _summarize_import_issues(issues: list[Any]) -> dict[str, Any]:
+    total = 0
+    error_count = 0
+    warning_count = 0
+    sample: list[dict[str, Any]] = []
+    for item in issues:
+        if not isinstance(item, dict):
+            continue
+        total += 1
+        severity = str(item.get("severity") or "").lower()
+        if severity == "error":
+            error_count += 1
+        if severity == "warning":
+            warning_count += 1
+        if len(sample) < 3:
+            sample.append(
+                {
+                    "code": item.get("code"),
+                    "message": item.get("message"),
+                    "severity": item.get("severity"),
+                }
+            )
+    return {
+        "total": total,
+        "errors": error_count,
+        "warnings": warning_count,
+        "sample": sample,
+    }
+
+
 def _trim_directory(payload: JSONObject) -> None:
     pass
 
@@ -367,6 +740,7 @@ def _register_policy(domains: tuple[str, ...], names: tuple[str, ...], transform
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("auth_use_credential", "auth_whoami"), _trim_auth_payload)
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("auth_logout",), _trim_auth_logout)
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("workspace_list",), _trim_workspace_list)
+_register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("workspace_get", "workspace_select"), _trim_workspace_get)
 _register_policy((USER_DOMAIN,), ("app_list", "app_search"), _trim_app_search_like)
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("app_get",), _trim_app_get)
 _register_policy((BUILDER_DOMAIN,), ("app_repair_code_blocks",), _trim_builder_list_like)
@@ -385,6 +759,16 @@ _register_policy(
     ),
     _trim_import_schema,
 )
+_register_policy(
+    (USER_DOMAIN,),
+    (
+        "record_export_start",
+        "record_export_status_get",
+        "record_export_get",
+        "record_export_direct",
+    ),
+    _trim_export_payload,
+)
 _register_policy(
     (USER_DOMAIN,),
     (
@@ -402,15 +786,15 @@ _register_policy((USER_DOMAIN,), ("record_list",), _trim_record_list)
 _register_policy((USER_DOMAIN,), ("record_analyze",), _trim_record_analyze)
 _register_policy((USER_DOMAIN,), ("record_code_block_run",), _trim_code_block_run)
 _register_policy((USER_DOMAIN,), ("task_list",), _trim_task_list)
+_register_policy((USER_DOMAIN,), ("task_get",), _trim_task_get)
 _register_policy(
     (USER_DOMAIN,),
     (
-        "task_get",
         "task_action_execute",
         "task_associated_report_detail_get",
         "task_workflow_log_get",
     ),
-    _trim_task_get,
+    _trim_task_context_detail,
 )
 _register_policy(
     (USER_DOMAIN,),
@@ -431,10 +815,10 @@ _register_policy(
     (
         "record_member_candidates",
         "record_department_candidates",
-        "record_delete",
     ),
     _trim_builder_list_like,
 )
+_register_policy((USER_DOMAIN,), ("record_delete",), _trim_record_delete)
 _register_policy(
     (BUILDER_DOMAIN,),
     (
@@ -447,6 +831,7 @@ _register_policy(
         "role_create",
         "app_release_edit_lock_if_mine",
         "app_resolve",
+        "button_style_catalog_get",
         "app_custom_button_list",
         "app_custom_button_get",
         "app_custom_button_create",

package/src/qingflow_mcp/server.py

@@ -10,6 +10,7 @@ from .tools.app_tools import AppTools
 from .tools.auth_tools import AuthTools
 from .tools.code_block_tools import CodeBlockTools
 from .tools.feedback_tools import FeedbackTools
+from .tools.export_tools import ExportTools
 from .tools.file_tools import FileTools
 from .tools.import_tools import ImportTools
 from .tools.package_tools import PackageTools
@@ -50,6 +51,7 @@ All resource tools operate with the logged-in user's Qingflow permissions.
 If `app_key` is unknown, use `app_list` or `app_search` first.
 If the app is known but the data range is not, use `app_get` first and choose from `accessible_views`.
 If an accessible view has `analysis_supported=false`, do not use it for `record_list` or `record_analyze`. `boardView` and `ganttView` are special UI views, not list/analyze targets.
+`view_get(view_id=...)` also returns `export_capability`; it only means there is a supported export route, not that export permission has been verified.
 
 ## Schema-First Rule
 
@@ -147,10 +149,33 @@ Use `record_code_block_run` when the user wants to execute a form code-block fie
 - Do not modify user-uploaded files unless the user explicitly authorizes repair.
 - If repair is authorized, keep the original file and repair a copy, then run `record_import_verify` again before `record_import_start`.
 
+## Export Path
+
+`view_get -> record_export_start -> record_export_status_get -> record_export_get`
+
+- `record_export_direct` is the one-shot export path that starts the export, waits for completion, downloads locally, and still returns remote download links.
+- Export v1 supports record views only and follows the same public `view_id` semantics as `record_list` (`system:*` and `custom:*`).
+- `record_export_start` / `record_export_direct` support frontend-like row selection:
+  - omit `record_ids` to export all rows in the selected view
+  - pass `record_ids` to export selected rows only
+- `record_export_start` / `record_export_direct` also support internal query selection:
+  - pass `where` to resolve matching `record_id` values first
+  - pass `order_by` to keep the internal query and export row order aligned with `record_list`
+  - then run native export as selected rows
+  - `where/order_by` and `record_ids` are mutually exclusive
+- `record_export_start` / `record_export_direct` also support frontend-like column selection:
+  - omit `columns` to export all current-view fields
+  - pass `columns` to export only selected fields, preserving the provided order
+- `include_workflow_log=true` maps to the native workflow-log export switch.
+
 ## Task Workflow Path
 
 `task_list -> task_get -> task_action_execute`
 
+- `task_list` returns task-card summaries keyed by `task_id`.
+- Prefer `task_get(task_id=...)` for detail reads; MCP resolves the current todo locator internally.
+- `task_action_execute(task_id=..., action=...)` is also supported; MCP resolves the current todo locator internally before calling the real action route.
+- `task_workflow_log_get(task_id=...)` and `task_associated_report_detail_get(task_id=...)` are also supported for the current todo context.
 - Use `task_associated_report_detail_get` for associated view or report details.
 - Use `task_workflow_log_get` for full workflow log history.
 - Task actions operate on `app_key + record_id + workflow_node_id`, not `task_id`.
@@ -186,6 +211,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     WorkspaceTools(sessions, backend).register(server)
     FileTools(sessions, backend).register(server)
     ImportTools(sessions, backend).register(server)
+    ExportTools(sessions, backend).register(server)
     CodeBlockTools(sessions, backend).register(server)
     TaskContextTools(sessions, backend).register(server)
     RoleTools(sessions, backend).register(server)

package/src/qingflow_mcp/server_app_builder.py

@@ -38,7 +38,7 @@ def build_builder_server() -> FastMCP:
             "If creating or updating an app package may be appropriate, use package_apply with explicit user intent; otherwise use package_get and app_resolve to locate resources, "
             "app_get/app_get_fields/app_repair_code_blocks/app_get_layout/app_get_views/app_get_flow/app_get_charts/portal_list/portal_get/view_get/chart_get for configuration reads, "
             "member_search/role_search/role_create when workflow assignees must come from the directory or role catalog, preferring roles over explicit members unless the user explicitly names members, "
-            "then app_schema_apply/app_layout_apply/app_flow_apply/app_views_apply/app_charts_apply/portal_apply to execute normalized patches; these apply tools perform planning, normalization, and dependency checks internally where applicable. Schema/layout/views noop requests skip publish, charts are immediate-live without publish and resolve targets by chart_id first then exact unique chart name, portal updates are replace-only and publish=false only guarantees draft/base-info updates, and flow should use publish=false whenever you only want draft/precheck behavior. "
+            "then app_schema_apply/app_layout_apply/app_flow_apply/app_views_apply/app_charts_apply/portal_apply to execute normalized patches; these apply tools perform planning, normalization, and dependency checks internally where applicable. Schema/layout/views noop requests skip publish, charts are immediate-live without publish and resolve targets by chart_id first then exact unique chart name, portal updates use replace semantics only when sections are supplied and edit-mode base-info-only updates may omit sections, publish=false only guarantees draft/base-info updates, and flow should use publish=false whenever you only want draft/precheck behavior. "
             "For code_block fields with output bindings, always use qf_output assignment rather than const/let qf_output, and use app_repair_code_blocks when an existing form hangs because output-bound fields stay loading. "
             "Use package_apply to manage package metadata, visibility, grouping, and ordering, and app_publish_verify for explicit final publish verification. "
             "For workflow edits, keep the public builder surface on stable linear flows only: start/approve/fill/copy/webhook/end. Branch and condition nodes are intentionally disabled because the backend workflow route is not front-end stable for those node types. Declare node assignees and editable fields explicitly. "
@@ -93,6 +93,16 @@ def build_builder_server() -> FastMCP:
             include_external=include_external,
         )
 
+    @server.tool()
+    def workspace_get(
+        profile: str = DEFAULT_PROFILE,
+        ws_id: int | None = None,
+    ) -> dict:
+        return workspace.workspace_get(
+            profile=profile,
+            ws_id=ws_id,
+        )
+
     @server.tool()
     def file_upload_local(
         profile: str = DEFAULT_PROFILE,
@@ -280,6 +290,10 @@ def build_builder_server() -> FastMCP:
             )
         return ai_builder.app_resolve(profile=profile, app_key=app_key, app_name=app_name, package_id=package_id)
 
+    @server.tool()
+    def button_style_catalog_get(profile: str = DEFAULT_PROFILE) -> dict:
+        return ai_builder.button_style_catalog_get(profile=profile)
+
     @server.tool()
     def app_custom_button_list(profile: str = DEFAULT_PROFILE, app_key: str = "") -> dict:
         return ai_builder.app_custom_button_list(profile=profile, app_key=app_key)