From d9101bef0aa357a7922319d0d631f85a43ccdca1 Mon Sep 17 00:00:00 2001
From: Teknium <127238744+teknium1@users.noreply.github.com>
Date: Thu, 16 Jul 2026 22:34:04 -0700
Subject: [PATCH] fix(mcp): curate comfy-cloud default tool set + drop legacy
 packaging line
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- tools.default_enabled: 20-tool curated subset (discovery, generation,
  job lifecycle, billing). The server exposes ~37 tools; all-enabled adds
  ~16-22k tokens of schema to every API call — larger than the entire
  Hermes core toolset (~12.7k). Curated default lands at ~9-12k. Batch,
  saved/shared workflow, and App Mode tools remain opt-in via
  'hermes mcp configure comfy-cloud'.
- report_session_summary excluded from defaults per telemetry policy
  (no outbound telemetry without explicit user opt-in).
- description trimmed to catalog guideline length.
- revert pyproject data-files line: the per-entry packaging enforcement
  was removed (no-pip policy); blender/unreal-engine entries have no
  data-files lines either.
---
 optional-mcps/comfy-cloud/manifest.yaml | 56 +++++++++++++++++++++----
 1 file changed, 48 insertions(+), 8 deletions(-)

diff --git a/optional-mcps/comfy-cloud/manifest.yaml b/optional-mcps/comfy-cloud/manifest.yaml
index 0ee8c613ebd..2b873e645e5 100644
--- a/optional-mcps/comfy-cloud/manifest.yaml
+++ b/optional-mcps/comfy-cloud/manifest.yaml
@@ -3,7 +3,7 @@
 manifest_version: 1
 
 name: comfy-cloud
-description: Generate images, video, audio, and 3D on Comfy Cloud — ComfyUI workflows, templates, and partner models (Flux, Kling, Veo, ...).
+description: Generate images, video, audio, and 3D on Comfy Cloud.
 source: https://docs.comfy.org/agent-tools/cloud
 
 # Comfy Cloud ships a hosted remote MCP server (Streamable HTTP) with native
@@ -21,12 +21,50 @@ auth:
   # probe / first connect.
 
 # Tool selection at install time:
-# The server exposes ~30 tools across generation (partner_generate,
-# submit_workflow, run_template), job lifecycle (get_job_status, wait_for_job,
-# get_output), asset handling (upload_file, use_previous_output), and
-# discovery (search_templates / search_models / search_nodes). We leave
-# `default_enabled` unset so the install-time checklist starts with
-# everything pre-checked — users prune what they don't want.
+# The server exposes ~37 tools (public beta — surface may grow). At Hermes's
+# measured ~600 tokens/tool schema average, all 37 would add ~16-22k tokens
+# to EVERY API call while enabled — larger than the entire Hermes core
+# toolset. The curated default below (20 tools) keeps the surface to what an
+# agent needs to discover, generate, and fetch results (~9-12k tokens).
+#
+# Deliberately excluded from the default (opt back in any time with
+# `hermes mcp configure comfy-cloud`):
+#   - cql, get_server_info            — power-user / debug probes
+#   - submit_batch, get_batch_status, get_batch_output, wait_for_batch
+#                                     — batch variants of the job lifecycle
+#   - list_saved_workflows, get_saved_workflow, save_workflow,
+#     update_workflow, run_saved_workflow, share_workflow,
+#     import_shared_workflow          — saved/shared workflow management
+#   - create_app, get_app_mode_url    — Comfy App Mode product features
+#   - submit_feedback                 — beta survey link
+#   - report_session_summary         — outbound telemetry; excluded per
+#     Hermes policy (no telemetry without explicit user opt-in)
+tools:
+  default_enabled:
+    # Discovery
+    - search_templates
+    - get_template
+    - get_template_schema
+    - search_models
+    - search_nodes
+    - get_node
+    - get_prompting_guide
+    # Generation
+    - run_template
+    - submit_workflow
+    - partner_generate
+    - upload_file
+    - apply_slots
+    # Job lifecycle
+    - get_job_status
+    - wait_for_job
+    - get_output
+    - use_previous_output
+    - cancel_job
+    - get_queue
+    # Account / handoff
+    - get_billing_status
+    - get_workflow_canvas_url
 
 post_install: |
   On first connection, Hermes will open a browser to authenticate with your
@@ -38,5 +76,7 @@ post_install: |
   so they need a subscription or credit balance — see
   https://www.comfy.org/cloud for plans.
 
-  You can re-run the tool checklist any time with:
+  A curated 20-tool subset is enabled by default (discovery, generation, job
+  lifecycle, billing). Batch jobs, saved/shared workflow management, and App
+  Mode tools are available but unchecked — enable them any time with:
     hermes mcp configure comfy-cloud