# Nous-approved MCP catalog entry.
# Presence in this directory = approval. Merged via PR review.
manifest_version: 1

name: comfy-cloud
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
# MCP OAuth 2.1 + Dynamic Client Registration — same shape as the linear
# entry. Hermes's MCP client + mcp_oauth_manager handle discovery, PKCE,
# token exchange, and refresh — nothing to install locally.
transport:
  type: http
  url: https://cloud.comfy.org/mcp

auth:
  type: oauth
  # No `provider:` — native MCP OAuth (case 1), not a third-party provider
  # like Google. The MCP client triggers the browser flow on the first
  # probe / first connect.

# Tool selection at install time:
# 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
  Comfy account. After auth, restart your Hermes session so the Comfy Cloud
  tools are loaded.

  Discovery tools (search_templates / search_models / search_nodes) work with
  any Comfy account. Generation tools run on Comfy Cloud and consume credits,
  so they need a subscription or credit balance — see
  https://www.comfy.org/cloud for plans.

  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