{"seq":0,"prev_entry_hash":"GENESIS","observed_at":"2026-09-02T07:54:50.320Z","server_id":"2397a197fd77d140","server_name":"comfyui-mcp","source":"npm","set_hash":"6658df1b463ba7876cf0f6476428051877c8db7fea155637ce597b23b49ca918","tools":[{"name":"apply_manifest","hash":"30883c8250aee3afde43d2c54a44332a90ffad6becf31f0e856cd9ed9418969f","canonical_json":"{\"description\":\"Apply a ComfyUI setup manifest from an inline object or .json/.yaml/.yml file. Composes custom-node installs and model downloads, installs pip packages, and reports apt entries as skipped (system packages need manual/root installation). LOCAL ComfyUI: model downloads use the connected server's live/data model roots; pip uses the serving checkout (live main.py root, then COMFYUI_CODE_PATH, then COMFYUI_PATH); filesystem custom-node fallbacks use the live data/base root (live --base-directory, then COMFYUI_PATH). REMOTE ComfyUI: custom_nodes and models are routed through the ComfyUI-Manager HTTP API (handled on the host), while pip and apt entries are reported as skipped (no remote equivalent). Each item reports applied/skipped/failed/pending independently. success is true only when nothing failed AND nothing is still pending. A PARTIAL INSTALL (custom_nodes left unsubmitted when the time budget elapsed) is named in the partial field — a drained Manager queue / panel_node_queue_status does not include those entries; re-run apply_manifest to submit them. Do not restart ComfyUI until they report applied or skipped.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"manifest\":{\"additionalProperties\":false,\"description\":\"Inline manifest object. Provide exactly one of `manifest` or `path`.\",\"properties\":{\"apt\":{\"default\":[],\"items\":{\"minLength\":1,\"type\":\"string\"},\"type\":\"array\"},\"custom_nodes\":{\"default\":[],\"items\":{\"minLength\":1,\"type\":\"string\"},\"type\":\"array\"},\"models\":{\"default\":[],\"items\":{\"additionalProperties\":false,\"properties\":{\"filename\":{\"minLength\":1,\"type\":\"string\"},\"local_path\":{\"minLength\":1,\"type\":\"string\"},\"model_type\":{\"enum\":[\"checkpoints\",\"loras\",\"vae\",\"upscale_models\",\"controlnet\",\"embeddings\",\"clip\",\"diffusers\",\"diffusion_models\",\"gligen\",\"hypernetworks\",\"photomaker\",\"style_models\",\"text_encoders\",\"unet\"],\"type\":\"string\"},\"url\":{\"format\":\"uri\",\"type\":\"string\"}},\"required\":[\"url\"],\"type\":\"object\"},\"type\":\"array\"},\"pip\":{\"default\":[],\"items\":{\"minLength\":1,\"type\":\"string\"},\"type\":\"array\"}},\"type\":\"object\"},\"pack\":{\"description\":\"A bundled installer pack by NAME, as reported by list_packs (action:\\\"list\\\"). PREFER THIS over `path` for a bundled pack: the name is resolved against the running build at apply time, while a manifest_path captured earlier points into an npx cache directory that a later respawn no longer has (#1568). Provide exactly one of `manifest`, `path`, or `pack`.\",\"type\":\"string\"},\"path\":{\"description\":\"Path to a .json, .yaml, or .yml manifest file. Provide exactly one of `manifest`, `path`, or `pack`.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"apply_manifest\"}"},{"name":"apps","hash":"aed640a51689dfa63ef11926116da4a23ce0b2995d6e5d8e3d614dbb3dbc140a","canonical_json":"{\"description\":\"Micro-apps on this ComfyUI (panel Apps feature): named workflows packaged for one-click runs. Driven by the `action` parameter:\\n- action:\\\"list\\\" — List every registered app. Each entry is the app's manifest: id, name, description, appMode {inputs, outputs}, deps, hideWorkflow, published. No other parameters. Read-only.\\n- action:\\\"get\\\" — One app's manifest + bundle facts (has_workflow/has_prompt/has_thumbnail) by `app_id`. The manifest's appMode.inputs is the app's run form: each input has nodeId, widget, label, kind (text|number|combo|toggle|image|model), optional choices and default. Read-only.\\n- action:\\\"run\\\" — Run one app: patches `values` (keys '.', e.g. {\\\"6.text\\\": \\\"a cat\\\"}) into the app's stored prompt snapshot and queues it on ComfyUI. Returns the prompt_id — poll action:\\\"run_status\\\". Only pass values for inputs listed in appMode.inputs; omitted inputs keep their conversion-time defaults.\\n- action:\\\"run_status\\\" — Check one run by `app_id` + `prompt_id`: status (pending|running|done|unknown) plus the run's outputs (image/video file refs under each output node, text outputs). Read-only.\\n- action:\\\"import\\\" — Install an app from the public registry: fetches the registry bundle (manifest + prompt snapshot [+ workflow unless hidden]) and creates it locally. The registry id becomes the local id, so re-importing reports an id conflict (already installed). Deps (models/custom nodes) are NOT installed — report the manifest's deps to the user so they can install them before running.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which apps operation to perform. \\\"list\\\" takes no other parameters; \\\"get\\\"/\\\"run\\\" require `app_id`; \\\"run_status\\\" requires `app_id` + `prompt_id`; \\\"import\\\" requires `registry_url` + `app_id`.\",\"enum\":[\"list\",\"get\",\"run\",\"run_status\",\"import\"],\"type\":\"string\"},\"app_id\":{\"description\":\"The app's uuid. REQUIRED for actions \\\"get\\\", \\\"run\\\", \\\"run_status\\\" (from action:\\\"list\\\") and \\\"import\\\" (the REGISTRY app's uuid, from the explore list).\",\"format\":\"uuid\",\"pattern\":\"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$\",\"type\":\"string\"},\"prompt_id\":{\"description\":\"action:\\\"run_status\\\" — the prompt_id returned by action:\\\"run\\\". Required for that action.\",\"pattern\":\"^[0-9a-zA-Z-]{1,64}$\",\"type\":\"string\"},\"registry_url\":{\"description\":\"action:\\\"import\\\" — registry worker base URL (required for that action). Must be the default public registry or an origin the operator allowlisted via COMFYUI_MCP_REGISTRY_URLS (the fetch is server-side — open URLs would be SSRF).\",\"format\":\"uri\",\"type\":\"string\"},\"slug\":{\"description\":\"action:\\\"import\\\" — the app's registry slug (recorded in local metadata).\",\"type\":\"string\"},\"values\":{\"additionalProperties\":{},\"description\":\"action:\\\"run\\\" — input overrides keyed '.' (e.g. {\\\"6.text\\\": \\\"a cat\\\", \\\"3.seed\\\": 42}). Unknown keys fail loudly (the manifest drifted from the snapshot).\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"version\":{\"description\":\"action:\\\"import\\\" — the registry version (recorded in local metadata).\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"apps\"}"},{"name":"batch","hash":"f6bf93ce434faf90200c8453e379f4d7ace78baf7bd31da9312fc1e2fa3f4e9c","canonical_json":"{\"description\":\"Run MANY ComfyUI workflows under one durable batch_id. Driven by the `action` parameter:\\n- action:\\\"submit\\\" — Enqueue a batch. Provide EITHER `workflows` (array of API-format workflows) OR one `workflow` plus a `sweep` (array of flat input-override sets — each set produces one job, applied to every node that already has that input, like create_workflow (action:\\\"modify\\\")). Reuses the enqueue_workflow path (seeds re-randomized unless disable_random_seed). Returns { batch_id, count, prompt_ids }; the mapping is persisted to disk and stays valid across server restarts.\\n- action:\\\"status\\\" — Per-job status for `batch_id`: each prompt_id's state (pending/running/done/error/unknown) plus rollup counts and all_terminal. Same status source as queue (action:\\\"status\\\").\\n- action:\\\"output\\\" — Collected outputs for the batch's COMPLETED jobs: for each done prompt_id, the raw ComfyUI history `outputs` (node id → images/videos/audio filenames, same data get_history reports — feed filenames to get_image action:\\\"get\\\"). Jobs still pending/running are listed with their state; errored jobs carry the error message. Safe to call before the batch finishes.\\n- action:\\\"wait\\\" — Block until every job is terminal (done or error) or `timeout_s` elapses, then return the same rollup as action:\\\"status\\\" plus timed_out/waited_s. Default timeout 300s, hard cap 600s — it can never hang; if timed_out is true, call it again or poll action:\\\"status\\\".\\nBatch ids are durable — they survive server restarts.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which batch operation to perform. \\\"submit\\\" takes workflows | workflow+sweep; \\\"status\\\"/\\\"output\\\"/\\\"wait\\\" each require `batch_id` (\\\"wait\\\" also takes `timeout_s`).\",\"enum\":[\"submit\",\"status\",\"output\",\"wait\"],\"type\":\"string\"},\"batch_id\":{\"description\":\"The batch_id returned by action:\\\"submit\\\". Required for actions \\\"status\\\", \\\"output\\\" and \\\"wait\\\".\",\"type\":\"string\"},\"disable_random_seed\":{\"description\":\"action:\\\"submit\\\" — if true, do not randomize seed values (default randomizes per job).\",\"type\":\"boolean\"},\"sweep\":{\"description\":\"action:\\\"submit\\\" — param sweep: one job per override set, e.g. [{\\\"cfg\\\":6},{\\\"cfg\\\":8,\\\"steps\\\":30}]. Each key is set on every node that already has that input.\",\"items\":{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"type\":\"array\"},\"timeout_s\":{\"description\":\"action:\\\"wait\\\" — max seconds to wait (default 300, hard cap 600).\",\"type\":\"number\"},\"workflow\":{\"additionalProperties\":{},\"description\":\"action:\\\"submit\\\" — one base workflow in API format, used with `sweep`.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"workflows\":{\"description\":\"action:\\\"submit\\\" — array of ComfyUI workflows in API format (node ID -> {class_type, inputs}). Mutually exclusive with workflow+sweep.\",\"items\":{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"type\":\"array\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"batch\"}"},{"name":"bisect","hash":"2d7588947071a98e5ae85d969e4389536d70ce08158b6c5308b7fb6d852e8265","canonical_json":"{\"description\":\"Binary-search (git-bisect style) over installed ComfyUI custom nodes to find which one causes a problem. A state machine driven by the `action` parameter:\\n- action:\\\"start\\\" — Begin a session over all currently-enabled custom nodes. Enables half and disables the rest for the first test round, then guide the search with good/bad. Prefers the ComfyUI-Manager HTTP API; falls back to toggling .disabled directory suffixes for local installs. A ComfyUI restart may be needed for changes to take effect.\\n- action:\\\"good\\\" — Mark the currently enabled set as GOOD (the problem is absent with this set). Narrows the search to the disabled candidates and enables the next subset. Resolves and reports the culprit when one node remains.\\n- action:\\\"bad\\\" — Mark the currently enabled set as BAD (the problem is present with this set). Narrows the search to the enabled subset and enables the next subset. Resolves and reports the culprit when one node remains.\\n- action:\\\"reset\\\" — Re-enable all custom nodes and clear the session. Use to abort a bisection or restore the installation after the search completes.\\n- action:\\\"status\\\" — Report the current session state: status (idle/running/resolved), the remaining candidate node set, which nodes are enabled this round, and the identified culprit if resolved.\\nAll actions are argument-free; `action` is the only parameter. `good`/`bad` require a session already started with action:\\\"start\\\".\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which bisect operation to perform. \\\"start\\\" begins a session; \\\"good\\\"/\\\"bad\\\" narrow it (require a running session); \\\"reset\\\" clears it and re-enables everything; \\\"status\\\" reports state. No other arguments are needed for any action.\",\"enum\":[\"start\",\"good\",\"bad\",\"reset\",\"status\"],\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"bisect\"}"},{"name":"calculate","hash":"adc8ae7a4867e9212b06d419abbc40c15f222065e9d37745f033e82502dbc7ca","canonical_json":"{\"description\":\"Evaluate a batch of math expressions exactly — no ComfyUI connection needed, so it works even in cloud mode or when ComfyUI is down. A safe, zero-dependency expression evaluator (no eval): numbers only, no strings/arrays/property access. Handy for the arithmetic agents get wrong token-by-token.\\n\\nEach line is one expression. `name = expr` assigns a variable that persists into later lines. Lines are separated by newlines or semicolons ONLY — commas are argument separators (e.g. min(a, b)), never expression separators.\\n\\nOperators: + - * / // (floor div) % (modulo) ** (power, right-assoc), comparisons < <= > >= == != (return 1/0), unary minus. Constants: pi, e, tau. Functions: abs round min max pow sqrt floor ceil sin cos tan asin acos atan atan2 sinh cosh tanh exp log log10 log2 hypot radians degrees sign trunc clamp(x,lo,hi), plus seeded RNG rand() random() uniform(a,b) randint(a,b) (inclusive). Pass `seed` for reproducible RNG; it is echoed back when omitted.\\n\\nExamples:\\n• SDXL-legal resolution from an aspect ratio, snapped to /64:\\n variables={ar: 1.5}; spec=\\\"w = floor(sqrt(1024*1024*ar)/64)*64\\\\nh = floor(sqrt(1024*1024/ar)/64)*64\\\"\\n• Reproducible seed batch (one 32-bit seed per line):\\n spec=\\\"randint(0, 2**32-1)\\\\nrandint(0, 2**32-1)\\\\nrandint(0, 2**32-1)\\\", seed=42\\n• CFG sweep:\\n spec=\\\"3 + 0*0.5\\\\n3 + 1*0.5\\\\n3 + 2*0.5\\\\n3 + 3*0.5\\\"\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"seed\":{\"description\":\"Seed for rand()/uniform(a,b)/randint(a,b). Same seed => identical sequence (mulberry32). Omit for a random seed (echoed in the result).\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"spec\":{\"anyOf\":[{\"type\":\"string\"},{\"items\":{\"type\":\"string\"},\"type\":\"array\"}],\"description\":\"Expressions to evaluate, separated by newlines/semicolons (string) or one per array item. `name = expr` assigns; assignments persist across subsequent lines. NOTE: comma is an argument separator (min(a,b)), NOT an expression separator.\"},\"variables\":{\"additionalProperties\":{\"type\":\"number\"},\"description\":\"Initial variable environment, e.g. {\\\"w\\\": 1024, \\\"ar\\\": 1.5}.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"spec\"],\"type\":\"object\"},\"name\":\"calculate\"}"},{"name":"call_tool","hash":"fcb8b3107bd406497f9aa80ff3c6f4a2df2a0369b8ebe606ee58960f11d30297","canonical_json":"{\"description\":\"Execute a tool from the catalog by name. Pass its parameters in `args` (object). The result is exactly what the underlying tool returns.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"args\":{\"description\":\"The tool's parameters as an object matching its describe_tool schema. A JSON-encoded string is also accepted. Omit for tools without parameters.\"},\"arguments\":{\"description\":\"Alias for args.\"},\"name\":{\"description\":\"Exact tool name from list_tools.\",\"type\":\"string\"},\"parameters\":{\"description\":\"Alias for args.\"},\"tool_name\":{\"description\":\"Alias for name.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"call_tool\"}"},{"name":"clear_vram","hash":"3a9f1731fbcfff0ddd6a2034586b52f5a3fb4140a634f9ca895e9f029028a841","canonical_json":"{\"description\":\"Free GPU VRAM by unloading cached models from ComfyUI. Use this between generation runs with different model families (e.g. switching from SDXL to Flux) or when running low on VRAM. Optionally unload only models or only memory.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"free_memory\":{\"default\":true,\"description\":\"Free cached memory/intermediates (default: true)\",\"type\":\"boolean\"},\"unload_models\":{\"default\":true,\"description\":\"Unload all cached models (default: true)\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"clear_vram\"}"},{"name":"comfy_cli","hash":"d085084b7e1d3f3faea9f4cffcab4c2cd66e231a93a7f3b7d62d3aee4ee10be2","canonical_json":"{\"description\":\"Drive the official comfy-cli (envelope/1 JSON contract) for the selected ComfyUI environment. The MCP resolves `comfy` from COMFY_CLI_PATH, PATH, or the selected workspace's .venv/venv. Driven by the `action` parameter:\\n- action:\\\"status\\\" — Inspect the comfy-cli integration and selected environment (`comfy which` / `comfy env`); `detail` selects version/which/env/discover (default env). Call this before local CLI operations when workspace or server routing is uncertain.\\n- action:\\\"server_start\\\" / \\\"server_stop\\\" / \\\"server_restart\\\" — Manage a local ComfyUI through comfy-cli background process management. Restart performs `comfy stop` followed by `comfy launch --background`; extra launch arguments go in `launchArgs`.\\n- action:\\\"jobs_list\\\" — List local or Comfy Cloud jobs (`limit` optional). Local jobs include CLI-tracked async submissions plus the ComfyUI queue/history.\\n- action:\\\"jobs_status\\\" / \\\"jobs_watch\\\" / \\\"jobs_cancel\\\" — Inspect, watch, or cancel one job; `promptId` required.\\n- action:\\\"jobs_wait\\\" — Wait for jobs: one of `promptId`, `promptIds`, or all=true is required; `timeoutSeconds` optional.\\n- action:\\\"search_nodes\\\" — Fuzzy-search actual ComfyUI node classes by name, display name, or description using `comfy nodes search`; `query` required. Complements search_custom_nodes, which searches installable node packs. Works locally, in Comfy Cloud, or offline with `objectInfoPath`. When comfy-cli is not installed/on PATH and the target is the connected (local) server, falls back to fuzzy-searching that server's live /object_info — so installed-node discovery works without the CLI.\\n- action:\\\"workflow_validate\\\" — Validate an API/UI workflow file (class types, inputs, enums, edge wiring) without submission; `workflowPath` required.\\n- action:\\\"workflow_run\\\" — Submit an API/UI workflow file (`workflowPath` required). Asynchronous by default; set wait=true to await outputs (`timeoutSeconds`).\\n- action:\\\"transfer_upload\\\" — Upload input files (`files` required) for local ComfyUI or Comfy Cloud; overwrite=false passes --no-overwrite.\\n- action:\\\"transfer_download\\\" — Download completed outputs for `promptId` (required); `outDir` and `urlOnly` optional.\\n- action:\\\"models_list_folders\\\" / \\\"models_list_folder\\\" / \\\"models_search\\\" / \\\"models_show\\\" — Discover model folders/files locally or in Comfy Cloud (`folder` required for list_folder, `name` for show). For models_show, pass `folder`/`type` or a relative `name` path (e.g. vae/foo.safetensors) when the same basename exists in more than one folder. When comfy-cli is not installed/on PATH and the target is the connected (local) server, these read-only listings fall back to that server's own local models (via /models) — so model discovery works without the CLI.\\n- action:\\\"models_download\\\" — Download a model `url` (required) into the workspace (`relativePath`, default models/checkpoints). A download can run for many minutes and is gated on an idle-liveness timeout, so a progressing download is never killed.\\n- action:\\\"models_remove\\\" — Remove workspace model files (`modelNames` required; `relativePath` optional).\\n- action:\\\"skills_list\\\" / \\\"skills_show\\\" / \\\"skills_validate\\\" / \\\"skills_install\\\" / \\\"skills_status\\\" / \\\"skills_uninstall\\\" — Manage the official comfy-cli bundled agent skills (comfy, fragments, debug, relay, director). validate requires `path`; install/uninstall default to dry-run unless apply=true; scope=\\\"project\\\" requires `projectDir`.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which comfy-cli operation to perform. Families: status; server_* (lifecycle); jobs_* (list/status/wait/watch/cancel); search_nodes; workflow_* (validate/run); transfer_* (upload/download); models_* (list_folders/list_folder/search/show/download/remove); skills_* (list/show/validate/install/status/uninstall).\",\"enum\":[\"status\",\"server_start\",\"server_stop\",\"server_restart\",\"jobs_list\",\"jobs_status\",\"jobs_wait\",\"jobs_watch\",\"jobs_cancel\",\"search_nodes\",\"workflow_validate\",\"workflow_run\",\"transfer_upload\",\"transfer_download\",\"models_list_folders\",\"models_list_folder\",\"models_search\",\"models_show\",\"models_download\",\"models_remove\",\"skills_list\",\"skills_show\",\"skills_validate\",\"skills_install\",\"skills_status\",\"skills_uninstall\"],\"type\":\"string\"},\"all\":{\"description\":\"action:\\\"jobs_wait\\\" — wait on every known job.\",\"type\":\"boolean\"},\"apply\":{\"default\":false,\"description\":\"actions \\\"skills_install\\\"/\\\"skills_uninstall\\\" — actually mutate; default false = dry-run.\",\"type\":\"boolean\"},\"detail\":{\"default\":\"env\",\"description\":\"action:\\\"status\\\" — which inspection to run.\",\"enum\":[\"version\",\"which\",\"env\",\"discover\"],\"type\":\"string\"},\"files\":{\"description\":\"action:\\\"transfer_upload\\\" — input files to upload. REQUIRED.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"folder\":{\"description\":\"action:\\\"models_list_folder\\\" — the model folder to list (REQUIRED). action:\\\"models_show\\\" — optional folder to pick among duplicate basenames.\",\"type\":\"string\"},\"launchArgs\":{\"description\":\"actions \\\"server_start\\\"/\\\"server_restart\\\" — extra ComfyUI launch arguments, e.g. ['--listen','0.0.0.0','--port','8188'].\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"limit\":{\"description\":\"Result cap for \\\"jobs_list\\\", \\\"search_nodes\\\" and the \\\"models_*\\\" listing/search actions.\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"modelNames\":{\"description\":\"action:\\\"models_remove\\\" — model filenames to remove. REQUIRED.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"name\":{\"description\":\"actions \\\"models_show\\\"/\\\"skills_show\\\" — the model or skill name. For models_show a relative path (e.g. vae/qwen_image_vae.safetensors) selects among duplicate basenames.\",\"type\":\"string\"},\"objectInfoPath\":{\"description\":\"action:\\\"search_nodes\\\" — offline object_info JSON file to search instead of a live target.\",\"type\":\"string\"},\"outDir\":{\"description\":\"action:\\\"transfer_download\\\" — output directory.\",\"type\":\"string\"},\"overwrite\":{\"description\":\"action:\\\"transfer_upload\\\" — set false to pass --no-overwrite.\",\"type\":\"boolean\"},\"path\":{\"description\":\"action:\\\"skills_validate\\\" — path to the skill to validate. REQUIRED.\",\"type\":\"string\"},\"projectDir\":{\"description\":\"Working directory for project-scoped skill operations. Required when scope='project'.\",\"type\":\"string\"},\"promptId\":{\"description\":\"Single prompt id. Required for \\\"jobs_status\\\"/\\\"jobs_watch\\\"/\\\"jobs_cancel\\\" and \\\"transfer_download\\\"; accepted for \\\"jobs_wait\\\" (normalized into a one-element promptIds list).\",\"type\":\"string\"},\"promptIds\":{\"description\":\"action:\\\"jobs_wait\\\" — prompt ids to wait on. Use this or promptId or all=true.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"query\":{\"description\":\"action:\\\"search_nodes\\\" — fuzzy search text. REQUIRED.\",\"minLength\":1,\"type\":\"string\"},\"relativePath\":{\"description\":\"actions \\\"models_download\\\"/\\\"models_remove\\\" — workspace-relative model directory (default models/checkpoints).\",\"type\":\"string\"},\"scope\":{\"description\":\"actions \\\"skills_install\\\"/\\\"skills_uninstall\\\"/\\\"skills_status\\\" — install scope.\",\"enum\":[\"user\",\"project\"],\"type\":\"string\"},\"skills\":{\"description\":\"actions \\\"skills_install\\\"/\\\"skills_uninstall\\\" — skill names.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"targets\":{\"description\":\"actions \\\"skills_install\\\"/\\\"skills_uninstall\\\" — agent targets.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"text\":{\"description\":\"action:\\\"models_search\\\" — search text.\",\"type\":\"string\"},\"timeoutSeconds\":{\"description\":\"actions \\\"jobs_wait\\\"/\\\"jobs_watch\\\"/\\\"workflow_run\\\" — max seconds to wait.\",\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"type\":{\"description\":\"action:\\\"models_search\\\" — model type filter (checkpoint, lora, vae, …). action:\\\"models_show\\\" — same filter, to pick among duplicate basenames.\",\"type\":\"string\"},\"url\":{\"description\":\"action:\\\"models_download\\\" — model URL to download. REQUIRED.\",\"format\":\"uri\",\"type\":\"string\"},\"urlOnly\":{\"description\":\"action:\\\"transfer_download\\\" — print URLs instead of downloading files.\",\"type\":\"boolean\"},\"wait\":{\"description\":\"action:\\\"workflow_run\\\" — await outputs instead of returning after submission.\",\"type\":\"boolean\"},\"where\":{\"description\":\"Target for the jobs/search_nodes/workflow/transfer/models actions: \\\"local\\\" (default) or \\\"cloud\\\" (Comfy Cloud).\",\"enum\":[\"local\",\"cloud\"],\"type\":\"string\"},\"workflowPath\":{\"description\":\"actions \\\"workflow_validate\\\"/\\\"workflow_run\\\" — path to an API/UI workflow JSON file. REQUIRED.\",\"minLength\":1,\"type\":\"string\"},\"workspace\":{\"description\":\"Optional ComfyUI workspace override (the data/base root comfy-cli uses for custom_nodes/models). Otherwise the live --base-directory / COMFYUI_PATH is used; the CLI executable may still come from the COMFYUI_CODE_PATH checkout's .venv.\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"comfy_cli\"}"},{"name":"create_workflow","hash":"4b5ba602d738f1efd5acc0fbc3fe84583661bf84079f5cc1f44ac45d2337234d","canonical_json":"{\"description\":\"Author and check ComfyUI workflow JSON. Driven by the `action` parameter:\\n- action:\\\"create\\\" — Create a ready-to-run API-format workflow from a built-in template (txt2img, img2img, upscale, inpaint, controlnet, ip_adapter, ace_step_15, stable_audio_3, remove_background, ltx_video). Pure local generation — does not contact ComfyUI and has no side effects. Returns the complete workflow JSON; pass it to action:\\\"validate\\\" or enqueue_workflow. Unsupplied `params` fall back to template defaults, so the result may reference checkpoints/models that must exist on your ComfyUI server before it will execute.\\n- action:\\\"modify\\\" — Apply modification `operations` to an existing workflow. Supports: set_input, add_node, remove_node, connect, insert_between. Returns the modified workflow JSON and IDs of any newly added nodes.\\n- action:\\\"validate\\\" — Validate a workflow WITHOUT executing it. Checks for missing node types, broken connections, invalid output indices, missing models, and other issues. Returns a list of errors and warnings.\\n- action:\\\"node_info\\\" — Query a running ComfyUI server's /object_info endpoint for installed node type definitions. Requires a reachable ComfyUI instance; results reflect that server's installed custom nodes. Use the `node_type` filter to inspect a specific node before composing or modifying a workflow. Default response is a STRUCTURAL summary: input/output names and type tags, with enum (dropdown) inputs collapsed to a value count — safe for context even on Loader nodes whose model dropdowns embed the entire local model list (hundreds of KB raw). Pass verbose=true (20 or fewer matches) for the complete raw definitions including every dropdown value. When more than 20 node types match, returns only a name/category list and asks you to narrow the filter.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which authoring operation to perform. \\\"create\\\" requires `template` (optional `params`); \\\"modify\\\" requires `workflow` + `operations`; \\\"validate\\\" requires `workflow` (optional `health`); \\\"node_info\\\" takes no required parameters (optional `node_type`, `verbose`, `refresh`).\",\"enum\":[\"create\",\"modify\",\"validate\",\"node_info\"],\"type\":\"string\"},\"health\":{\"default\":true,\"description\":\"action:\\\"validate\\\" — Include graph-health heuristics (disconnected nodes, duplicate model loads, orphaned branches, muted/bypassed nodes, a sampler running denoise below 1.0 on an empty latent, an image-edit graph whose sampled canvas is not derived from the reference) as info/warning issues plus a structured health section. Never affects `valid`.\",\"type\":\"boolean\"},\"node_type\":{\"description\":\"action:\\\"node_info\\\" — Filter by node class_type name (case-insensitive substring match). Omit to list all available nodes.\",\"type\":\"string\"},\"operations\":{\"description\":\"action:\\\"modify\\\" (REQUIRED) — Array of operations to apply in order. Each has an 'op' field: set_input, add_node, remove_node, connect, or insert_between\",\"items\":{\"oneOf\":[{\"properties\":{\"input_name\":{\"type\":\"string\"},\"node_id\":{\"type\":\"string\"},\"op\":{\"const\":\"set_input\",\"type\":\"string\"},\"value\":{}},\"required\":[\"op\",\"node_id\",\"input_name\",\"value\"],\"type\":\"object\"},{\"properties\":{\"class_type\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"},\"inputs\":{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"op\":{\"const\":\"add_node\",\"type\":\"string\"}},\"required\":[\"op\",\"class_type\"],\"type\":\"object\"},{\"properties\":{\"node_id\":{\"type\":\"string\"},\"op\":{\"const\":\"remove_node\",\"type\":\"string\"}},\"required\":[\"op\",\"node_id\"],\"type\":\"object\"},{\"properties\":{\"input_name\":{\"type\":\"string\"},\"op\":{\"const\":\"connect\",\"type\":\"string\"},\"output_index\":{\"type\":\"number\"},\"source_id\":{\"type\":\"string\"},\"target_id\":{\"type\":\"string\"}},\"required\":[\"op\",\"source_id\",\"output_index\",\"target_id\",\"input_name\"],\"type\":\"object\"},{\"properties\":{\"input_name\":{\"type\":\"string\"},\"new_class_type\":{\"type\":\"string\"},\"new_inputs\":{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"op\":{\"const\":\"insert_between\",\"type\":\"string\"},\"output_index\":{\"type\":\"number\"},\"source_id\":{\"type\":\"string\"},\"target_id\":{\"type\":\"string\"}},\"required\":[\"op\",\"source_id\",\"output_index\",\"target_id\",\"input_name\",\"new_class_type\"],\"type\":\"object\"}]},\"type\":\"array\"},\"params\":{\"additionalProperties\":{},\"default\":{},\"description\":\"action:\\\"create\\\" — Template parameters; recognized keys depend on the template. txt2img: checkpoint, positive_prompt, negative_prompt, width, height, steps, cfg, seed, sampler_name, scheduler. img2img/inpaint add image_path (and mask_path for inpaint) and denoise. upscale adds upscale_model. Unknown keys are ignored; omitted keys use template defaults.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"refresh\":{\"default\":false,\"description\":\"action:\\\"node_info\\\" — If true, discard the memoized /object_info snapshot and refetch live from the connected server before answering. Use after the ComfyUI server was restarted EXTERNALLY (systemd/service manager) or new model files were added out-of-band — the cache is otherwise only invalidated by MCP-managed restarts, so loader dropdowns (model lists) would remain stale for the rest of the session (#499).\",\"type\":\"boolean\"},\"template\":{\"description\":\"action:\\\"create\\\" (REQUIRED) — Template name, one of: txt2img, img2img, upscale, inpaint, controlnet, ip_adapter, ace_step_15, stable_audio_3, remove_background, ltx_video\",\"enum\":[\"txt2img\",\"img2img\",\"upscale\",\"inpaint\",\"controlnet\",\"ip_adapter\",\"ace_step_15\",\"stable_audio_3\",\"remove_background\",\"ltx_video\"],\"type\":\"string\"},\"verbose\":{\"default\":false,\"description\":\"action:\\\"node_info\\\" — If true, return the full raw /object_info definitions including enum dropdown values (model lists etc.) — can be hundreds of KB per Loader node, so only use it when you need the actual enum values (e.g. exact model filenames) and the filter matches few nodes. Default false: structural summary with enum value counts.\",\"type\":\"boolean\"},\"workflow\":{\"anyOf\":[{\"type\":\"string\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}],\"description\":\"ComfyUI workflow JSON (as a JSON string or object). REQUIRED for action:\\\"modify\\\" and action:\\\"validate\\\". action:\\\"validate\\\" accepts API format or a saved UI export (nodes[]/links[]).\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"create_workflow\"}"},{"name":"describe_tool","hash":"dc92d894996b5b91d32c6b85426b601056702159593cd8204023380a509d312e","canonical_json":"{\"description\":\"Get the full description and JSON Schema of one tool from the catalog. Always call this before the first call_tool of a tool you haven't used in this session.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"name\":{\"description\":\"Exact tool name from list_tools.\",\"type\":\"string\"},\"tool_name\":{\"description\":\"Alias for name.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"describe_tool\"}"},{"name":"download_model","hash":"aeff22079210b20a98db3ddcc0253e861e8b7768e5179144e2cbc3e11226de2b","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"idempotentHint\":false,\"openWorldHint\":true},\"description\":\"Find model weights and get them onto the connected ComfyUI, and track the transfers. Driven by the `action` parameter:\\n- action:\\\"download\\\" — Download a model file to the connected ComfyUI's models directory from a URL (HuggingFace, direct HTTP(S), s3://, or Azure Blob). Requires `url` + `target_subfolder`. PREFER this over a raw shell download (curl/wget) for model weights: it lands the file in the right models/ subfolder. LOCAL ComfyUI: streams to disk and surfaces live progress in the panel download tray. REMOTE ComfyUI: dispatches the fetch to the ComfyUI host via the ComfyUI-Manager install-model HTTP API (downloaded server-side; a per-request `auth` header can't be forwarded). This requires the host's Manager to run with network_mode=personal_cloud (or loopback) and a permissive security level — a stricter gate silently rejects the download, and Manager reports the queue task 'done' even on failure, so a remote dispatch does not guarantee the file landed. target_subfolder accepts any relative subfolder (incl. nested, e.g. 'loras/'). Optional `model_root` is an absolute directory already listed by list_local_models action:\\\"list_paths\\\" (or the resolver's known extra/primary roots) — use it when the live server is unreachable so the file lands in a configured extra-model root instead of /models; invented paths are refused.\\n- action:\\\"status\\\" — Check downloads started by action:\\\"download\\\" / action:\\\"download_civitai\\\". Reports each state, destination, and byte progress when available. Use this after a download reports it is still running — that means the transfer is in flight, NOT that it failed. Across an AGENT/sidebar reconnect, a local stream normally remains resolvable by `id` or `url`; an ORCHESTRATOR RESTART instead reports only that this MCP STOPPED WATCHING, not that the bytes stopped. READ THE ROUTE-AWARE NOTE ON THAT RECORD before acting: a local re-issue is authorized only when the writer persisted the exact staged partial path and matching identity proof, the observed partial state permits it, and any required credential is available. ComfyUI-Manager/host dispatches run on the ComfyUI host and have no local partial; re-issuing one can duplicate the server-side write and CORRUPT the destination. Manager, unknown/legacy, missing-proof, mismatched-proof, and unreadable/absent partial records are not resume authorization. NOT FOUND NEVER MEANS STOPPED: records and carry-over are best-effort. Omit `id` and `url` to list every tracked download. A stale-heartbeat NOTE explains how to cancel after the writer is proven gone; cancellation alone never proves resumability. Read-only.\\n- action:\\\"cancel\\\" — Cancel ONE in-flight download by its `id` (from action:\\\"status\\\" or from the download that started it) — REQUIRED, and it must be the id of the download you mean, since a wrong id stops someone else's transfer. Aborts only that download's transfer; other downloads keep running. An id that names no tracked download is reported as such, not silently treated as success. Cancellation reports the exact route, persisted writer identity, and observed partial state when those facts are available; it never infers that bytes are resumable from `status === \\\"cancelled\\\"` alone. Idempotent: cancelling an already-finished, failed, or already-cancelled download just reports its current state. A download whose AbortController lives in ANOTHER live session cannot be aborted from here (stop it from the panel download tray) — but a download left 'downloading' by a session that is PROVEN gone (heartbeat stale AND its process no longer exists) CAN be closed as cancelled from here. Read the route-aware recovery note before any re-issue: Manager/unknown routes and missing or mismatched identity proof are not resume authorization, and a Manager host may still be fetching with no recall API. While the writer cannot be proven gone, the cancel refuses rather than risk two writers on one file.\\n- action:\\\"search\\\" — Search HuggingFace Hub for models usable in ComfyUI (checkpoints, LoRAs, VAEs, ControlNets, etc.); `query` is required. Read-only and network-only: queries HuggingFace over HTTP, does NOT require a running ComfyUI or COMFYUI_PATH and does not download anything. Returns a ranked list with modelId, author, downloads, likes, and tags. Pick a result's download URL and pass it to action:\\\"download\\\". For CIVITAI searches ('find a Flux LoRA on Civitai') use action:\\\"search_civitai\\\" instead — it filters by type + base model and returns ids for action:\\\"download_civitai\\\". For packs of custom nodes (not models) use search_custom_nodes.\\n- action:\\\"search_civitai\\\" — Search CivitAI by keyword for checkpoints, LoRAs, embeddings, VAEs, and ControlNets — THE action for 'find me a LoRA on Civitai'. Read-only and network-only (public CivitAI REST API; no token or running ComfyUI required; CIVITAI_API_TOKEN unlocks gated results). Filter by `types` (LORA, Checkpoint, TextualInversion, VAE, Controlnet, …) and `base_models` (CivitAI labels: 'Flux.1 D', 'SDXL 1.0', 'SD 1.5', 'Pony', 'Illustrious', 'Wan Video') — ALWAYS pass base_models when the user's checkpoint family is known, so results actually fit their setup. Each hit returns the model_id and version_id that action:\\\"download_civitai\\\" takes directly, plus trigger words to use in the prompt after installing. Flow: action:\\\"search_civitai\\\" → pick a hit → action:\\\"download_civitai\\\" {model_version_id, target_subfolder} → wire/prompt with the trained words. Pass `creator` (exact username, e.g. from action:\\\"search_creators\\\") to list ONE creator's models — with or without a `query`; at least one of the two is required. SFW-only by default. For HuggingFace search use action:\\\"search\\\".\\n- action:\\\"search_creators\\\" — Find CivitAI CREATORS — THE action for 'who are the top creators on Civitai' and 'find creator '. Read-only and network-only (no token or running ComfyUI required). Two modes: with NO `query` it returns the site's creator LEADERBOARD (civitai.com/leaderboard — rank, score, downloads, likes; pick a `board`: 'overall' [default], 'overall_90' [last 90 days], 'overall_nsfw' [mature], 'new_creators' [first model <30 days ago]); with a `query` it searches usernames (public /api/v1/creators; partial match, returns model counts, NOT ranked). Each hit's username feeds action:\\\"search_civitai\\\" {creator: } directly. SCOPE CAVEAT: the /api/v1/creators index only lists creators who have published MODELS. A creator who posts only images/videos (no models) legitimately returns 0 hits here — that is a gap in this endpoint, NOT proof the creator doesn't exist. For a media-only creator, browse their images via the panel CivitAI browser (panel_open_civitai {creator}) or the logged-in browser session instead.\\n- action:\\\"download_civitai\\\" — Download a model from CivitAI into the connected ComfyUI's models/ directory. Requires `target_subfolder` plus at least one of `model_id` / `model_version_id`. Resolves a CivitAI model id (latest version) or a model-version id to a download URL via the CivitAI REST API. LOCAL ComfyUI (COMFYUI_PATH set): streams the file to disk under /models// (or under optional `model_root` when that absolute directory is already listed by list_local_models action:\\\"list_paths\\\") and returns the saved absolute path. REMOTE ComfyUI: dispatches the download to the ComfyUI host via the ComfyUI-Manager install-model HTTP API (fetched server-side). Gated/early-access models require CIVITAI_API_TOKEN locally (sent as a bearer header, never in the URL) — or pass a per-request `auth`, which overrides the configured token for that download; remote Manager-side fetches rely on tokens configured on the ComfyUI host. NOTE (remote): the server-side install requires the host's ComfyUI-Manager to run with network_mode=personal_cloud (or loopback) and a permissive security level; a stricter gate silently rejects the download, and Manager reports the queue task 'done' even on failure — so a remote dispatch does not guarantee the file landed.\\n- action:\\\"resolve_missing\\\" — Find the model files a `workflow` needs but this ComfyUI does NOT have, and search CivitAI + HuggingFace for installable candidates. THE action for 'this Template says a model is missing — go get it'. Detects by comparing each model widget against the option list the server actually publishes, so it covers checkpoints, LoRAs, VAEs, ControlNets, UNets, CLIP and custom-pack model types without any per-node mapping. Each candidate reports size, source, precision/quantisation (fp16 / fp8 / GGUF Q4_K_M …) and whether it FITS this GPU's VRAM — so when the exact file is too big you can see the quantised variant that isn't. Read-only: it downloads nothing. Pass a chosen candidate to action:\\\"download\\\" (url) or action:\\\"download_civitai\\\" (id), using the reported directory as target_subfolder. For missing custom NODE PACKS (not models) use list_packs (action:\\\"install_deps\\\") instead.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which model operation to perform. \\\"download\\\" requires `url` + `target_subfolder`; \\\"status\\\" takes an optional `id`/`tray_id`/`url` (omit all three to list everything); \\\"cancel\\\" requires `id` (optional `tray_id`); \\\"search\\\" requires `query`; \\\"search_civitai\\\" requires `query` and/or `creator`; \\\"search_creators\\\" takes an optional `query` (omit for the leaderboard `board`); \\\"download_civitai\\\" requires `target_subfolder` plus `model_id` and/or `model_version_id`; \\\"resolve_missing\\\" requires `workflow`.\",\"enum\":[\"download\",\"status\",\"cancel\",\"search\",\"search_civitai\",\"search_creators\",\"download_civitai\",\"resolve_missing\"],\"type\":\"string\"},\"auth\":{\"description\":\"action:\\\"download\\\" / action:\\\"download_civitai\\\" — optional per-request authentication for private/gated model URLs. When provided it overrides built-in HuggingFace/CivitAI token handling.\",\"oneOf\":[{\"properties\":{\"token\":{\"description\":\"Bearer token value\",\"minLength\":1,\"type\":\"string\"},\"type\":{\"const\":\"bearer\",\"type\":\"string\"}},\"required\":[\"type\",\"token\"],\"type\":\"object\"},{\"properties\":{\"password\":{\"description\":\"Basic auth password\",\"type\":\"string\"},\"type\":{\"const\":\"basic\",\"type\":\"string\"},\"username\":{\"description\":\"Basic auth username\",\"type\":\"string\"}},\"required\":[\"type\",\"username\",\"password\"],\"type\":\"object\"},{\"properties\":{\"header_name\":{\"description\":\"HTTP header name\",\"minLength\":1,\"type\":\"string\"},\"header_value\":{\"description\":\"HTTP header value\",\"type\":\"string\"},\"type\":{\"const\":\"header\",\"type\":\"string\"}},\"required\":[\"type\",\"header_name\",\"header_value\"],\"type\":\"object\"},{\"properties\":{\"query_param\":{\"description\":\"Query parameter name\",\"minLength\":1,\"type\":\"string\"},\"query_value\":{\"description\":\"Query parameter value\",\"type\":\"string\"},\"type\":{\"const\":\"query\",\"type\":\"string\"}},\"required\":[\"type\",\"query_param\",\"query_value\"],\"type\":\"object\"},{\"properties\":{\"access_key_id\":{\"description\":\"AWS/S3-compatible access key id\",\"minLength\":1,\"type\":\"string\"},\"endpoint\":{\"description\":\"Optional S3-compatible endpoint for R2-style storage\",\"format\":\"uri\",\"type\":\"string\"},\"region\":{\"description\":\"Optional AWS region override\",\"type\":\"string\"},\"secret_access_key\":{\"description\":\"AWS/S3-compatible secret access key\",\"minLength\":1,\"type\":\"string\"},\"session_token\":{\"description\":\"Optional temporary session token\",\"type\":\"string\"},\"type\":{\"const\":\"s3\",\"type\":\"string\"}},\"required\":[\"type\",\"access_key_id\",\"secret_access_key\"],\"type\":\"object\"}]},\"base_models\":{\"description\":\"action:\\\"search_civitai\\\" — only these base-model families, CivitAI labels: 'Flux.1 D', 'SDXL 1.0', 'SD 1.5', 'Pony', 'Illustrious', 'Wan Video', …\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"board\":{\"description\":\"action:\\\"search_creators\\\" — leaderboard to rank by when no query is given (default 'overall'). Ignored with a query.\",\"enum\":[\"overall\",\"overall_90\",\"overall_nsfw\",\"new_creators\"],\"type\":\"string\"},\"creator\":{\"description\":\"action:\\\"search_civitai\\\" — only models by this CivitAI creator (EXACT username — find it with action:\\\"search_creators\\\"). At least one of query/creator is required.\",\"minLength\":1,\"type\":\"string\"},\"filename\":{\"description\":\"action:\\\"download\\\" — override filename (auto-detected from the URL if omitted). action:\\\"download_civitai\\\" — override the saved filename (defaults to the CivitAI file name, or the URL basename).\",\"type\":\"string\"},\"filter\":{\"description\":\"action:\\\"search\\\" — optional HuggingFace pipeline/library tag to narrow results, e.g. 'diffusers' or 'text-to-image'.\",\"type\":\"string\"},\"id\":{\"description\":\"The download id. REQUIRED for action:\\\"cancel\\\" — this is the handle that says WHICH transfer to stop, so take it from action:\\\"status\\\" (or from the reply that started the download) rather than guessing; an id that matches nothing is reported as not found. OPTIONAL for action:\\\"status\\\" — omit to list every tracked download (incl. in-flight ones from before a reconnect).\",\"type\":\"string\"},\"limit\":{\"description\":\"Max results (default 10, or 8 candidates per missing model for action:\\\"resolve_missing\\\"). Per-action ceilings, unchanged from the tools this folds in: \\\"search\\\" 50, \\\"search_civitai\\\" 25, \\\"search_creators\\\" 50, \\\"resolve_missing\\\" 20.\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"model_id\":{\"description\":\"action:\\\"download_civitai\\\" — CivitAI model id. The latest version is used unless model_version_id is also provided.\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"model_root\":{\"description\":\"action:\\\"download\\\" / action:\\\"download_civitai\\\" — optional absolute model-root directory already listed by list_local_models action:\\\"list_paths\\\" (or the resolver's known extra/primary roots). Use this when the live ComfyUI is unreachable so the file lands in a configured extra-model root instead of /models. Invented paths are refused.\",\"minLength\":1,\"type\":\"string\"},\"model_version_id\":{\"description\":\"action:\\\"download_civitai\\\" — CivitAI model-version id (from the URL ?modelVersionId=...). If both model_id and model_version_id are given, this selects the specific version of that model.\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"nsfw\":{\"description\":\"action:\\\"search_civitai\\\" — include NSFW results (default false).\",\"type\":\"boolean\"},\"query\":{\"description\":\"REQUIRED for action:\\\"search\\\" — the HuggingFace search query (e.g. 'SDXL', 'flux', 'controlnet'). action:\\\"search_civitai\\\" — keyword search (e.g. 'detail enhancer', a character name); optional when `creator` is given (then it narrows that creator's models). action:\\\"search_creators\\\" — username search (partial match, e.g. 'alcait'); omit to get the top-creators leaderboard instead.\",\"type\":\"string\"},\"sort\":{\"description\":\"action:\\\"search_civitai\\\" — ranking (default 'Highest Rated').\",\"enum\":[\"Highest Rated\",\"Most Downloaded\",\"Newest\"],\"type\":\"string\"},\"target_subfolder\":{\"description\":\"REQUIRED for action:\\\"download\\\" and action:\\\"download_civitai\\\". Target subfolder under ComfyUI models/. Standard names: checkpoints, loras, vae, upscale_models, controlnet, embeddings, clip, diffusers, diffusion_models, gligen, hypernetworks, photomaker, style_models, text_encoders, unet. Any other relative subfolder (incl. nested like 'loras/') is allowed; absolute paths and '..' escapes are rejected.\",\"minLength\":1,\"type\":\"string\"},\"tray_id\":{\"description\":\"action:\\\"status\\\" / action:\\\"cancel\\\" — use this when two rows come back with the SAME `id`, so the id alone cannot say which one you mean. That happens when two different source URLs are downloading to the same destination file. Every row prints its own tray id as `(tray )` — pass that here, together with `id`, to report on (or stop) exactly one of them.\",\"type\":\"string\"},\"types\":{\"description\":\"action:\\\"search_civitai\\\" — only these model types (e.g. ['LORA']).\",\"items\":{\"enum\":[\"Checkpoint\",\"LORA\",\"LoCon\",\"DoRA\",\"TextualInversion\",\"VAE\",\"Controlnet\",\"Upscaler\",\"MotionModule\",\"Workflows\"],\"type\":\"string\"},\"type\":\"array\"},\"url\":{\"description\":\"REQUIRED for action:\\\"download\\\" — the direct download URL for the model file. OPTIONAL for action:\\\"status\\\" — adopt an in-flight download by its source URL when you don't have the id (e.g. after a reconnect); reports the matching job without starting a duplicate.\",\"format\":\"uri\",\"type\":\"string\"},\"workflow\":{\"anyOf\":[{\"type\":\"string\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}],\"description\":\"REQUIRED for action:\\\"resolve_missing\\\" — the ComfyUI workflow in API format (JSON string or object).\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"download_model\"}"},{"name":"enqueue_workflow","hash":"024ca07aa808ad0f642455f4c24ed91c0407e1d5a36284c9903fa632fcd6541c","canonical_json":"{\"description\":\"Submit work to the ComfyUI execution queue — the primary way an agent starts a render. Driven by the `action` parameter:\\n- action:\\\"enqueue\\\" — Submit an API-format workflow you are already holding (one you built with create_workflow, loaded with get_workflow, or edited with create_workflow action:\\\"modify\\\"). Returns immediately with the prompt_id and queue position; does NOT wait for completion. Seed values in the workflow are used EXACTLY as supplied — they are NOT re-randomized, so a run is reproducible by resubmitting the same workflow (for a fresh-seed re-run of a past job, use action:\\\"rerun\\\"). `workflow` is required. Use queue (action:\\\"status\\\") to check progress later, or get_history (action:\\\"list\\\") to retrieve results and images after completion.\\n- action:\\\"rerun\\\" — Re-run the workflow behind a PREVIOUS generation. Retrieves the prompt graph from execution history (by `prompt_id`, or the most recent run when omitted — chosen by ComfyUI's queue number, same logic as get_history) and re-enqueues it, optionally applying `inputs` overrides. Seeds are re-randomized (within each node's declared range) unless disable_random_seed is set or the seed is pinned via `inputs`. Returns the new prompt_id and the source prompt_id it came from. Clear error if no matching history exists. To re-run from a registered ASSET instead of history, use generate_image (action:\\\"regenerate\\\").\\n- action:\\\"run_url\\\" — Read (and optionally execute) a SHARED workflow from a URL. Fetches the workflow JSON, accepts API-format prompt graphs or UI-format exports (UI is auto-converted via the same converter as get_workflow), validates it, and summarizes it. Supports raw .json links and GitHub blob/raw URLs (blob is normalized to raw); other share hosts that need a site API return a clear 'paste the raw JSON URL' error. The fetch is bounded (http/https only, timeout + size cap, loopback/private/metadata IPs rejected to prevent SSRF). READ-ONLY unless run=true; when run=true it enqueues the workflow (applying optional `inputs` overrides) and returns the prompt_id. `url` is required.\\n- action:\\\"template_schema\\\" — Get a template's OVERRIDABLE run-time parameters (its 'slots') BEFORE running it. Pass a bundled pack name (from list_packs action:\\\"list\\\") or a custom-node-contributed workflow template name (from list_packs action:\\\"list_templates\\\") as `template`. Returns `slots` — the meaningful knobs: positive/negative prompt, seed, steps, cfg, sampler/scheduler, width/height, checkpoint/LoRA/model files, denoise, batch_size, input image — plus `other_slots` (every remaining overridable widget), each with a stable key \\\".\\\", semantic role, type, current value, and min/max/options where the node schema is known. Read-only. Feed the keys DIRECTLY into action:\\\"run_template\\\"'s `overrides` (same convention) for a schema→run round-trip.\\n- action:\\\"run_template\\\" — ONE-SHOT: run a named workflow template (a bundled pack from list_packs) with optional `overrides`. Resolves the template's expert graph, applies overrides, and enqueues it — replacing the manual list_packs (action:\\\"read_workflow\\\") → create_workflow (action:\\\"modify\\\") → action:\\\"enqueue\\\" chain. Override keys are '.' (e.g. {'6.text': 'a cat', '3.seed': 42}) — the SAME keys action:\\\"template_schema\\\" reports (when available), so schema→run round-trips; only widget values can be overridden, never graph connections. By default returns {prompt_id} immediately; pass wait:true to block until the job completes and return its outputs (images etc.). Unresolvable template names return a clear error with near-matches. `template` is required.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which enqueue entry point to use. action:\\\"enqueue\\\" requires `workflow`; action:\\\"rerun\\\" takes an optional `prompt_id` (+ `inputs`); action:\\\"run_url\\\" requires `url` (+ `run`/`inputs`); action:\\\"template_schema\\\" and action:\\\"run_template\\\" require `template`; with action:\\\"run_template\\\" you may also pass `overrides`/`wait`/`timeout_s`.\",\"enum\":[\"enqueue\",\"rerun\",\"run_url\",\"template_schema\",\"run_template\"],\"type\":\"string\"},\"disable_random_seed\":{\"description\":\"If true, do not randomize seed values — applies to action:\\\"rerun\\\" and action:\\\"run_template\\\" (for action:\\\"rerun\\\", combine with inputs.seed to reproduce exactly). It is a NO-OP for action:\\\"enqueue\\\", whose seeds are always used exactly as supplied (issue #865).\",\"type\":\"boolean\"},\"inputs\":{\"additionalProperties\":{},\"description\":\"Overrides applied to every node with a matching input name (e.g. cfg, steps, sampler_name, seed, text). Used by action:\\\"rerun\\\", and by action:\\\"run_url\\\" only when run=true.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"overrides\":{\"additionalProperties\":{},\"description\":\"action:\\\"run_template\\\" — widget overrides keyed '.' (action:\\\"template_schema\\\"'s keys), e.g. {'6.text': 'a red fox', '3.steps': 20}.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"prompt_id\":{\"description\":\"action:\\\"rerun\\\" — prompt ID of the generation to re-run. If omitted, uses the most recent execution.\",\"type\":\"string\"},\"run\":{\"default\":false,\"description\":\"action:\\\"run_url\\\" — if true, enqueue the fetched workflow for execution and return the prompt_id. Default false: only fetch, validate, and summarize (read-only).\",\"type\":\"boolean\"},\"template\":{\"description\":\"Template name/id: a bundled pack directory name (list_packs action:\\\"list\\\") or a custom-node-contributed workflow template name (list_packs action:\\\"list_templates\\\"). REQUIRED for action:\\\"template_schema\\\" and action:\\\"run_template\\\".\",\"minLength\":1,\"type\":\"string\"},\"timeout_s\":{\"description\":\"action:\\\"run_template\\\" — max seconds to wait when wait:true (default 300). On timeout the job keeps running; poll queue (action:\\\"status\\\").\",\"exclusiveMinimum\":0,\"type\":\"number\"},\"url\":{\"description\":\"action:\\\"run_url\\\" — URL of the workflow JSON. Raw .json links and GitHub blob/raw URLs work directly. REQUIRED for that action.\",\"type\":\"string\"},\"wait\":{\"description\":\"action:\\\"run_template\\\" — block until the job completes and return its outputs. Default false: return {prompt_id} immediately.\",\"type\":\"boolean\"},\"workflow\":{\"additionalProperties\":{},\"description\":\"action:\\\"enqueue\\\" — ComfyUI workflow in API format (node ID -> {class_type, inputs}). REQUIRED for that action.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"enqueue_workflow\"}"},{"name":"generate_image","hash":"7bc99a6505e0bab26a8eaf4e92f7477d1cc2e5ea5482010a4c6771659df4dcc2","canonical_json":"{\"description\":\"Generate media from a prompt or an existing image — the high-level entry points that build the graph for you. Every action enqueues on the connected ComfyUI and returns the prompt_id immediately; the resulting asset_id arrives in the completion notification. Driven by the `action` parameter:\\n- action:\\\"image\\\" — Text-to-image. Builds a txt2img workflow, filling any unspecified parameter from your configured defaults (get_defaults (action:\\\"set\\\") / COMFYUI_DEFAULT_* / config file), auto-selecting a local checkpoint when none is given — checkpoints known to lack a text encoder (e.g. video models) are skipped. `prompt` is required. For full control over the node graph, use create_workflow + enqueue_workflow instead.\\n- action:\\\"audio\\\" — Text-to-audio, supporting the ACE Step 1.5 and Stable Audio 3 model families. Builds the appropriate workflow graph, filling unspecified parameters from your defaults and auto-selecting local models. `model_family`, `prompt` and `duration` are required. Requires a running ComfyUI with the corresponding model files installed.\\n- action:\\\"video\\\" — Text-to-video, or image-to-video when `image` is given (animate a start frame). Composes an LTX-2.3 distilled workflow on your LOCAL GPU using the render-verified Comfy-Org node stack (gemma text encoder + abliterated/distilled LoRAs). Needs the LTX-2.3 models (~24-46GB): install with apply_manifest --path packs/ltx-2.3-txt2vid/manifest.yaml (or ltx-2.3-img2vid for i2v); returns an actionable error if the checkpoint is missing. `seconds` is converted to an 8n+1 frame count. For i2v, higher `strength` means MORE adherence to the start frame but LESS motion (1.0 can freeze the clip) — keep ~0.6. This minimal path omits the synchronized audio + stage-2 spatial upscale that the full ltx-2.3 packs ship. `prompt` is required. The video is written under output/video/ — find it with get_image (action:\\\"list_outputs\\\") (VHS/SaveVideo outputs may not appear in /history).\\n- action:\\\"3d\\\" — Generate a 3D model (glb/obj/fbx) from a text prompt or an input image, using the connected ComfyUI's hosted partner 3D nodes (Tripo, Meshy, Rodin, Hunyuan3D — auto-detected from the server; these are paid API nodes needing a comfy.org API key/login on the server or COMFY_API_KEY here). `mode` is required (\\\"text\\\" needs `prompt`, \\\"image\\\" needs `image`). Poll queue (action:\\\"status\\\") / get_history (action:\\\"list\\\") for the resulting model file (saved to ComfyUI's output directory). If the server has no 3D-capable API nodes, returns an actionable error naming local-pack alternatives.\\n- action:\\\"controlnet\\\" — Image conditioned by a ControlNet preprocessed image (pose skeleton, depth, canny, normal, etc.) plus a text prompt. Upload the control image first with upload_image (action:\\\"image\\\"), then pass its filename as `control_image`. `prompt` and `control_image` are required; `checkpoint` and `controlnet_model` auto-resolve from local models. control_image must ALREADY be a preprocessed map (this action does not run the preprocessor); requires a running ComfyUI with a matching controlnet model in models/controlnet/.\\n- action:\\\"ip_adapter\\\" — Image guided by a reference image's style/subject via IP-Adapter, plus a text prompt. Requires the ComfyUI_IPAdapter_plus custom nodes. Upload the reference first with upload_image (action:\\\"image\\\"), then pass its filename as `reference_image`. `prompt` and `reference_image` are required; `checkpoint` auto-resolves. Requires a running ComfyUI with ComfyUI_IPAdapter_plus and a matching IP-Adapter model installed, or the workflow will fail at execution time.\\n- action:\\\"regenerate\\\" — Re-enqueue the workflow that produced an EXISTING ASSET, optionally applying `overrides`. Overrides are applied to any node input matching the key name (e.g. cfg, steps, sampler_name, scheduler, seed, denoise, text). Seeds are re-randomized by default so each call yields a fresh image unless seed is explicitly passed in overrides. `asset_id` is required. To re-run from execution HISTORY rather than a registered asset, use enqueue_workflow (action:\\\"rerun\\\").\\n- action:\\\"upscale\\\" — Upscale an image with an ESRGAN super-resolution model. Builds an UpscaleModelLoader → ImageUpscaleWithModel workflow (scale=2 supersamples the 4x result back down for sharper output) and enqueues it on your LOCAL GPU. Upload the source first with upload_image (action:\\\"image\\\") (or stage a prior output with upload_image (action:\\\"stage\\\")), then pass its filename as `image`. Needs an upscale model in models/upscale_models/ (e.g. 4x-ClearRealityV1 / 4x_foolhardy_Remacri, provided by the anima/ernie packs or download_model); returns an actionable error if none is found. `image` is required.\\n- action:\\\"remove_background\\\" — Remove an image's background, returning a transparent (RGBA) cutout. Builds a LoadImage → BiRefNetRMBG → SaveImage workflow using the ComfyUI-RMBG (BiRefNet) matting node and enqueues it on your LOCAL GPU. Upload the source first with upload_image (action:\\\"image\\\") (or stage a prior output with upload_image (action:\\\"stage\\\")), then pass its filename as `image`. Requires the ComfyUI-RMBG custom node (pack: wan-transparent, or install_custom_node 'comfyui-rmbg'); the BiRefNet model auto-downloads on first run. If the node isn't installed, returns an actionable error telling you how to install it. `image` is required.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"What to generate. action:\\\"image\\\"/action:\\\"video\\\" require `prompt`; action:\\\"audio\\\" requires `model_family`+`prompt`+`duration`; action:\\\"3d\\\" requires `mode` (+ `prompt` or `image`); action:\\\"controlnet\\\" requires `prompt`+`control_image`; action:\\\"ip_adapter\\\" requires `prompt`+`reference_image`; action:\\\"regenerate\\\" requires `asset_id`; action:\\\"upscale\\\" and action:\\\"remove_background\\\" require `image`.\",\"enum\":[\"image\",\"audio\",\"video\",\"3d\",\"controlnet\",\"ip_adapter\",\"regenerate\",\"upscale\",\"remove_background\"],\"type\":\"string\"},\"asset_id\":{\"description\":\"action:\\\"regenerate\\\" — asset id of the source generation. REQUIRED for that action.\",\"type\":\"string\"},\"audio_quality\":{\"description\":\"action:\\\"audio\\\" — SaveAudioMP3 bitrate/quality (ACE and stable_audio_3, one of 'V0'/'128k'/'320k', default: '320k').\",\"enum\":[\"V0\",\"128k\",\"320k\"],\"type\":\"string\"},\"batch_size\":{\"description\":\"action:\\\"image\\\" — number of images to generate.\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"bpm\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 tempo in beats per minute (ACE only, 10-300, default: 120).\",\"maximum\":300,\"minimum\":10,\"type\":\"integer\"},\"cfg\":{\"description\":\"CFG scale. Actions \\\"image\\\", \\\"audio\\\", \\\"video\\\", \\\"controlnet\\\", \\\"ip_adapter\\\" (video defaults to 1.0 for the distilled model).\",\"exclusiveMinimum\":0,\"type\":\"number\"},\"checkpoint\":{\"description\":\"Checkpoint filename; auto-selected from local models if omitted. The relevant checkpoint differs per action: a diffusion checkpoint for \\\"image\\\"/\\\"controlnet\\\"/\\\"ip_adapter\\\", the LTX checkpoint for \\\"video\\\", the Stable Audio 3 checkpoint for \\\"audio\\\".\",\"type\":\"string\"},\"clip\":{\"description\":\"action:\\\"audio\\\" — Stable Audio CLIP encoder filename (in models/text_encoders/); auto-selected if omitted.\",\"type\":\"string\"},\"clip_a\":{\"description\":\"action:\\\"audio\\\" — primary text encoder filename (in models/text_encoders/); auto-selected if omitted.\",\"type\":\"string\"},\"clip_b\":{\"description\":\"action:\\\"audio\\\" — secondary text encoder filename (in models/text_encoders/); auto-selected if omitted.\",\"type\":\"string\"},\"control_image\":{\"description\":\"action:\\\"controlnet\\\" — filename of the (already-uploaded, already-preprocessed) control image in ComfyUI's input dir. REQUIRED for that action.\",\"type\":\"string\"},\"controlnet_model\":{\"description\":\"action:\\\"controlnet\\\" — ControlNet model file (in models/controlnet/); auto-selected if omitted.\",\"type\":\"string\"},\"disable_random_seed\":{\"description\":\"action:\\\"regenerate\\\" and action:\\\"3d\\\" — if true, do not randomize seed fields. For action:\\\"regenerate\\\", combine with `overrides.seed` to reproduce the exact original image.\",\"type\":\"boolean\"},\"duration\":{\"description\":\"action:\\\"audio\\\" — audio duration in seconds. REQUIRED for that action.\",\"exclusiveMinimum\":0,\"type\":\"number\"},\"filename_prefix\":{\"description\":\"Output filename prefix. action:\\\"audio\\\" (default audio/ace_step or audio/stable_audio_3), action:\\\"video\\\" (default 'video/ltx-2.3') and action:\\\"remove_background\\\" (default 'ComfyUI_cutout').\",\"type\":\"string\"},\"fps\":{\"description\":\"action:\\\"video\\\" — frames per second (default 25).\",\"exclusiveMinimum\":0,\"type\":\"number\"},\"generate_audio_codes\":{\"description\":\"action:\\\"audio\\\" — generate audio codes via the TextEncodeAceStepAudio1.5 LLM (ACE only, default: true).\",\"type\":\"boolean\"},\"guidance_scale\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 cfg_scale, the text encoder guidance scale (ACE only, default: 2).\",\"type\":\"number\"},\"height\":{\"description\":\"Image height in pixels. Actions \\\"image\\\", \\\"controlnet\\\", \\\"ip_adapter\\\".\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"image\":{\"description\":\"Filename of an image in ComfyUI's input dir (upload it first with upload_image (action:\\\"image\\\"), or stage a prior output with upload_image (action:\\\"stage\\\")). REQUIRED for action:\\\"upscale\\\" and action:\\\"remove_background\\\"; the start frame for action:\\\"video\\\" image-to-video; the input image for action:\\\"3d\\\" in mode \\\"image\\\".\",\"type\":\"string\"},\"inputs\":{\"additionalProperties\":{},\"description\":\"action:\\\"3d\\\" — provider-specific extra inputs passed through to the node (e.g. style, texture, quality). Use list_api_nodes (action:\\\"schema\\\") on the chosen node for valid keys.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"language\":{\"description\":\"action:\\\"audio\\\" — language code for prompt (ACE only, default: 'en').\",\"type\":\"string\"},\"lyrics\":{\"description\":\"action:\\\"audio\\\" — lyrics or song structure description (ACE only — section-by-section breakdown).\",\"type\":\"string\"},\"min_p\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 LLM min-p sampling (ACE only, 0-1, default: 0).\",\"maximum\":1,\"minimum\":0,\"type\":\"number\"},\"mode\":{\"description\":\"action:\\\"3d\\\" — \\\"text\\\" = text-to-3D from `prompt`; \\\"image\\\" = image-to-3D from an uploaded input `image`. REQUIRED for that action.\",\"enum\":[\"text\",\"image\"],\"type\":\"string\"},\"model\":{\"description\":\"Model file for the post-processing actions: action:\\\"upscale\\\" — an upscale model in models/upscale_models/ (auto-selected from local models if omitted); action:\\\"remove_background\\\" — the BiRefNet matting model (default 'BiRefNet_toonout'; auto-downloaded by ComfyUI-RMBG).\",\"type\":\"string\"},\"model_family\":{\"description\":\"action:\\\"audio\\\" — audio model family; determines which workflow template and model loaders to use. REQUIRED for that action.\",\"enum\":[\"ace_step_1.5\",\"stable_audio_3\"],\"type\":\"string\"},\"musical_key\":{\"description\":\"action:\\\"audio\\\" — target musical key (ACE only, e.g. 'C major', 'E minor'; default: 'C major').\",\"type\":\"string\"},\"negative_prompt\":{\"description\":\"Negative prompt (default: empty / from defaults). Used by actions \\\"image\\\", \\\"video\\\", \\\"controlnet\\\", \\\"ip_adapter\\\" and — for the Stable Audio 3 family only — \\\"audio\\\".\",\"type\":\"string\"},\"node\":{\"description\":\"action:\\\"3d\\\" — explicit 3D API node class_type to use (e.g. \\\"MeshyTextToModelNode\\\"); auto-selected if omitted. Use list_api_nodes with filter \\\"3d\\\" to see options.\",\"type\":\"string\"},\"overrides\":{\"additionalProperties\":{},\"description\":\"action:\\\"regenerate\\\" — map of input-name → new value applied to every node that already has that input. Common keys: cfg, steps, sampler_name, scheduler, seed, denoise, text.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"preset\":{\"description\":\"action:\\\"ip_adapter\\\" — IPAdapterUnifiedLoader preset (default 'PLUS (high strength)').\",\"type\":\"string\"},\"prompt\":{\"description\":\"Positive text prompt. REQUIRED for actions \\\"image\\\", \\\"audio\\\", \\\"video\\\", \\\"controlnet\\\" and \\\"ip_adapter\\\"; for action:\\\"3d\\\" it is required in mode \\\"text\\\" and optional (passed through only if the chosen node accepts it) in mode \\\"image\\\". Unused by action:\\\"regenerate\\\", action:\\\"upscale\\\" and action:\\\"remove_background\\\".\",\"type\":\"string\"},\"reference_image\":{\"description\":\"action:\\\"ip_adapter\\\" — filename of the (already-uploaded) reference image in ComfyUI's input dir. REQUIRED for that action.\",\"type\":\"string\"},\"resolution\":{\"description\":\"action:\\\"video\\\" — 'WIDTHxHEIGHT' e.g. '768x512' (rounded to multiples of 32; default 768x512).\",\"type\":\"string\"},\"sampler\":{\"description\":\"Sampler name (e.g. euler, dpmpp_2m). Actions \\\"image\\\", \\\"audio\\\", \\\"controlnet\\\", \\\"ip_adapter\\\".\",\"type\":\"string\"},\"scale\":{\"anyOf\":[{\"const\":2,\"type\":\"number\"},{\"const\":4,\"type\":\"number\"}],\"description\":\"action:\\\"upscale\\\" — net upscale factor: 2 or 4 (default 4).\"},\"scheduler\":{\"description\":\"Scheduler (e.g. normal, karras). Actions \\\"image\\\", \\\"audio\\\", \\\"controlnet\\\", \\\"ip_adapter\\\".\",\"type\":\"string\"},\"seconds\":{\"description\":\"action:\\\"video\\\" — clip length in seconds (default 4; ~10s max).\",\"exclusiveMinimum\":0,\"type\":\"number\"},\"seed\":{\"description\":\"Seed (omit to randomize). Actions \\\"image\\\", \\\"audio\\\", \\\"video\\\", \\\"controlnet\\\", \\\"ip_adapter\\\".\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"shift\":{\"description\":\"action:\\\"audio\\\" — ModelSamplingAuraFlow shift parameter (ACE only, default: 3).\",\"type\":\"number\"},\"steps\":{\"description\":\"Sampling steps. Actions \\\"image\\\", \\\"audio\\\", \\\"video\\\", \\\"controlnet\\\", \\\"ip_adapter\\\" (video defaults to 8 for the distilled model).\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"strength\":{\"description\":\"Two DIFFERENT knobs sharing one field, each with its own range, checked when the action runs: action:\\\"video\\\" (i2v only) — adherence to the start frame, 0-1 inclusive (default 0.6; higher = LESS motion); action:\\\"controlnet\\\" — conditioning strength, must be > 0, typically 0.0-2.0 (default 1.0; higher = stronger adherence to the control image).\",\"type\":\"number\"},\"temperature\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 LLM sampling temperature (ACE only, 0-2, default: 0.85).\",\"maximum\":2,\"minimum\":0,\"type\":\"number\"},\"timesignature\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 time signature (ACE only, one of '2'/'3'/'4'/'6', default: '4').\",\"enum\":[\"2\",\"3\",\"4\",\"6\"],\"type\":\"string\"},\"top_k\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 LLM top-k sampling (ACE only, 0-100, default: 0 = disabled).\",\"maximum\":100,\"minimum\":0,\"type\":\"integer\"},\"top_p\":{\"description\":\"action:\\\"audio\\\" — TextEncodeAceStepAudio1.5 LLM top-p nucleus sampling (ACE only, 0-2000, default: 0.9).\",\"maximum\":2000,\"minimum\":0,\"type\":\"number\"},\"unet\":{\"description\":\"action:\\\"audio\\\" — ACE UNet model filename (in models/diffusion_models/); auto-selected if omitted.\",\"type\":\"string\"},\"vae\":{\"description\":\"action:\\\"audio\\\" — ACE VAE model filename (in models/vae/); auto-selected if omitted.\",\"type\":\"string\"},\"weight\":{\"description\":\"action:\\\"ip_adapter\\\" — IP-Adapter influence on the output, typically 0.0-1.0 (default 0.8); higher = closer to the reference.\",\"type\":\"number\"},\"weight_type\":{\"description\":\"action:\\\"ip_adapter\\\" — IPAdapter weight mode (default 'standard' — required by current IPAdapter_plus builds).\",\"enum\":[\"standard\",\"prompt is more important\",\"style transfer\"],\"type\":\"string\"},\"width\":{\"description\":\"Image width in pixels. Actions \\\"image\\\", \\\"controlnet\\\", \\\"ip_adapter\\\".\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"generate_image\"}"},{"name":"get_defaults","hash":"58bc5ff571c3c704860d2e9bda7264f6c4df1a74ec9754cb9e340e7467b4377d","canonical_json":"{\"description\":\"Read and write settings — either OUR generation defaults or ComfyUI's own frontend UI settings. These are two SEPARATE stores and the `action` says which one you mean:\\n- action:\\\"get\\\" — Return the merged view of OUR generation defaults with per-source attribution. Precedence (lowest → highest): config file → COMFYUI_DEFAULT_* env vars → runtime overrides via action:\\\"set\\\". Per-call MCP tool args always win over these defaults when consumed by a workflow-construction tool. Read-only, and works even with no ComfyUI running.\\n- action:\\\"set\\\" — Update OUR generation defaults from `values`. By default updates the in-memory runtime layer (lost on restart); pass persist:true to also write the change into the config file (~/.config/comfyui-mcp/config.json by default). Use this to avoid repeating common values like width, height, steps, cfg, sampler, checkpoint.\\n- action:\\\"get_ui\\\" — Read COMFYUI's OWN per-user frontend UI settings (the Comfy.* ids its Settings panel writes, served by the frontend user manager). This is a DIFFERENT store from action:\\\"get\\\" — nothing here feeds our generation defaults. Read-only. Provide `id` to read one setting's raw stored value; omit `id` to list all stored settings (optionally narrowed by `filter`). Known ids include Comfy.Validation.Workflows (boolean; its strictness rejects some custom-node workflows), Comfy.Execution.PreviewMethod (default|none|auto|latent2rgb|taesd), Comfy.LinkRenderMode (0 straight / 1 linear / 2 spline / 3 hidden), Comfy.UseNewMenu, and Comfy.Sidebar.Location. Ids are frontend-defined and stored verbatim; keys never written by the user are absent here and fall back to invisible frontend defaults. Values are surfaced with their raw stored type (no coercion). Requires a reachable local or remote ComfyUI; not available in Comfy Cloud mode.\\n- action:\\\"set_ui\\\" — Modify one of COMFYUI's OWN persisted frontend UI settings by `id`. This writes ComfyUI's user settings store, NOT our generation defaults (that is action:\\\"set\\\"). The change is persisted immediately and takes effect on the next frontend load/refresh (an already-open UI tab keeps its old value until reloaded). The value is stored as-is: booleans/numbers are NOT coerced from strings, so pass true (not \\\"true\\\") and 2 (not \\\"2\\\"). Known ids: Comfy.Validation.Workflows (boolean; loosening it lets stricter custom-node workflows load), Comfy.Execution.PreviewMethod (default|none|auto|latent2rgb|taesd), Comfy.LinkRenderMode (0 straight / 1 linear / 2 spline / 3 hidden), Comfy.UseNewMenu, Comfy.Sidebar.Location. Ids are frontend-defined; an unknown id is stored verbatim and simply ignored by the UI. Returns { id, previous, value } — the prior value is read first so you can report and undo the change (previous is null when the key was unset).\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which settings operation to perform, and on WHICH store. \\\"get\\\"/\\\"set\\\" are the MCP server's own generation defaults (width, steps, cfg, …); \\\"get_ui\\\"/\\\"set_ui\\\" are ComfyUI's separate frontend UI settings (the Comfy.* ids). \\\"get\\\" takes no other parameters; \\\"set\\\" requires `values` (optional `persist`); \\\"get_ui\\\" takes an optional `id` or `filter`; \\\"set_ui\\\" requires `id` + `value`.\",\"enum\":[\"get\",\"set\",\"get_ui\",\"set_ui\"],\"type\":\"string\"},\"filter\":{\"description\":\"action:\\\"get_ui\\\" — case-insensitive substring filter on setting ids when listing (e.g. 'preview'). Ignored when `id` is given.\",\"type\":\"string\"},\"id\":{\"description\":\"ComfyUI UI setting id, e.g. 'Comfy.Validation.Workflows'. REQUIRED for action:\\\"set_ui\\\". OPTIONAL for action:\\\"get_ui\\\" — omit to list all stored settings.\",\"type\":\"string\"},\"persist\":{\"description\":\"action:\\\"set\\\" — if true, write to the config file in addition to runtime.\",\"type\":\"boolean\"},\"value\":{\"anyOf\":[{\"type\":\"string\"},{\"type\":\"number\"},{\"type\":\"boolean\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},{\"items\":{},\"type\":\"array\"}],\"description\":\"action:\\\"set_ui\\\" — REQUIRED. New value for the ComfyUI UI setting. Stored as-is; booleans/numbers are NOT coerced from strings (pass true, not \\\"true\\\").\"},\"values\":{\"additionalProperties\":{},\"description\":\"action:\\\"set\\\" — REQUIRED. Key/value map of GENERATION defaults to set. Keys are typically lowercase (e.g. width, steps). Not for Comfy.* UI ids — those go through action:\\\"set_ui\\\".\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"get_defaults\"}"},{"name":"get_history","hash":"ecca52ca87f5541056e7350bf012da7b3809c35996cefaef36d82dd0d66820d9","canonical_json":"{\"description\":\"Read what has already been generated on this machine — execution history, why a run failed, and the settings your past renders actually used. Driven by the `action` parameter:\\n- action:\\\"list\\\" — Execution history for a ComfyUI prompt: status, timing, cached nodes, and output details (media filenames for get_image action:\\\"get\\\"). Also carries the raw error/traceback. To diagnose WHY a run FAILED or what is missing, prefer action:\\\"diagnose\\\" — it returns the same failure info PLUS missing models (with the file + widget) and missing node types, which this action does not. Use action:\\\"list\\\" when you need the run's OUTPUTS or timing for a specific prompt_id.\\n- action:\\\"diagnose\\\" — WHY DID MY RENDER FAIL / WHAT IS MISSING? Explains a failed run in ONE call, without needing a canvas — the headless counterpart to the panel's panel_get_errors (\\\"why is this red?\\\"), so mobile/remote sessions get the same answer. Returns: the failed node (id, type) with its `exception_type` + message and a trimmed traceback; **missing_models** (the exact model file that is not installed and the widget holding it — feed the filename to download_model action:'search_civitai', then action:'download_civitai' — or action:'search' then action:'download' — to fix it); **missing_node_types** (node classes this install lacks — feed to search_custom_nodes, then install_custom_node); and any other per-input validation errors. Call this whenever a run fails, an enqueue is rejected, or the user asks what is missing — instead of guessing from raw logs. With no prompt_id it diagnoses the most recent FAILED run (falling back to the most recent run). Read-only.\\n- action:\\\"stats\\\" — Statistics from this MCP server's LOCAL generation-history database (populated as you run workflows; NOT from ComfyUI, and not the same source as action:\\\"list\\\"): total generations, count of unique sampler/scheduler/steps/CFG combos, a per-model-family breakdown, and the most-reused settings. Read-only; works without a running ComfyUI. Returns empty stats until you have generated images. For concrete recommended settings rather than aggregate counts, use action:\\\"suggest\\\".\\n- action:\\\"suggest\\\" — Recommend concrete, proven sampler/scheduler/steps/CFG (and denoise/shift/LoRA) settings derived from that same LOCAL generation-history database. Read-only and works without a running ComfyUI. Narrow results by `model_family`, `lora_hash`, or a name `search`; with no filter it returns the top settings across all history. Returns a ranked list with each combo's reuse count, or a \\\"no history\\\" message until you have generated images. Use this for ready-to-apply values; use action:\\\"stats\\\" for aggregate counts and breakdowns rather than specific suggestions.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which history view to return. \\\"list\\\" and \\\"diagnose\\\" read ComfyUI's execution history and take an optional `prompt_id`; \\\"stats\\\" and \\\"suggest\\\" read this server's own local generation-settings database and take `model_family` (plus `lora_hash`/`search`/`limit` for \\\"suggest\\\"). No action requires any other field.\",\"enum\":[\"list\",\"diagnose\",\"stats\",\"suggest\"],\"type\":\"string\"},\"limit\":{\"description\":\"action:\\\"suggest\\\" — max results (default 10).\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"lora_hash\":{\"description\":\"action:\\\"suggest\\\" — AutoV2 hash (10 chars) of a specific LoRA to find settings for.\",\"type\":\"string\"},\"model_family\":{\"description\":\"Actions \\\"stats\\\" and \\\"suggest\\\" — model-family key to scope to, e.g. 'sdxl', 'flux', 'qwen_image', 'illustrious'.\",\"type\":\"string\"},\"prompt_id\":{\"description\":\"Actions \\\"list\\\" and \\\"diagnose\\\" — the prompt ID to look up (returned by enqueue_workflow). For action:\\\"list\\\", if omitted, returns the most recent COMMITTED execution (chosen by ComfyUI's queue number, not dict order); immediately after a run finishes it can briefly lag by one until ComfyUI commits the new entry, so pass the prompt_id from enqueue_workflow to get that exact run, and prefer the run-finished event for naming a just-produced output. For action:\\\"diagnose\\\", omit to diagnose the most recent FAILED run — preferred over a newer successful one — falling back to the most recent run if nothing failed.\",\"type\":\"string\"},\"search\":{\"description\":\"action:\\\"suggest\\\" — full-text search on model/LoRA filenames (e.g. 'copax', 'lightning').\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"get_history\"}"},{"name":"get_image","hash":"47bc57ac71cde4281eb143fbd361d7125c126ea57b54a15cb0ae6045423f0f0d","canonical_json":"{\"description\":\"Fetch, browse and inspect ComfyUI images and registered assets. Driven by the `action` parameter:\\n- action:\\\"get\\\" — Fetch a generated image from ComfyUI by FILENAME and return it as an inline image. Video/audio outputs (e.g. a VHS_VideoCombine .mp4) and allowlisted mesh/material attachments (.obj, .glb, .gltf, .fbx, .ply, .stl, .mtl) are saved to save_dir with their original extension instead of being rendered inline. Works with remote ComfyUI instances — does not require COMFYUI_PATH. Use get_history (action:\\\"list\\\") first to obtain the filename.\\n- action:\\\"view\\\" — Fetch a registered asset's bytes by ASSET ID and return them as an inline image so the agent can see the result. Use this after a render completes (asset_id is included in the completion notification) to inspect, critique, or compare generated images. Only supports image mime types (PNG/JPEG/WebP); audio/video assets must be saved to disk via action:\\\"get\\\".\\n- action:\\\"list_outputs\\\" — List recently generated image AND video files from ComfyUI's output/ directory, newest-first, with each file's kind ('image' | 'video'), subfolder, size, and modification time. Covers stills (.png/.jpg/.jpeg/.bmp) and video/animation outputs (.mp4/.webm/.mov/.mkv/.m4v/.avi/.gif/.webp). LOCAL ComfyUI (COMFYUI_PATH set): a RECURSIVE filesystem scan of output/ (stills + video, including subfolders like video/ that VHS/SaveVideo write to) AND of temp/ for video files — VHS_VideoCombine with `save_output` unchecked writes the completed .mp4 (including the \\\"-audio.mp4\\\" a run completion names) there; those entries are tagged type:\\\"temp\\\" so action:\\\"get\\\" / upload_image (action:\\\"stage\\\") can fetch them. Reports size + modification time. Preview stills in temp/ (PreviewImage) are omitted. REMOTE ComfyUI: derives the list from /history over HTTP instead (size/modified are unavailable and omitted) and includes type:\\\"temp\\\" videos from history the same way. It does NOT return the media bytes themselves — fetch those with action:\\\"get\\\". USE THIS TO CONFIRM A VIDEO RENDER (e.g. VHS_VideoCombine / LTX / WAN output) when get_history (action:\\\"list\\\") shows the prompt done but lists no output: VHS-style video nodes write the file but often do NOT register in ComfyUI's /history, so the local filesystem scan is the reliable way to verify the .mp4 exists — then chain it with upload_image (action:\\\"stage\\\"). THAT GUARANTEE IS LOCAL-ONLY AND INVERTS ON A REMOTE TARGET: with no disk to scan, this falls back to /history, so a REMOTE listing can neither confirm nor deny a VHS video that never registered, and absence from it is NOT evidence the file is missing. Check a specific filename with action:\\\"get\\\" or upload_image (action:\\\"stage\\\") instead — both read /view. Every remote result says so in its own text. Read-only.\\n- action:\\\"convert\\\" — Re-encode a generated image to PNG, JPEG, or WebP and return it inline as an image content block. Source can be a registered asset_id or a path under the local ComfyUI output directory. Optionally writes the converted image back under the output directory and reports source/output size plus bytes saved.\\n- action:\\\"analyze_color\\\" — Measure the color of a rendered image (not by eye): returns black/white points, contrast (luma std), saturation, per-channel means + cast, and clipping — plus heuristic flags (washedOut, lowContrast, liftedBlacks, dimHighlights, lowSaturation, colorCast) and a one-line verdict. Source = asset_id, a ComfyUI output ref (filename/subfolder/type), or an image path. Pass reference_path to shot-match against a known-good frame (target−reference deltas). Set histogram:true to also get an overlaid R/G/B/luma histogram PNG. Use this to diagnose 'washed out' objectively and decide a color fix; for a video, extract a frame to PNG first.\\n- action:\\\"list_assets\\\" — List recently generated assets, newest-first. Each call first reconciles ComfyUI's /history, so outputs are listed even when this session did not watch the render complete (e.g. queued via panel_run, by an earlier session, or before a server restart) — those are tagged source:'history-reconcile', versus source:'watched' for renders this server saw finish. Newly reconciled image refs are checked through /view before registration; stale or unavailable refs are omitted and disclosed in the response note. Returns count + assets (asset_id, prompt_id, filename, url, source, created_at). The registry is ephemeral and clears on server restart; records expire after COMFYUI_ASSET_TTL_HOURS (default 24h), and only the most recent completed runs are reconciled — use get_history (action:\\\"list\\\") / action:\\\"get\\\" by filename for anything older.\\n- action:\\\"asset_metadata\\\" — Get full provenance for a registered asset including the workflow snapshot that produced it. Use this to inspect the parameters that generated an image before calling generate_image (action:\\\"regenerate\\\") with overrides.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which image/asset operation to perform. \\\"get\\\" requires `filename`; \\\"view\\\" and \\\"asset_metadata\\\" require `asset_id`; \\\"convert\\\" requires `format` plus exactly one of `asset_id`/`path`; action:\\\"analyze_color\\\" takes one source (`asset_id`, `filename`, or `path`); \\\"list_outputs\\\" and action:\\\"list_assets\\\" take no required parameters.\",\"enum\":[\"get\",\"view\",\"list_outputs\",\"convert\",\"analyze_color\",\"list_assets\",\"asset_metadata\"],\"type\":\"string\"},\"asset_id\":{\"description\":\"Asset id returned by action:\\\"list_assets\\\" or job completion. REQUIRED for actions \\\"view\\\" and \\\"asset_metadata\\\". OPTIONAL for \\\"convert\\\" (provide exactly one of asset_id or path) and action:\\\"analyze_color\\\" (one of asset_id, filename, or path).\",\"type\":\"string\"},\"effort\":{\"description\":\"action:\\\"convert\\\" — WebP only: encoder effort, 0-6.\",\"maximum\":6,\"minimum\":0,\"type\":\"integer\"},\"filename\":{\"description\":\"Output image filename, e.g. PulID_Klein_00001_.png. REQUIRED for action:\\\"get\\\". OPTIONAL for action:\\\"analyze_color\\\", where it is one of the three ways to name a source (pair it with subfolder/type).\",\"type\":\"string\"},\"format\":{\"description\":\"Two unrelated meanings, one per action — the enum is the union of both and each action accepts only its own half. action:\\\"list_outputs\\\" — RESPONSE SHAPE: \\\"markdown\\\" (default, human/agent-readable) or \\\"json\\\" ({images:[{filename,subfolder,kind,size,modified,type?}]} — type is \\\"temp\\\" for VHS videos written with save_output unchecked, omitted for output/). action:\\\"convert\\\" — REQUIRED target encoded image format: \\\"png\\\", \\\"jpeg\\\" or \\\"webp\\\".\",\"enum\":[\"markdown\",\"json\",\"png\",\"jpeg\",\"webp\"],\"type\":\"string\"},\"histogram\":{\"description\":\"action:\\\"analyze_color\\\" — also return an overlaid R/G/B/luma histogram PNG for visual confirmation (default false).\",\"type\":\"boolean\"},\"limit\":{\"description\":\"action:\\\"list_outputs\\\" — max media files to return, 1..100 (default 20). action:\\\"list_assets\\\" — max records to return (default: all, no upper bound).\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"lossless\":{\"description\":\"action:\\\"convert\\\" — WebP only: write lossless WebP.\",\"type\":\"boolean\"},\"max_preview_bytes\":{\"description\":\"action:\\\"get\\\" — ceiling on the base64 payload returned INLINE (default ~16MB). The file saved to disk is never affected. Lower it when your client rejects or truncates large tool results; the reply says when it downscaled and by how much.\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"max_preview_dimension\":{\"description\":\"action:\\\"get\\\" — ceiling on the inline preview's longest side in pixels (default 4096). Applies even when the byte budget is satisfied, since some consumers reject by dimension — but only for an image this server can decode; an undecodable one under the byte budget is passed through as-is. Does not affect the saved file.\",\"exclusiveMinimum\":0,\"maximum\":9007199254740991,\"type\":\"integer\"},\"out_path\":{\"description\":\"action:\\\"convert\\\" — optional output path under COMFYUI_PATH/output where the converted image should be written.\",\"type\":\"string\"},\"path\":{\"description\":\"A source image path. action:\\\"convert\\\" — a path under COMFYUI_PATH/output (provide exactly one of asset_id or path). action:\\\"analyze_color\\\" — an absolute image path, or a path under the ComfyUI output dir (videos: extract a frame to PNG first).\",\"type\":\"string\"},\"pattern\":{\"description\":\"action:\\\"list_outputs\\\" — filter by filename pattern (case-insensitive substring match).\",\"type\":\"string\"},\"progressive\":{\"description\":\"action:\\\"convert\\\" — JPEG only: write a progressive JPEG.\",\"type\":\"boolean\"},\"quality\":{\"description\":\"action:\\\"convert\\\" — encoder quality, 1-100. Applies where supported by the selected format.\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"reference_path\":{\"description\":\"action:\\\"analyze_color\\\" — optional reference image to shot-match against; returns target−reference deltas for contrast, black/white points, saturation, and per-channel means.\",\"type\":\"string\"},\"save_dir\":{\"description\":\"action:\\\"get\\\" — absolute local directory to save the file in. Defaults to a 'comfyui-images' folder inside the platform temp directory (os.tmpdir()), which is created if missing. A RELATIVE value is resolved against this MCP process's working directory, which is the client's choice and may not be writable. On Windows a drive-less path like \\\\out is resolved against this process's CURRENT DRIVE, not a drive you chose. Prefer a fully-qualified path (C:\\\\... or \\\\\\\\server\\\\share); the returned 'Saved to:' line always names the resolved absolute path.\",\"type\":\"string\"},\"since\":{\"description\":\"action:\\\"list_assets\\\" — ISO timestamp; only return assets created at or after this time.\",\"format\":\"date-time\",\"pattern\":\"^(?:(?:\\\\d\\\\d[2468][048]|\\\\d\\\\d[13579][26]|\\\\d\\\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\\\d|30)|(?:02)-(?:0[1-9]|1\\\\d|2[0-8])))T(?:(?:[01]\\\\d|2[0-3]):[0-5]\\\\d:[0-5]\\\\d(?:\\\\.\\\\d+)?(?:Z))$\",\"type\":\"string\"},\"subfolder\":{\"description\":\"Subfolder within the directory, if any (default empty). Used by action:\\\"get\\\" and by action:\\\"analyze_color\\\" when the source is a `filename`.\",\"type\":\"string\"},\"type\":{\"description\":\"ComfyUI directory the file lives in: output (default), input, or temp. Used by action:\\\"get\\\" and by action:\\\"analyze_color\\\" when the source is a `filename`.\",\"enum\":[\"output\",\"input\",\"temp\"],\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"get_image\"}"},{"name":"get_system_stats","hash":"35aa016c7bf3f4997a69e528ec9d5814feed425b4c7853971477baf664c737b4","canonical_json":"{\"description\":\"Inspect the connected ComfyUI server: what it is running on, what it has logged, and whether it is healthy enough to dispatch work to. All three actions are READ-ONLY — nothing here mutates anything. Driven by the `action` parameter:\\n- action:\\\"stats\\\" — Get system information from the connected ComfyUI server: GPU device(s), total/free VRAM, ComfyUI/Python/PyTorch versions, and OS details. Requires a running ComfyUI server (works against local or remote targets); read-only, takes no parameters. Returns the raw /system_stats JSON. Use to confirm connectivity and check available VRAM before enqueuing large workflows. Errors if the server is unreachable.\\n- action:\\\"logs\\\" — Get ComfyUI server runtime logs. Useful for debugging execution errors, model loading issues, missing nodes, and Python tracebacks. `max_lines` tails the end (default 100), `keyword` filters case-insensitively.\\n- action:\\\"health\\\" — Pre-flight diagnostic for the connected ComfyUI: one call that aggregates the signals an agent should check before dispatching a batch. Reports ComfyUI version/Python/PyTorch, GPU name + VRAM free/total, system RAM free, queue depth (running + pending), per-category /models populations (catches empty dropdowns from a misconfigured extra_model_paths.yaml), and recent errors from /internal/logs. Read-only — no mutation. Use this when a job fails for an unexpected reason, before a long batch run, or to confirm a remote ComfyUI is healthy. Originally contributed by github.com/joaolvivas.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which read to perform. \\\"stats\\\" takes no other parameters; \\\"logs\\\" takes `max_lines`/`keyword`; \\\"health\\\" takes `model_categories`/`recent_errors`. None of them is required.\",\"enum\":[\"stats\",\"logs\",\"health\"],\"type\":\"string\"},\"keyword\":{\"description\":\"action:\\\"logs\\\" — filter log lines containing this keyword (case-insensitive). Examples: 'error', 'warning', 'VRAM', a node name.\",\"type\":\"string\"},\"max_lines\":{\"description\":\"action:\\\"logs\\\" — maximum number of log lines to return from the end (default: 100).\",\"maximum\":2000,\"minimum\":1,\"type\":\"integer\"},\"model_categories\":{\"description\":\"action:\\\"health\\\" — override the model categories to poll (defaults to checkpoints, diffusion_models, loras, vae, text_encoders, controlnet).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"recent_errors\":{\"description\":\"action:\\\"health\\\" — how many recent error/traceback lines to include from /internal/logs (default 20, max 200).\",\"maximum\":200,\"minimum\":0,\"type\":\"integer\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"get_system_stats\"}"},{"name":"get_workflow","hash":"794ee366f0b2f0d34d4b79bf124db25c2d65a32de9aafaa6fdbb56105edb3746","canonical_json":"{\"description\":\"Return, list, summarize or query a SAVED workflow FILE — files on disk, named from the library or given as a path/JSON — NOT the graph open on the user's canvas (that is panel_graph_outline). Every action here is READ-ONLY; saving and locking are save_workflow. Driven by the `action` parameter:\\n- action:\\\"get\\\" — the full JSON of one saved workflow FILE named from the library. Defaults to converted API format; pass format:'ui' for the raw on-disk UI JSON. Use action:\\\"analyze\\\" instead if you just need to UNDERSTAND the workflow — it returns a structured summary without flooding context with JSON. Use action:\\\"get\\\" only when you need the actual JSON for enqueue_workflow, create_workflow (action:\\\"modify\\\"), or save_workflow.\\n- action:\\\"list\\\" — the workflows saved in the connected ComfyUI server's user library (the same ones visible in the ComfyUI web UI), INCLUDING the ones filed in subfolders. Requires a running ComfyUI server. Takes no other parameters. Returns a numbered list of library names, each relative to the library root — a workflow in a folder appears as 'VIDEO/MiniMaxH3/clip.json', and that whole string is what `filename` takes. It never reports an absence it did not establish: a listing it could not read says so, and an EMPTY listing says the library could not be CONFIRMED empty (an answer with no names in it cannot show whether it covered subfolders) and tells you to check the ComfyUI sidebar rather than recreate anything.\\n- action:\\\"strip\\\" — strip a workflow to a clean, flat API graph, resolving Get/Set buses, Reroutes, subgraph definitions, and bypassed/muted nodes into real connections (the 'de-getter-setter' pass). Unlike action:\\\"get\\\" this reads from ANY server-side file path on disk (not just the workflow library), so it loads ad-hoc / expert workflow files that action:\\\"list\\\" and panel_open_workflow can't resolve. Provide exactly one of: path, filename, or graph. Returns conversion warnings, a node-type summary, and the stripped graph (much smaller than the raw UI JSON).\\n- action:\\\"slice\\\" — slice ONE pipeline out of a toggle-template workflow, the kind built with rgthree 'Fast Groups Bypasser/Muter' where one graph holds many pipelines and only one is active at a time. Seeds from the output/SaveImage nodes in the named `groups`, takes their backward dependency closure (through real links AND virtual Set/Get buses), un-bypasses the kept nodes (and the internals of any subgraph defs they use), and returns a STANDALONE, activated UI graph carrying only the subgraph defs it uses. Pair with action:\\\"strip\\\" afterward to flatten the Set/Get buses into real connections.\\n- action:\\\"from_image\\\" — extract embedded ComfyUI workflow metadata from a PNG file. ComfyUI stores the full workflow (API format) and prompt data in PNG tEXt chunks. Use this to reverse-engineer how any ComfyUI image was generated.\\n- action:\\\"analyze\\\" — SUMMARIZE a saved workflow file named from the library: sections, node settings, connections, and data flow. Returns a concise text summary (not raw JSON) optimized for AI reasoning. Prefer this over action:\\\"get\\\" unless you need the raw JSON for enqueue_workflow or create_workflow (action:\\\"modify\\\").\\n- action:\\\"query\\\" — filter, traverse, project, and aggregate over a saved workflow's nodes WITHOUT dumping the whole JSON (the missing middle between action:\\\"analyze\\\"'s fixed summary and action:\\\"get\\\"'s full dump; on 100+-node graphs this is the ONLY context-safe way to answer questions like 'which KSamplers run cfg>7', 'what feeds node 42', 'count nodes by type'). Provide exactly one of path/filename/graph, then combine: `types`, `title`, `where` widget predicates ANDed ('cfg>7', 'steps<=20', 'sampler_name=euler', 'text~sunset' — ops = != >= <= > < ~contains), `ids`, `upstream_of`/`downstream_of` + `depth`, `fields`, `group_by`, `limit`, `max_chars`. Output is TOKEN-BOUNDED and, when it truncates, the tail names WHICH of the two caps fired and the exact parameter to raise — read it and retry rather than concluding the graph can't be read. For the LIVE canvas this is panel_query_graph instead.\\n- action:\\\"prompt_director\\\" — read Prompt Director's latest sanitized RUNTIME state after its nodes execute: each node id, node kind, resolved Model Explorer model/LoRA context, structured edit plan, source analysis, exact final prompt, warnings, or Result Critic verdict. Secrets and image tensors are redacted. Pair it with a live panel graph audit: graph inspection explains wiring and widget state, while this explains what the nodes actually resolved and compiled. Pass `node_id` to inspect one executed Prompt Director node.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which read to perform. \\\"list\\\" and \\\"prompt_director\\\" take no required parameters; \\\"get\\\" and \\\"analyze\\\" require `filename`; \\\"strip\\\", \\\"slice\\\" and \\\"query\\\" require exactly one of `path`/`filename`/`graph` (and \\\"slice\\\" also requires `groups`); \\\"from_image\\\" requires `image_path`.\",\"enum\":[\"get\",\"list\",\"strip\",\"slice\",\"from_image\",\"analyze\",\"query\",\"prompt_director\"],\"type\":\"string\"},\"depth\":{\"description\":\"action:\\\"query\\\" — Max hops from the traversal seed (seed=0). Absent = full closure.\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"downstream_of\":{\"description\":\"action:\\\"query\\\" — Scope to the nodes CONSUMING this node id's outputs.\",\"type\":[\"string\",\"number\"]},\"fields\":{\"description\":\"action:\\\"query\\\" — Projection: compact one-liners (default), bare ids, or detail JSON rows.\",\"enum\":[\"ids\",\"compact\",\"detail\"],\"type\":\"string\"},\"filename\":{\"description\":\"Workflow library name, exactly as action:\\\"list\\\" reports it. A workflow filed in a folder keeps its folder in the name ('VIDEO/MiniMaxH3/clip.json') and that whole string goes here. An absolute path under the live ComfyUI workspace (e.g. a JSON in data/_downloads) is read from disk, not the user library. REQUIRED for action:\\\"get\\\" and action:\\\"analyze\\\"; one of the three sources for \\\"strip\\\", \\\"slice\\\" and \\\"query\\\".\",\"type\":\"string\"},\"format\":{\"default\":\"api\",\"description\":\"action:\\\"get\\\" — 'api' (default, recommended) converts to compact API format with named inputs, connection references, and _meta.mode flags for muted/bypassed nodes; 'ui' returns the raw UI format with layout positions and links arrays. action:\\\"strip\\\" — 'api' (default) strips to the flat resolved graph; 'raw' returns the file/graph unchanged. Each action accepts only its own two values (this field is the union of what the two tools it replaces accepted) and refuses the third rather than guessing at an alias.\",\"enum\":[\"ui\",\"api\",\"raw\"],\"type\":\"string\"},\"graph\":{\"additionalProperties\":{},\"description\":\"action:\\\"strip\\\" / \\\"slice\\\" / \\\"query\\\" — Inline workflow JSON (UI format for \\\"strip\\\"/\\\"slice\\\"; UI or API for \\\"query\\\"), as an alternative to path/filename.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"group_by\":{\"description\":\"action:\\\"query\\\" — Aggregate: counts per class_type instead of listing.\",\"enum\":[\"type\"],\"type\":\"string\"},\"groups\":{\"anyOf\":[{\"type\":\"string\"},{\"items\":{\"type\":\"string\"},\"type\":\"array\"}],\"description\":\"action:\\\"slice\\\" (REQUIRED) — Group-title substrings (case-insensitive) whose output nodes seed the slice — CSV string or array, e.g. 'TEXT TO IMAGE,TXT' or ['extend','sampler']. Shared post-proc is pulled in via the closure.\"},\"ids\":{\"description\":\"action:\\\"query\\\" — Keep exactly these node ids.\",\"items\":{\"type\":[\"string\",\"number\"]},\"type\":\"array\"},\"image_path\":{\"description\":\"action:\\\"from_image\\\" (REQUIRED) — Absolute path to a ComfyUI-generated PNG file\",\"type\":\"string\"},\"limit\":{\"description\":\"action:\\\"query\\\" — Max nodes listed (default 40, max 200).\",\"maximum\":200,\"minimum\":1,\"type\":\"integer\"},\"max_chars\":{\"description\":\"action:\\\"query\\\" — Output character bound (default 12000, max 60000). Raise this — not `limit` — when the truncation tail says the char budget cut the result.\",\"maximum\":60000,\"minimum\":500,\"type\":\"integer\"},\"node_id\":{\"description\":\"action:\\\"prompt_director\\\" — Optional ComfyUI node id; omit to list all recent Prompt Director runtime states.\",\"type\":\"string\"},\"path\":{\"description\":\"action:\\\"strip\\\" / \\\"slice\\\" / \\\"query\\\" — Absolute server-side path to a workflow .json on disk (e.g. C:\\\\\\\\Users\\\\\\\\you\\\\\\\\ComfyUI\\\\\\\\user\\\\\\\\default\\\\\\\\workflows\\\\\\\\pusa_extend.json). Read directly from disk — no library lookup.\",\"type\":\"string\"},\"section\":{\"description\":\"action:\\\"analyze\\\" — Section name for detail view. Use view='list' first to see available section names.\",\"type\":\"string\"},\"title\":{\"description\":\"action:\\\"query\\\" — Keep nodes whose title contains this.\",\"type\":\"string\"},\"types\":{\"description\":\"action:\\\"query\\\" — Keep nodes whose class_type contains ANY of these (case-insensitive).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"upstream_of\":{\"description\":\"action:\\\"query\\\" — Scope to the dependency closure FEEDING this node id.\",\"type\":[\"string\",\"number\"]},\"view\":{\"default\":\"summary\",\"description\":\"action:\\\"analyze\\\" — summary (default): structured text with sections, node IDs, key settings, virtual wires, and full connection graph — best for AI understanding. overview: mermaid diagram showing sections as summary nodes with cross-section data flow. detail: mermaid diagram for one section (requires section parameter). list: text listing of all sections with data flow summary. flat: single mermaid flowchart of the entire workflow (best for small workflows). health: graph-health heuristics (disconnected nodes, duplicate model loads, orphaned branches, muted/bypassed, a sampler running denoise below 1.0 on an empty latent, an image-edit graph whose sampled canvas is not derived from the reference).\",\"enum\":[\"summary\",\"overview\",\"detail\",\"list\",\"flat\",\"health\"],\"type\":\"string\"},\"where\":{\"description\":\"action:\\\"query\\\" — Widget predicates, ANDed: 'cfg>7', 'sampler_name=euler', 'text~sunset'.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"get_workflow\"}"},{"name":"install_comfyui","hash":"d908f02d4563819a666522401de8f420db4af58c20f052f21d5df140ed1cb259","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"idempotentHint\":false,\"openWorldHint\":true},\"description\":\"Install, update and configure the local ComfyUI installation, its sidebar panel, and this MCP server itself. Driven by the `action` parameter:\\n- action:\\\"install\\\" — Install ComfyUI locally: git-clone it into `target_path`, create a dedicated workspace virtualenv (/.venv), and install Python requirements INTO that venv (never the Python running this MCP server) via pip or uv. ComfyUI-Manager is installed from manager_requirements.txt when present, else git-cloned as a fallback. Mirrors `comfy-cli install`. LOCAL, subprocess-only and independent of any remote --comfyui-url target; the target dir must be empty or non-existent (an existing install is never overwritten). Runs SYNCHRONOUSLY and can take several minutes (large git clone + full torch/dependency install); the call blocks until done. On success returns a JSON report { installed, targetPath, venvPath, comfyuiUrl, managerInstalled, managerVia, version, pythonInstaller, steps[] }. Does NOT start ComfyUI. `target_path` is REQUIRED.\\n- action:\\\"update\\\" — Update the ComfyUI CORE install: runs `git pull` in the connected local server's observed checkout (falling back to COMFYUI_CODE_PATH, then COMFYUI_PATH) and reinstalls its Python requirements (auto-detecting uv vs pip). Returns a clear error when targeting a remote instance via --comfyui-url. The requirements install targets the running server's own interpreter (recorded when this server launched ComfyUI, or an explicit COMFYUI_PYTHON); when that interpreter cannot be verified the update refuses rather than install into a guessed environment — start ComfyUI or connect first. Does NOT touch custom nodes.\\n- action:\\\"update_all\\\" — Update ALL installed CUSTOM NODES via the ComfyUI-Manager HTTP API. Mirrors `comfy-cli update all`. This does NOT update ComfyUI core — use action:\\\"update\\\" for that. Works against the connected instance (local or remote); updates run asynchronously and a ComfyUI restart may be required afterward. REFUSED while the comfyui-mcp sidebar panel is version-pinned, because 'all' would move the pinned panel too and ComfyUI-Manager cannot update everything-except-one-pack — clear the pin with action:\\\"panel\\\" + panel_action:\\\"unpin\\\", or update the other packs individually by id.\\n- action:\\\"panel\\\" — Install, update, reinstall, sync, pin, unpin, unlock, or report status of the ComfyUI sidebar panel ('comfyui-agent-panel' on the Comfy Registry; repo comfyui-mcp-panel) in the LOCAL ComfyUI's custom_nodes, selected by `panel_action` (default \\\"status\\\"). Uses the same ComfyUI-Manager path as install_custom_node and always targets the 'nightly' (git-HEAD) channel. Local-only (no-op/refuses in remote/cloud mode) and NEVER modifies a dev install (a symlinked panel dir). After install/update/reinstall/sync, ComfyUI must be RESTARTED to load the new/updated node — this tool does not auto-restart. The panel is also auto-installed-if-missing when the MCP server loads. A version PIN (panel_action:\\\"pin\\\") holds the panel where it is: while a pin is set, install/update/reinstall/sync and the auto-install all refuse, and 'sync' only warns that a newer panel exists. Panel operations are serialized across orchestrator processes by a lock file that is never auto-reclaimed — if a crashed orchestrator wedges it, panel_action:\\\"unlock\\\" reclaims the lock once it is provably abandoned. This is the SIDEBAR PANEL only; it never touches ComfyUI core or this npm package.\\n- action:\\\"self_update\\\" — Check or apply a self-update of the comfyui-mcp NPM PACKAGE (this MCP server), selected by `self_update_action` (default \\\"status\\\"). The server also auto-checks on start (opt out with COMFYUI_MCP_AUTOUPDATE=0). Detects the install mode: a dev install (npm link / source checkout) is NEVER updated; global/local installs are updated via npm; npx fetches latest on next run. The running process cannot hot-swap its own code — after an update you must RECONNECT (/mcp) or restart the orchestrator to load the new version. This tool does not auto-restart. On Windows the running orchestrator holds its own sharp DLL locked, so an in-place npm replace fails (EBUSY); the update is then handed to a deferred helper that finishes it once the orchestrator has fully stopped, and the new version loads at the next start. A failed update reports npm's own error output. This updates comfyui-mcp ITSELF — not ComfyUI (action:\\\"update\\\"), not the sidebar panel (action:\\\"panel\\\"), and not custom nodes (install_comfyui (action:\\\"update_all\\\")).\\n- action:\\\"environment\\\" — Report ComfyUI environment info (mirrors `comfy-cli env`): the running instance details from /system_stats (OS, Python, ComfyUI version, GPU/VRAM — works for remote targets) plus local probes when a workspace path is available (Python version, git revision, ComfyUI-Manager version, and key pip packages like torch/CUDA). Split installs report `local.workspace_path` for data/base state and `local.code_path` for the serving checkout; git follows the code path and Manager follows the data/base root (`custom_nodes`). The local python probe targets the interpreter the RUNNING server uses (its venv / embedded / standalone python, resolved from the live server), never a bare `python` on PATH. Degrades gracefully and NEVER guesses: when the correct interpreter can't be confirmed, `local.python_probe_trusted` is false, `local.packages` is omitted, and `local.python_probe_reason` says why — an absent package list means UNDETERMINED, never 'not installed'. READ-ONLY.\\n- action:\\\"configure_manager\\\" — Configure ComfyUI-Manager settings, mirroring `comfy-cli manager` subcommands; `manager_setting` picks which setting and `value` its new value. Most settings use the ComfyUI-Manager HTTP API (works against remote ComfyUI); set_network_mode and set_security_level have no HTTP setter and are written to Manager's config.ini (requires a known local ComfyUI path; restart ComfyUI to apply).\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which install/environment operation to perform. action:\\\"update\\\", action:\\\"update_all\\\" and action:\\\"environment\\\" take no other parameters; action:\\\"install\\\" requires `target_path`; action:\\\"panel\\\" takes `panel_action` (+ `version`/`reason` for a pin); action:\\\"self_update\\\" takes `self_update_action`; action:\\\"configure_manager\\\" requires `manager_setting` (+ `value`).\",\"enum\":[\"install\",\"update\",\"update_all\",\"panel\",\"self_update\",\"environment\",\"configure_manager\"],\"type\":\"string\"},\"manager_setting\":{\"description\":\"action:\\\"configure_manager\\\" — REQUIRED. Which ComfyUI-Manager setting to change. HTTP API: set_preview_method, set_db_mode, set_component_policy, set_update_policy, set_channel, reset_queue. config.ini fallback: set_network_mode, set_security_level.\",\"enum\":[\"set_preview_method\",\"set_db_mode\",\"set_component_policy\",\"set_update_policy\",\"set_channel\",\"reset_queue\",\"set_network_mode\",\"set_security_level\"],\"type\":\"string\"},\"panel_action\":{\"default\":\"status\",\"description\":\"action:\\\"panel\\\" — which sidebar-panel operation to run. status: report installed/version/dev-symlink/pin plus a sync assessment (never errors). sync: bring the panel up to what this orchestrator needs — no-ops when already current, WARNS ONLY when pinned, and reports the version re-read from disk afterwards. install: add the panel (nightly). update: pull the latest nightly. Works on either install shape — a git checkout is fast-forwarded, and a Comfy Registry ZIP install (which has no .git) is replaced with a verified fresh clone, keeping the previous copy outside custom_nodes. Success is always re-read from disk. reinstall: uninstall + reinstall (nightly). pin: hold the panel at a version (requires `version`). unpin: clear the pin so a sync can proceed. unlock: recover from a crashed/killed orchestrator's leftover panel operation lock — reclaims it ONLY when it is provably abandoned (older than the stale threshold AND its recorded owner process is dead), and refuses with the observed state otherwise. install/update/reinstall/sync refuse on a dev symlink or an active pin, and require a local workspace (COMFYUI_PATH or the saved default workspace).\",\"enum\":[\"status\",\"install\",\"update\",\"reinstall\",\"sync\",\"pin\",\"unpin\",\"unlock\"],\"type\":\"string\"},\"reason\":{\"description\":\"action:\\\"panel\\\" + panel_action:\\\"pin\\\" only: why the user is pinning (stored with the pin).\",\"type\":\"string\"},\"self_update_action\":{\"default\":\"status\",\"description\":\"action:\\\"self_update\\\" — status: report install mode + current vs latest version + dev-link note (never errors). update: update to the latest published version (refuses on a dev link; no-op when already up to date or for npx).\",\"enum\":[\"status\",\"update\"],\"type\":\"string\"},\"skip_manager\":{\"description\":\"action:\\\"install\\\" — if true, do not clone/install ComfyUI-Manager. Default false (Manager is installed).\",\"type\":\"boolean\"},\"target_path\":{\"description\":\"action:\\\"install\\\" — REQUIRED absolute path to the workspace directory to install ComfyUI into. Must be empty or non-existent.\",\"minLength\":1,\"type\":\"string\"},\"use_uv\":{\"description\":\"action:\\\"install\\\" — if true, prefer `uv pip install` over plain pip when uv is available on PATH. Falls back to pip if uv is missing. Default false.\",\"type\":\"boolean\"},\"value\":{\"description\":\"action:\\\"configure_manager\\\" — value for the chosen `manager_setting` (omit only for reset_queue). Allowed values per setting — set_preview_method: auto | latent2rgb | taesd | none; set_db_mode: local | cache | remote; set_component_policy: workflow | higher | mine; set_update_policy: stable-comfyui | nightly-comfyui; set_channel: a channel name (e.g. default); set_network_mode: public | private | offline; set_security_level: strong | normal | normal- | weak. HTTP-API settings take effect live; the config.ini ones (set_network_mode, set_security_level) apply only after a ComfyUI restart.\",\"type\":\"string\"},\"version\":{\"description\":\"action:\\\"install\\\" — ComfyUI version to install (comfy-cli semantics): \\\"nightly\\\" (default-branch HEAD), \\\"latest\\\" (newest release tag), or a semantic version like \\\"0.3.40\\\" (checked out as tag v0.3.40). Raw git refs/branches are rejected. Omit to track the default branch HEAD. ALSO used by action:\\\"panel\\\" + panel_action:\\\"pin\\\", where it is the PANEL version to hold at, e.g. '0.11.20' (take it from the installedVersion that panel_action:\\\"status\\\" reports).\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"install_comfyui\"}"},{"name":"install_custom_node","hash":"a1981c08a7c4902fce00e97136594e1150aef8104d4f5712a80eb173febf736d","canonical_json":"{\"description\":\"Install, repair, enable/disable and remove ComfyUI custom node packs on this ComfyUI. To FIND a pack in the public registry first, use search_custom_nodes. Driven by the `action` parameter:\\n- action:\\\"install\\\" — Install a pack by registry id, git URL, or name. Local installs prefer official comfy-cli when available; remote or CLI-unavailable installs use the ComfyUI-Manager HTTP API. A ComfyUI restart may be required. Targeting the comfyui-mcp sidebar panel pack ('comfyui-agent-panel' / 'comfyui-mcp-panel') is routed through the verified install_comfyui(action:'panel') path (the version is re-read from disk afterwards) and is REFUSED while the panel is version-pinned.\\n- action:\\\"update\\\" — Update an installed pack, or pass id:'all' to update every installed pack. Local operations prefer official comfy-cli; remote operations use Manager HTTP. Targeting the sidebar panel pack is routed through the verified install_comfyui(action:'panel') path. While the panel is version-pinned, BOTH a direct panel target and 'all' are REFUSED — 'all' would move the pinned panel too; clear the pin with install_comfyui(action:'panel', panel_action:'unpin') or update other packs individually.\\n- action:\\\"reinstall\\\" — Reinstall a pack. Local operations prefer official comfy-cli; remote operations use Manager HTTP. A ComfyUI restart may be required. A panel target is routed through the verified install_comfyui(action:'panel') path and is REFUSED while the panel is version-pinned.\\n- action:\\\"fix\\\" — Repair a pack's install and Python dependencies, or pass id:'all' to repair every pack. Local operations prefer official comfy-cli; remote single-pack repairs use Manager HTTP. REFUSES the sidebar panel pack — 'fix' has no verified on-disk check, so use install_comfyui(action:'panel') for the panel — and refuses 'all' while the panel is version-pinned.\\n- action:\\\"uninstall\\\" — Uninstall a pack (removes it). IRREVERSIBLE through this tool — for a cleanup audit prefer action:\\\"disable\\\", which is reversible. The pack must be one ComfyUI-Manager tracks: an id that resolves nowhere is REFUSED before anything is queued (a drained queue would otherwise read exactly like a success), and a pack that is on disk but unmanaged is named so you can remove its directory yourself. After the queue drains the installed-pack list is re-read and the pack must be GONE before anything claims 'uninstalled'. A ComfyUI restart is required to unload it fully. REFUSES the sidebar panel pack.\\n- action:\\\"disable\\\" — Disable an installed pack WITHOUT removing it — the reversible first step of a cleanup (re-enable with action:\\\"enable\\\"; action:\\\"uninstall\\\" removes a pack outright). Uses the ComfyUI-Manager HTTP API (works against remote instances) or official comfy-cli locally, and re-reads the installed-pack list afterwards so a Manager no-op is reported as NOT disabled rather than as success. A ComfyUI restart is required for the change to take effect. REFUSES the sidebar panel pack.\\n- action:\\\"enable\\\" — Re-enable a pack previously disabled with action:\\\"disable\\\". Same Manager/comfy-cli mechanics and the same post-op re-read, so a Manager no-op is reported as NOT enabled rather than as success. A ComfyUI restart is required for the change to take effect. REFUSES the sidebar panel pack.\\n- action:\\\"list\\\" — List installed packs with their version and enabled/disabled state. Uses the ComfyUI-Manager HTTP API (works against remote instances); useCmCli:true uses cm-cli when its installed version is supported, otherwise falls back to Manager HTTP, while the cm-cli path returns names only. Read-only.\\n- action:\\\"sync_deps\\\" — Reconcile the Python dependencies of ALL installed packs through official `comfy node restore-dependencies`. Requires a local ComfyUI install and comfy-cli; takes no other parameters.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which custom-node operation to perform. \\\"install\\\", \\\"update\\\", \\\"reinstall\\\", \\\"fix\\\", \\\"uninstall\\\", \\\"enable\\\" and \\\"disable\\\" require `id`; \\\"list\\\" and \\\"sync_deps\\\" take no required parameters.\",\"enum\":[\"install\",\"update\",\"reinstall\",\"fix\",\"uninstall\",\"enable\",\"disable\",\"list\",\"sync_deps\"],\"type\":\"string\"},\"channel\":{\"description\":\"ComfyUI-Manager channel name (default 'default').\",\"type\":\"string\"},\"id\":{\"description\":\"The pack to act on. REQUIRED for actions \\\"install\\\", \\\"update\\\", \\\"reinstall\\\", \\\"fix\\\", \\\"uninstall\\\", \\\"enable\\\" and \\\"disable\\\". For \\\"install\\\" this is a registry id, git URL, or node-pack name (find one with search_custom_nodes); for \\\"update\\\"/\\\"fix\\\" it may also be 'all' (every installed pack); for \\\"update\\\"/\\\"reinstall\\\"/\\\"fix\\\"/\\\"uninstall\\\"/\\\"enable\\\"/\\\"disable\\\" it is a registry id / module name of an INSTALLED pack.\",\"type\":\"string\"},\"mode\":{\"description\":\"Two distinct meanings, one per action group. For actions \\\"install\\\"/\\\"update\\\"/\\\"reinstall\\\"/\\\"fix\\\": the ComfyUI-Manager data source (default 'remote'); 'remote' fetches the live node list, 'local'/'cache' use bundled/cached data. For action:\\\"list\\\": 'default' lists the installed packs as they are on disk NOW; 'imported' returns that SAME custom_nodes/ scan frozen at ComfyUI startup, so the only difference is packs installed or removed since the server booted. 'imported' is NOT an import-success filter: it includes DISABLED packs and cannot tell you whether the Python of a pack actually loaded — for that use node_pack action:\\\"verify\\\", which checks the node class_types of the pack against /object_info on the running server. Passing a value from the wrong group is refused, naming the ones the action accepts.\",\"enum\":[\"remote\",\"local\",\"cache\",\"default\",\"imported\"],\"type\":\"string\"},\"ref\":{\"description\":\"action:\\\"install\\\" — git ref (commit SHA, branch, or tag) to pin when installing a git URL. Overrides any ref parsed from the URL and any `version` value. Ignored for registry-id installs.\",\"type\":\"string\"},\"source\":{\"description\":\"action:\\\"install\\\" — how to interpret `id` (default 'auto', which detects git URLs vs registry ids).\",\"enum\":[\"registry\",\"git\",\"auto\"],\"type\":\"string\"},\"useCmCli\":{\"description\":\"Prefer the official comfy-cli subprocess instead of the ComfyUI-Manager HTTP API. Local operations use comfy-cli by default; set false to force Manager HTTP. Requires a local ComfyUI install — for actions \\\"install\\\"/\\\"disable\\\"/\\\"enable\\\"/\\\"uninstall\\\"/\\\"list\\\", an unavailable or unsupported CLI falls back to Manager HTTP automatically (disclosed in the result); \\\"update\\\"/\\\"reinstall\\\"/\\\"fix\\\" do not fall back.\",\"type\":\"boolean\"},\"version\":{\"description\":\"Version to install. action:\\\"install\\\" — e.g. 'latest', 'nightly', or a semver; for git installs this is treated as a git ref unless `ref` is also provided, and registry installs default to 'latest'. action:\\\"reinstall\\\" — version to reinstall (default 'latest').\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"install_custom_node\"}"},{"name":"kitchen","hash":"ba8f1008c459839e99b418652b41beab4791644c6fc5c0a8ae2afb8099ccb6de","canonical_json":"{\"description\":\"See what comfy-kitchen can do on this GPU, find where a graph is leaving it on the table, and apply the faster path. Driven by `action`:\\n- action:\\\"status\\\" — kitchen version, backends (hip/cuda/triton/eager), INT8 attention, GPU fp8/NVFP4/MXFP8, launch flags (--use-ck-attention, --enable-triton-backend, --fast fp8_matrix_mult). Local gets log + /system_stats + an import probe when COMFYUI_PATH is set; remote gets log + /system_stats only and reports model.quant / the probe as unknown. A failed probe is unknown, never a no.\\n- action:\\\"assess\\\" — walk the workflow JSON's UNETLoaders and emit a recommendation only when every fact it needs is known: (1) weight_dtype default on a bf16 UNETLoader + GPU fp8 + kitchen present → fp8_e4m3fn_fast (widget, no restart); (2) no --use-sage-attention, sageattention not installed, kitchen INT8 available → --use-ck-attention (restart, confirm); (3) Blackwell + local NVFP4 sibling → model swap; (4) ROCm + triton ≥ 3.7 + kitchen, triton backend off → --enable-triton-backend. Pass `workflow` (API or UI JSON). For the open canvas use panel_kitchen.\\n- action:\\\"apply\\\" — apply one recommendation_id from assess. Widget edits are reversible and do not need confirm. Flags and downloads need `confirm: true`. Flag apply names the launch flag; restart_comfyui replays the previous argv and does not inject a new one. Proof (before/after s/it, peak VRAM, output not black) is the panel_kitchen apply path.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which kitchen operation. \\\"status\\\" takes no other parameters; \\\"assess\\\" takes `workflow`; \\\"apply\\\" takes `recommendation_id` and `confirm` for restarts/downloads.\",\"enum\":[\"status\",\"assess\",\"apply\"],\"type\":\"string\"},\"confirm\":{\"description\":\"action:\\\"apply\\\" — required true for anything that restarts or downloads. Widget edits do not need it.\",\"type\":\"boolean\"},\"recommendation_id\":{\"description\":\"action:\\\"apply\\\" — id from assess (e.g. \\\"fp8_unet_fast:12\\\" or \\\"ck_attention\\\").\",\"type\":\"string\"},\"workflow\":{\"anyOf\":[{\"type\":\"string\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}],\"description\":\"action:\\\"assess\\\" / \\\"apply\\\" — workflow JSON (API-format {id:{class_type,inputs}} or UI-format {nodes,links}), as a string or object.\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"kitchen\"}"},{"name":"list_api_nodes","hash":"5642cfd50a53bfd9825d222efe83ce93e58a89cfe04edb12c23d404ada1ad691","canonical_json":"{\"description\":\"Discover and run hosted partner/API nodes on the connected ComfyUI (e.g. Flux/BFL, Ideogram, Kling, Stability). These call external image/video providers and run server-side, requiring a Comfy account/API key configured on the ComfyUI server — they spend PAID api credits, unlike a local-GPU render. Driven by the `action` parameter:\\n- action:\\\"list\\\" — List the API/partner nodes available on the connected ComfyUI, optionally narrowed by `filter`. Returns an empty list if the server has no API nodes (or they are disabled). Start here to find a class_type.\\n- action:\\\"schema\\\" — Return the input schema for one API/partner node (`class_type`) from the connected ComfyUI's /object_info. Lists visible inputs (with types/defaults/options), hidden inputs (server-filled auth), and outputs. Use action:\\\"list\\\" first to find a class_type.\\n- action:\\\"generate\\\" — Build a minimal single-node workflow that runs a chosen API/partner node (`class_type`) with the provided `inputs` and enqueue it. Returns immediately with the prompt_id (use queue (action:\\\"status\\\") / get_history for results). Do NOT pass auth credentials in inputs — the ComfyUI server injects those from its logged-in session. Use action:\\\"schema\\\" to discover valid inputs.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which API-node operation to perform. \\\"list\\\" takes an optional `filter`; \\\"schema\\\" requires `class_type`; \\\"generate\\\" requires `class_type` + `inputs` (optional `disable_random_seed`).\",\"enum\":[\"list\",\"schema\",\"generate\"],\"type\":\"string\"},\"class_type\":{\"description\":\"The node class_type, e.g. \\\"FluxProImageNode\\\". REQUIRED for action:\\\"schema\\\" and action:\\\"generate\\\"; find one with action:\\\"list\\\".\",\"type\":\"string\"},\"disable_random_seed\":{\"description\":\"action:\\\"generate\\\" — if true, do not randomize seed/noise_seed inputs.\",\"type\":\"boolean\"},\"filter\":{\"description\":\"action:\\\"list\\\" — case-insensitive substring to narrow results, matched against class_type, display name, or category (e.g. \\\"image\\\", \\\"video\\\", \\\"kling\\\").\",\"type\":\"string\"},\"inputs\":{\"additionalProperties\":{},\"description\":\"action:\\\"generate\\\" — REQUIRED. Input values keyed by input name, per the node's schema (action:\\\"schema\\\").\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"list_api_nodes\"}"},{"name":"list_local_models","hash":"ae2102a8ec8a0a577f95358b71b3f13d258a5805c43901d91949fcfece2b6136","canonical_json":"{\"description\":\"Inspect what models this ComfyUI has installed, and where it looks for them. Driven by the `action` parameter:\\n- action:\\\"list\\\" — List model files available to the connected ComfyUI, grouped by type. Read-only. Queries ComfyUI's /models REST endpoint first (works with remote ComfyUI and respects extra_model_paths.yaml — symlinked / mounted dirs the install-path filesystem scan would miss). LOCAL ComfyUI then falls back to a filesystem scan of COMFYUI_PATH/models/ when the REST endpoint is unavailable; REMOTE ComfyUI never scans this MCP host's local path, so an unavailable remote listing is returned as undetermined rather than another machine's inventory. Size and modified time are only available on the local filesystem fallback path. Use to see which models are already available before generating or downloading; use download_model action:\\\"search\\\" to discover new models on HuggingFace, then action:\\\"download\\\" to fetch them. For models fetched via download_model action:\\\"download_civitai\\\", any CivitAI trigger/activation words and base model are shown inline (read from the `.civitai.json` sidecar) — apply those trigger words in your prompt when generating with that model. A `civitai:` line under an entry is that model's CivitAI page URL (modelId + INSTALLED modelVersionId, from the same sidecar) — use it to reference the source or check for newer versions.\\n- action:\\\"remove\\\" — DELETES a model FILE from the local ComfyUI models directories. `path` is REQUIRED and is a file path relative to models/. THIS IS DESTRUCTIVE AND HAS NO UNDO: the file is unlinked, not moved to a recycle bin, and a large checkpoint can take hours to re-download — confirm the exact path with the user (action:\\\"list\\\" shows it) before calling. Removal searches only roots the connected local server itself names or whose extra-path config is proven to have been loaded unchanged since launch (server-named/launch-state-proven roots). A root shown by action:\\\"list_paths\\\" may be visible but unproven, so removal can refuse it; read-only list/list_paths lookups can show configured roots. The path must stay within a known root (path traversal and absolute escapes are rejected), and a directory is refused. LOCAL-ONLY: deletes from the local filesystem, so it is not supported against a remote ComfyUI (remove the file on the host). Do NOT confuse this with action:\\\"remove_path\\\", which edits a config file and deletes nothing.\\n- action:\\\"embeddings\\\" — List textual-inversion embeddings installed on the connected ComfyUI server (read from its /api/embeddings endpoint, i.e. the models/embeddings folder). Requires a running, reachable ComfyUI (local or remote); takes no other parameters. Returns the embedding names; reference them in positive or negative prompts as embedding:name (e.g. embedding:easynegative). Read-only.\\n- action:\\\"list_paths\\\" — View ComfyUI extra search-path config for standalone/manual installs and ComfyUI Desktop. Read-only. Resolves LIVE-FIRST: the file the running ComfyUI actually reads (its --extra-model-paths-config, else the extra_model_paths.yaml beside its main.py), falling back to the local heuristic only when no server is reachable — /extra_model_paths.yaml (COMFYUI_PATH, else the saved default workspace from workspace action:\\\"set_default\\\") or the Desktop app-data extra_models_config.yaml. Reports generic categories, so model categories and custom_nodes entries are both visible when present. Because it is read-only it never refuses a reachable LOCAL server just because its argv does not prove which file it reads: it shows the server-named config when that file exists here, else the local auto-selected one, always labelled as unconfirmed rather than presented as the live server's. action:\\\"add_path\\\"/action:\\\"remove_path\\\" still refuse in that state — a write to an unproven file would be a silent no-op.\\n- action:\\\"add_path\\\" — Add a directory to a ComfyUI extra search-path YAML config; `category` + `path` are REQUIRED. Use this for model categories such as checkpoints/loras/vae and, on ComfyUI builds that support it, custom_nodes. Writes the config file and returns the updated view; restart ComfyUI to apply.\\n- action:\\\"remove_path\\\" — Remove a directory from a ComfyUI extra search-path YAML config; `category` + `path` are REQUIRED. Matches the stored path exactly. This edits the YAML only — it deletes NO model files and frees no disk space (that is action:\\\"remove\\\"). Restart ComfyUI after removing an active path.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which inventory operation to perform. \\\"list\\\" (optional `model_type`), \\\"embeddings\\\" and \\\"list_paths\\\" are READ-ONLY. \\\"remove\\\" DELETES the model file named by `path` — required, and destructive. \\\"add_path\\\"/\\\"remove_path\\\" edit the extra-search-path YAML and require `category` + `path`; they never touch model files.\",\"enum\":[\"list\",\"remove\",\"embeddings\",\"list_paths\",\"add_path\",\"remove_path\"],\"type\":\"string\"},\"category\":{\"description\":\"REQUIRED for action:\\\"add_path\\\" / action:\\\"remove_path\\\" — the ComfyUI search-path category, e.g. checkpoints, loras, vae, diffusion_models, unet_gguf, or custom_nodes.\",\"minLength\":1,\"type\":\"string\"},\"config_path\":{\"description\":\"action:\\\"list_paths\\\" / \\\"add_path\\\" / \\\"remove_path\\\" — explicit YAML config path override, mainly for advanced/manual installs.\",\"type\":\"string\"},\"group\":{\"description\":\"action:\\\"add_path\\\" / \\\"remove_path\\\" — top-level YAML group to edit. Defaults to comfyui_mcp.\",\"type\":\"string\"},\"is_default\":{\"description\":\"action:\\\"add_path\\\" — set is_default on a newly-created group. Existing groups are not overwritten.\",\"type\":\"boolean\"},\"model_type\":{\"description\":\"action:\\\"list\\\" — filter by model type (e.g. 'checkpoints', 'loras'). Lists all types if omitted.\",\"enum\":[\"checkpoints\",\"loras\",\"vae\",\"upscale_models\",\"controlnet\",\"embeddings\",\"clip\",\"diffusers\",\"diffusion_models\",\"gligen\",\"hypernetworks\",\"photomaker\",\"style_models\",\"text_encoders\",\"unet\"],\"type\":\"string\"},\"path\":{\"description\":\"REQUIRED by three actions, and it means two DIFFERENT things — read this before calling. action:\\\"remove\\\": the MODEL FILE to DELETE, relative to the ComfyUI models/ directory (e.g. 'checkpoints/sd_xl_base_1.0.safetensors'); the leading segment is the category used to locate the file in extra roots too. action:\\\"add_path\\\" / action:\\\"remove_path\\\": a DIRECTORY to add to / remove from the extra-search-path YAML for `category` (absolute paths are safest; relative paths are resolved by ComfyUI) — no file is deleted.\",\"minLength\":1,\"type\":\"string\"},\"target\":{\"description\":\"action:\\\"list_paths\\\" / \\\"add_path\\\" / \\\"remove_path\\\" — config target. auto (default) is LIVE-FIRST: the running ComfyUI's own --extra-model-paths-config, else the extra_model_paths.yaml next to its main.py. When no server is reachable, auto shows the Desktop config if one exists, otherwise standalone. When a reachable LOCAL server does not expose main.py, listing degrades to the server-named config (if it exists here) or the local auto-selected one, explicitly marked as an unconfirmed display fallback; mutations refuse instead. standalone forces /extra_model_paths.yaml, where the root is COMFYUI_PATH (or an auto-detected install) and falls back to the saved default workspace; desktop forces the OS app-data extra_models_config.yaml. Use standalone/desktop (or config_path) to deliberately target a file the running server does not read.\",\"enum\":[\"auto\",\"standalone\",\"desktop\"],\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"list_local_models\"}"},{"name":"list_packs","hash":"6154a5f28e79690bea19a5db21518fe040e1f35e7fe6037958ae1516743992fd","canonical_json":"{\"description\":\"Bundled ComfyUI knowledge — installer packs, model-family skills, workflow templates — plus the two workflow-readiness checks. Driven by the `action` parameter:\\n- action:\\\"list\\\" — List the bundled installer packs under packs/: one-command setups for a model family (custom nodes + model weights via manifest.yaml) PLUS a ready workflow.json graph. Each entry reports its family/kind, its runtime (these packs are LOCAL-GPU / FREE — they run on the user's own GPU and never spend paid API credits), whether it has a ready workflow + manifest, and the manifest path for install_comfyui apply_manifest. When asked to \\\"set up / build a workflow\\\", PREFER applying the matching pack and loading its ready workflow (panel_load_workflow pack:) over building a generic graph from scratch. Read the ready graph with action:\\\"read_workflow\\\", and inspect its install manifest with action:\\\"read_manifest\\\".\\n- action:\\\"read_workflow\\\" — Return a bundled pack's ready workflow.json graph by pack name (`name`; discover names + which packs have a workflow with action:\\\"list\\\"). This is the EXPERT graph for that model family — use it as the source of truth when setting up the family on the user's canvas: recreate it node-by-node with the panel_* tools (panel_add_node / panel_connect / panel_set_widget) so it lands on their live canvas, or enqueue it headlessly. Prefer this over inventing a graph from scratch. Names are validated (no path traversal) and must match an existing pack directory.\\n- action:\\\"read_manifest\\\" — Return a bundled pack's install manifest (its manifest.yaml — the custom nodes + model weights apply_manifest would install) by pack name (`name`; discover names + which packs have a manifest with action:\\\"list\\\"). READ-ONLY — the way to INSPECT what a pack will install BEFORE calling the mutating apply_manifest. Names are validated (no path traversal) and must match an existing pack directory.\\n- action:\\\"list_templates\\\" — List CUSTOM-NODE-contributed ComfyUI workflow templates on the connected ComfyUI, grouped by source (each pack's own example_workflows/*.json). Hits the live server's /api/workflow_templates index. SCOPE LIMIT: this endpoint does NOT include ComfyUI's own core bundled templates from the comfyui-workflow-templates package (e.g. \\\"Flux.1 Inpaint\\\") — those are served to the frontend as static assets via a separate code path this action cannot see, so a small/empty result here does NOT mean no official template exists, only that no custom-node pack contributed one. When asked to \\\"set up / build a workflow\\\", check here for a custom-node-contributed starter AFTER checking the bundled skills + installer packs (action:\\\"skill_list\\\" / action:\\\"list\\\"), and also tell the user to check the ComfyUI frontend's own Templates browser directly for core templates, since this action cannot enumerate those. NOTE: this lists what's available; loading a template onto the canvas is done in the ComfyUI frontend's Templates browser (the panel agent cannot load a template graph headlessly yet) — surface the matching template name to the user.\\n- action:\\\"check_runtime\\\" — Determine whether a workflow runs on the user's OWN GPU (LOCAL — free) or uses hosted API NODES (PAID api credits). Pass `pack` (a bundled pack name — always local/free) OR `graph` (a UI or API/prompt workflow JSON, as object or string). It scans the workflow's node class_types against the connected ComfyUI's API-node set (the same signal list_api_nodes uses) and returns { runtime: 'local'|'api'|'mixed'|'unknown', usesApiNodes, apiNodes[], externalApiNodes[], unknownNodes[] } — 'unknown' means some nodes couldn't be classified (could be paid), so treat it (and 'api'/'mixed') as POSSIBLY PAID; only 'local' is confirmed free. `externalApiNodes` is the THIRD-PARTY paid kind (a fal.ai-style pack, or any node taking a service credential): those are INSTALLED LOCALLY yet still cost money, billed by that provider on the user's own account with them rather than out of Comfy api credits — so when you ask the user, name the provider, not \\\"Comfy credits\\\" (`externalProviders` names it when recognised — e.g. [\\\"fal.ai\\\"]; it is absent when the node was flagged only by taking a service credential, which proves it authenticates somewhere but not to whom). ALWAYS call this before building OR loading a non-pack/ad-hoc workflow so you can ASK the user before spending paid API credits — never silently use API nodes.\\n- action:\\\"extract_deps\\\" — Analyze a ComfyUI workflow (`workflow`, API JSON) and determine which custom node packs it requires. Maps each node class_type to its owning node pack using ComfyUI-Manager mappings and the server's installed node definitions, reporting which packs are installed vs missing. READ-ONLY — it installs nothing. Works remotely (HTTP only) — mirrors `comfy-cli node deps-in-workflow`.\\n- action:\\\"install_deps\\\" — MUTATING: this is the ONE action on this tool that INSTALLS anything. Resolve and INSTALL the custom node packs a ComfyUI workflow (`workflow`) requires, via ComfyUI-Manager: it determines the missing packs, resets the Manager queue, QUEUES THE INSTALLS, starts the worker, and reports what was installed/already-present/unresolved. Installing a pack downloads and runs third-party code (and may pull large files) on the connected ComfyUI host — local OR remote --comfyui-url — and a ComfyUI restart is typically needed before new nodes load. Use action:\\\"extract_deps\\\" first if you only want to SEE what is missing. Mirrors `comfy-cli node install-deps`.\\n- action:\\\"skill_list\\\" — List the bundled ComfyUI model-family + workflow skills shipped with comfyui-mcp (name + description for each). These encode per-family expertise (e.g. krea2-txt2img: native krea2 CLIPLoader, Qwen3-VL encoder, 8-step turbo settings) and the installer-packs system. Call this BEFORE hand-building a workflow from scratch — if a matching skill exists, read its full guidance with action:\\\"skill_read\\\" and prefer a ready installer pack (action:\\\"list\\\") over a generic graph. Claude loads these natively; this action gives the SAME knowledge to any MCP client (e.g. the Codex backend).\\n- action:\\\"skill_read\\\" — Return the full body of a bundled skill's SKILL.md by name (`name`; discover names with action:\\\"skill_list\\\"). Gives you the family's complete expertise on demand — model slots, node graph, recommended settings, and gotchas — so you can build the right workflow instead of guessing. Names are validated (no path traversal) and must match an existing skill directory.\\n- action:\\\"generate_skill\\\" — MUTATING: it WRITES to the read-through skill cache on every cache miss, and when `install_in` is set it ALSO creates that directory and overwrites any SKILL.md in it. Generate a Claude skill (SKILL.md) documenting a ComfyUI custom node pack: its nodes, inputs/outputs, and example workflows. `source` accepts a ComfyUI Registry ID (resolved via api.comfy.org) or a GitHub repository URL. Uses a read-through cache under ~/.comfyui-mcp/skill-cache (override COMFYUI_SKILL_CACHE_DIR); set refresh:true to bypass it. On cache miss, fetches the repo README and scans its Python NODE_CLASS_MAPPINGS and example workflows over the network (uses GITHUB_TOKEN if set to avoid rate limits), so internet access is required. If a ComfyUI server is reachable it enriches node input/output types from /object_info, but the server is optional. Returns the SKILL.md markdown with structured cache metadata; if install_in is set, also creates that directory (recursively) and writes SKILL.md there, overwriting any existing file.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which knowledge operation to perform. \\\"list\\\", \\\"list_templates\\\" and \\\"skill_list\\\" take no other parameters; \\\"read_workflow\\\", \\\"read_manifest\\\" and \\\"skill_read\\\" require `name`; \\\"check_runtime\\\" takes `pack` OR `graph`; \\\"extract_deps\\\" and \\\"install_deps\\\" require `workflow` (and \\\"install_deps\\\" INSTALLS custom nodes — the only action here that installs, though \\\"generate_skill\\\" also WRITES to disk: its skill cache on every miss, plus `install_in` when set); \\\"generate_skill\\\" requires `source` (optional `install_in`/`refresh`).\",\"enum\":[\"list\",\"read_workflow\",\"read_manifest\",\"list_templates\",\"check_runtime\",\"extract_deps\",\"install_deps\",\"skill_list\",\"skill_read\",\"generate_skill\"],\"type\":\"string\"},\"graph\":{\"anyOf\":[{\"type\":\"string\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}],\"description\":\"action:\\\"check_runtime\\\" — a workflow graph to classify (UI or API/prompt format), as an object or a JSON string. Use this for ad-hoc/generated workflows.\"},\"install_in\":{\"description\":\"action:\\\"generate_skill\\\" — optional directory to write the generated SKILL.md into. Created recursively if missing; an existing SKILL.md is overwritten. Omit to only return the markdown without touching disk.\",\"type\":\"string\"},\"name\":{\"description\":\"REQUIRED for action:\\\"read_workflow\\\" and action:\\\"read_manifest\\\" — the pack name (a directory under packs/, e.g. 'krea2-txt2img-manual'), from action:\\\"list\\\". REQUIRED for action:\\\"skill_read\\\" — the skill name (a directory under plugin/skills/, e.g. 'krea2-txt2img'), from action:\\\"skill_list\\\".\",\"minLength\":1,\"type\":\"string\"},\"pack\":{\"description\":\"action:\\\"check_runtime\\\" — a bundled pack name (from action:\\\"list\\\"). Packs are local/free; this confirms it from the actual graph.\",\"type\":\"string\"},\"refresh\":{\"description\":\"action:\\\"generate_skill\\\" — bypass the read-through cache and rebuild the SKILL.md, overwriting the cached entry.\",\"type\":\"boolean\"},\"source\":{\"description\":\"REQUIRED for action:\\\"generate_skill\\\" — a ComfyUI Registry node ID (e.g. 'comfyui-impact-pack') or a GitHub repository URL.\",\"type\":\"string\"},\"workflow\":{\"anyOf\":[{\"type\":\"string\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}],\"description\":\"REQUIRED for action:\\\"extract_deps\\\" and action:\\\"install_deps\\\" — a ComfyUI workflow in API format (JSON string or object).\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"list_packs\"}"},{"name":"list_tools","hash":"7f60c20e8f033cbd9f2d78767052b649488802b291d3c9873e90d1939eb504df","canonical_json":"{\"description\":\"List every comfyui-mcp capability as a token-light catalog: tool names with one-line summaries, grouped by category. Start here. Then use describe_tool to get a tool's parameters and call_tool to run it.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"category\":{\"description\":\"Only list this category (as shown in the catalog headings).\",\"type\":\"string\"},\"search\":{\"description\":\"Case-insensitive substring filter over tool names and descriptions.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"list_tools\"}"},{"name":"model_metadata","hash":"2806897cb32cb3acaf3487fc472ded738852c81c403d8e28a52e0b897bed4b40","canonical_json":"{\"description\":\"Curate a model file's embedded .safetensors metadata (Model Explorer). Driven by the `action` parameter:\\n- action:\\\"read\\\" — Read a model file's CURRENT embedded metadata + evidence, for curating it. Returns classify (asset_type/base/precision/rank), the current model_card and prompt_director namespaces, read-only modelspec, top training tags (ss_tag_frequency), the Civitai description, and example prompts. Call this FIRST when the user wants to improve/curate a model's embedded .safetensors metadata, so you propose from real data. NOTE: this is the embedded-in-the-tensor metadata (model_card/prompt_director/modelspec/ss_*) — NOT the separate lora_catalog. `category` = ComfyUI model folder ('loras','checkpoints','vae',…); `name` = filename incl. .safetensors — BOTH required for read/propose, e.g. {action:\\\"read\\\", category:\\\"loras\\\", name:\\\"my_model.safetensors\\\"}. DEPENDENCY: the curated read proxies the OPTIONAL 'comfyui-model-explorer' custom node. When that node is absent but the model file is reachable on the LOCAL filesystem, the tool does NOT hard-fail — it degrades to a structured 'model_explorer: unavailable' result with local evidence (file stat, the download_model action:\\\"download_civitai\\\" sidecar, and the raw embedded safetensors metadata). Without local filesystem access, it still returns the same structured unavailable result, but without file evidence.\\n- action:\\\"propose\\\" — PROPOSE cleaned embedded metadata into the user's diff-review window. This does NOT write the file — the user sees your proposed fields vs current, edits/discusses, and their Confirm does the write. Call whenever you have a proposal OR the user asks you to revise one; each call REPLACES the live proposal, so send the FULL field set you're proposing. Include only fields you're confident about. Keys: display_name, description_clean, semantic_intent, prompt_guidance, preservation_guidance, trigger_tokens[] (EXACT tokens — never invent), activation_phrases[], negative_tokens[], tags[], compatible_families[], default_strength_model, default_strength_clip, strength_min, strength_max. NEVER write metadata directly.\\n- action:\\\"fetch_civitai\\\" — READ-ONLY: pull this model's data from Civitai (civitai.com) — the rich description, trainedWords, example prompts (with the prompt text used in the sample images), tags, nsfw flag, and source_url — WITHOUT writing anything. Call this when the embedded metadata is thin (empty model_card/prompt_director, no ss_tag_frequency) or to flesh out details before proposing. Treat the result as RAW input: distill the (often marketing-heavy) description, and MINE THE EXAMPLE PROMPTS for the real trigger — the trigger is frequently ONLY in the sample prompts even when trainedWords is EMPTY (e.g. every prompt starting with 'photo in the style of X' means X is the trigger). Adult models (civitai.red) resolve through this same API. Then clean it up and call action:\\\"propose\\\". DEPENDENCY: automatic by-hash lookup uses the OPTIONAL 'comfyui-model-explorer' custom node. If that node isn't installed, pass 'version_id' (the CivitAI modelVersionId) and this action degrades to CivitAI's public REST API directly — no node, no auth. Without both the node AND a version_id it returns a clear 'optional feature unavailable' message rather than enriching.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which metadata operation to perform. All three actions require `category` + `name`; \\\"propose\\\" also requires `fields` (optional `note`); \\\"fetch_civitai\\\" takes an optional `version_id`.\",\"enum\":[\"read\",\"propose\",\"fetch_civitai\"],\"type\":\"string\"},\"category\":{\"description\":\"ComfyUI model folder, e.g. 'loras'. REQUIRED for all three actions.\",\"type\":\"string\"},\"fields\":{\"additionalProperties\":{},\"description\":\"action:\\\"propose\\\" — REQUIRED proposed field map (see description).\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"name\":{\"description\":\"model filename incl. .safetensors. REQUIRED for all three actions.\",\"type\":\"string\"},\"note\":{\"description\":\"action:\\\"propose\\\" — optional one-line note about this revision.\",\"type\":\"string\"},\"version_id\":{\"description\":\"action:\\\"fetch_civitai\\\" — force a specific Civitai modelVersionId if hash lookup misses.\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"model_metadata\"}"},{"name":"node_pack","hash":"29fb41154652a13ef0a54326aa3afa525a712e6131735e537a040dacfa4d2b80","canonical_json":"{\"description\":\"Author, edit, test and publish YOUR OWN ComfyUI custom-node pack under the custom_nodes/ directory the running ComfyUI actually scans. LOCAL-ONLY: it acts on the local filesystem and is meaningless for a remote --comfyui-url target. Every file-touching action (list_files, read, search, write, patch, git) is jailed to custom_nodes/ under the directory the running ComfyUI actually scans — the server's own --base-directory when it reports one (on ComfyUI Desktop that is NOT the code install root), else the live main.py checkout on a split install that has no --base-directory (the data workspace is not scanned unless the flag said so), else COMFYUI_PATH, else the saved default workspace, else the running LOCAL server's own install root; the one exception is action:\\\"publish\\\", which also accepts an explicit `path` to a pack directory ANYWHERE on this machine and therefore works without COMFYUI_PATH. To INSTALL or update someone else's pack use install_custom_node instead. Driven by the `action` parameter:\\n- action:\\\"scaffold\\\" — Generate a new pack from a template into the local ComfyUI's scanned custom_nodes// (the install base resolves from the running server's --base-directory when it reports one, else the live main.py checkout on a split install, else COMFYUI_PATH, else the saved default workspace, else the running LOCAL server this session is connected to). Writes pyproject.toml (with the [tool.comfy] PublisherId/DisplayName/Icon table the Comfy Registry requires), __init__.py exporting NODE_CLASS_MAPPINGS / NODE_DISPLAY_NAME_MAPPINGS, and src/nodes.py containing a runnable sample node (INPUT_TYPES/RETURN_TYPES/FUNCTION/CATEGORY), plus .comfyignore and .gitignore. Optionally emits a web/js frontend stub (wiring WEB_DIRECTORY) and a GitHub Actions publish workflow (with_ci). This is the FIRST step of the author loop: scaffold here, then restart_comfyui to load it, test it, and finally action:\\\"publish\\\". Names must be a safe lowercase slug and cannot escape custom_nodes/; an existing non-empty directory is left untouched unless overwrite is true. Requires `name` and `display_name`.\\n- action:\\\"verify\\\" — Test that a pack actually LOADS in ComfyUI — the middle step of the author loop. Restarts the local ComfyUI and waits for it to become ready, then checks that the pack's node class_types appear in /object_info. A node that fails to import (a missing dependency or a syntax error) simply never registers, so any missing class_types pinpoint a broken pack. Provide `class_types` explicitly, or a pack `name` whose __init__.py declares NODE_CLASS_MAPPINGS (the keys are inferred). Needs a managed local ComfyUI. Set restart:false to check the already-running server without restarting it.\\n- action:\\\"publish\\\" — Publish a local pack to the public Comfy Registry (registry.comfy.org) by running `comfy node publish` inside the pack directory. First validates the pack's pyproject.toml has the required [project].name, [project].version and [tool.comfy].PublisherId (refusing the scaffold placeholder), then publishes using the API key from the REGISTRY_ACCESS_TOKEN environment variable (passed to comfy-cli via the environment, never via logged arguments). This is the LAST step of the author loop and an IRREVERSIBLE, EXTERNAL action: it creates/updates a PUBLIC registry version that this tool cannot undo. Requires comfy-cli installed and REGISTRY_ACCESS_TOKEN set. Give `name` (a folder under custom_nodes/) or `path` (an explicit pack directory).\\n- action:\\\"list_files\\\" — List the files in one installed pack under custom_nodes// (read-only). Skips .git/, __pycache__/ and node_modules/. Use this to orient before action:\\\"read\\\" / action:\\\"search\\\" when diagnosing or editing a pack you found via bisect or install_custom_node (action:\\\"fix\\\"). Requires `pack`.\\n- action:\\\"read\\\" — Read a slice of ONE file inside a pack (read-only), with bounded output so a huge file can't flood the context. Returns the requested line range with a truncation notice when clipped; long lines are chunked. Pair with action:\\\"search\\\" to locate the line, then action:\\\"patch\\\" or action:\\\"write\\\" to change it. Requires `path`.\\n- action:\\\"search\\\" — Regex-search custom-node source under custom_nodes/ (read-only). Uses ripgrep when it's on PATH, otherwise a bounded built-in scanner (skips dot-dirs, __pycache__/node_modules, binary and >1 MiB files). Returns file/line/text matches with per-line and result caps. Use this to find where a node class, import, or error string lives before reading or patching. Requires `query`.\\n- action:\\\"write\\\" — Create or overwrite ONE file inside a pack. Refuses to clobber an existing file unless overwrite is true, and creates parent directories by default. Use for whole-file edits or new files; for surgical edits prefer action:\\\"patch\\\". After writing, run action:\\\"verify\\\" and restart_comfyui to load the change. Requires `path` and `content`.\\n- action:\\\"patch\\\" — Apply a unified diff (---/+++ headers) or an apply-patch / simplified diff (`*** Begin Patch` / `*** Update File`) to custom-node source under custom_nodes/. Every touched path is jail-checked BEFORE any git call, then the patch is validated with `git apply --check` and only applied if the check passes (two-phase; never uses --unsafe-paths). Paths are relative to custom_nodes/ and may carry a/ b/ prefixes; works on non-repo packs too. Ideal for surgical edits located via action:\\\"search\\\". Requires `patch`.\\n- action:\\\"git\\\" — Run a git operation inside one pack, selected by `git_action` (status/diff/log/commit/push). Reads (status/diff/log) are always allowed. Writes (commit/push) require the environment flag COMFYUI_MCP_ALLOW_GIT_WRITES=1 (default OFF) and otherwise return a structured DISABLED_BY_CONFIG refusal so you can self-correct. commit requires a `message` and stages either the given `paths` or all pack changes. This is the final step of the author loop after scaffold → write/patch → verify → restart_comfyui, before action:\\\"publish\\\". Requires `pack` and `git_action`.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which node-pack operation to perform. \\\"scaffold\\\" requires `name` + `display_name`; \\\"list_files\\\" requires `pack`; \\\"read\\\" requires `path`; \\\"search\\\" requires `query`; \\\"write\\\" requires `path` + `content`; \\\"patch\\\" requires `patch`; \\\"git\\\" requires `pack` + `git_action`. \\\"verify\\\" and \\\"publish\\\" have no required parameters — \\\"verify\\\" resolves the pack from `name` (or checks `class_types` directly), \\\"publish\\\" from `name` or `path`.\",\"enum\":[\"scaffold\",\"verify\",\"publish\",\"list_files\",\"read\",\"search\",\"write\",\"patch\",\"git\"],\"type\":\"string\"},\"case_sensitive\":{\"description\":\"action:\\\"search\\\" — match case-sensitively (default false).\",\"type\":\"boolean\"},\"category\":{\"description\":\"action:\\\"scaffold\\\" — node menu category for the sample node (default 'custom').\",\"type\":\"string\"},\"class_types\":{\"description\":\"action:\\\"verify\\\" — explicit NODE_CLASS_MAPPINGS keys to confirm are registered in /object_info. Takes precedence over inferring from `name`.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"content\":{\"description\":\"action:\\\"write\\\" — REQUIRED. Full file contents to write.\",\"type\":\"string\"},\"create_dirs\":{\"description\":\"action:\\\"write\\\" — create missing parent directories (default true).\",\"type\":\"boolean\"},\"description\":{\"description\":\"action:\\\"scaffold\\\" — short description written to pyproject [project].description.\",\"type\":\"string\"},\"display_name\":{\"description\":\"action:\\\"scaffold\\\" — REQUIRED. Human-readable name shown in the ComfyUI node menu and the registry listing.\",\"type\":\"string\"},\"git_action\":{\"description\":\"action:\\\"git\\\" — REQUIRED. Which git operation to run: status/diff/log are read-only; commit/push require COMFYUI_MCP_ALLOW_GIT_WRITES=1. Named `git_action` rather than `action` only because `action` is this tool's dispatch field; the git operation itself is unchanged.\",\"enum\":[\"status\",\"diff\",\"log\",\"commit\",\"push\"],\"type\":\"string\"},\"glob\":{\"description\":\"action:\\\"list_files\\\" — optional glob to filter entries (supports *, **, ?), matched against pack-relative paths. action:\\\"search\\\" — optional glob to restrict which files are searched (e.g. '**/*.py').\",\"type\":\"string\"},\"line_count\":{\"description\":\"action:\\\"read\\\" — number of lines to return (default 240, max 800).\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"max_chars\":{\"description\":\"action:\\\"read\\\" — maximum characters to return (default 12000, min 500, max 24000 — hard clamps; values outside are silently pulled into range). action:\\\"git\\\" — maximum characters of git output to return (default 12000, min 500, max 24000 — hard clamps the runtime applies; values outside are silently pulled into range).\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"max_entries\":{\"description\":\"action:\\\"list_files\\\" — maximum entries to return (default 500, max 2000 — a hard clamp). The walk STOPS at this many, so a capped result is not the pack's full file list.\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"max_results\":{\"description\":\"action:\\\"search\\\" — maximum matches to return (default 50, max 100). The scan STOPS at this many, so a capped result is not a complete match set.\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"message\":{\"description\":\"action:\\\"git\\\" — commit message (required for git_action 'commit').\",\"type\":\"string\"},\"name\":{\"description\":\"Pack folder name under /custom_nodes/. REQUIRED for action:\\\"scaffold\\\" — a safe lowercase slug (letters, digits, hyphens, underscores), e.g. 'my-cool-nodes', which becomes the directory under custom_nodes/ and the pyproject [project].name. For action:\\\"verify\\\", the pack whose __init__.py NODE_CLASS_MAPPINGS keys are inferred and checked when `class_types` is omitted. For action:\\\"publish\\\", the pack folder to publish (give this or `path`).\",\"type\":\"string\"},\"overwrite\":{\"description\":\"action:\\\"scaffold\\\" — overwrite template files in an existing pack directory instead of refusing (default false). action:\\\"write\\\" — overwrite an existing file instead of refusing (default false).\",\"type\":\"boolean\"},\"pack\":{\"description\":\"Pack folder name under custom_nodes/ (e.g. 'ComfyUI-Manager'). REQUIRED for action:\\\"list_files\\\" and action:\\\"git\\\".\",\"type\":\"string\"},\"patch\":{\"description\":\"action:\\\"patch\\\" — REQUIRED. A unified diff (---/+++ headers) or an apply-patch / simplified diff (`*** Begin Patch` / `*** Update File: path`). File headers are read to determine touched paths, which must resolve inside custom_nodes/ (e.g. 'a/MyPack/nodes.py' or 'MyPack/nodes.py').\",\"type\":\"string\"},\"path\":{\"description\":\"REQUIRED for action:\\\"read\\\" and action:\\\"write\\\": a pack-relative path under custom_nodes/, e.g. 'MyPack/nodes.py'. For action:\\\"search\\\", the pack-relative directory to search, or '.' for all packs (default '.'). For action:\\\"publish\\\" ONLY, this is instead an explicit absolute path to the pack directory to publish, and it overrides `name` when both are given.\",\"type\":\"string\"},\"paths\":{\"description\":\"action:\\\"git\\\" — pack-relative paths to stage/scope (jail-checked). Defaults to all pack changes.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"publisher_id\":{\"description\":\"action:\\\"scaffold\\\" — your Comfy Registry publisher id, stamped into [tool.comfy].PublisherId. If omitted a placeholder is written that you must replace before publishing.\",\"type\":\"string\"},\"query\":{\"description\":\"action:\\\"search\\\" — REQUIRED. Regular expression to search for.\",\"type\":\"string\"},\"restart\":{\"description\":\"action:\\\"verify\\\" — restart ComfyUI before checking so newly-added packs load (default true). Set false to check the live server as-is.\",\"type\":\"boolean\"},\"start_line\":{\"description\":\"action:\\\"read\\\" — 1-based line to start at (default 1).\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"with_ci\":{\"description\":\"action:\\\"scaffold\\\" — if true, also generate .github/workflows/publish_action.yml (Comfy-Org/publish-node-action; needs the REGISTRY_ACCESS_TOKEN repo secret) so pushing a pyproject.toml version bump auto-publishes (default false).\",\"type\":\"boolean\"},\"with_frontend\":{\"description\":\"action:\\\"scaffold\\\" — if true, also generate a web/js/.js extension stub and set WEB_DIRECTORY (default false).\",\"type\":\"boolean\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"node_pack\"}"},{"name":"node_snapshot","hash":"904eac33bcd1ed40ca806cba0743b33e9e3812349b1e08187a2b9bd3fb898701","canonical_json":"{\"description\":\"Custom-node snapshots via ComfyUI-Manager (mirrors `comfy node save-snapshot` / `restore-snapshot`). Driven by the `action` parameter:\\n- action:\\\"list\\\" — List the snapshots ComfyUI-Manager knows about. No other parameters. Read-only.\\n- action:\\\"save\\\" — Save the current custom-node and version state. With no `name`, Manager assigns a timestamped snapshot (works against remote instances). Providing `name` writes a custom-named snapshot file, which requires a local ComfyUI install root (COMFYUI_PATH or a saved default workspace — see the workspace tool) and is unavailable against a genuinely remote ComfyUI.\\n- action:\\\"restore\\\" — Restore a previously saved snapshot by `name` (required). ComfyUI-Manager applies the custom-node changes on the next ComfyUI restart; use action:\\\"list\\\" to find available names.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which snapshot operation to perform. \\\"list\\\" takes no other parameters; \\\"save\\\" takes an optional `name`; \\\"restore\\\" requires `name`.\",\"enum\":[\"list\",\"save\",\"restore\"],\"type\":\"string\"},\"name\":{\"description\":\"Snapshot name (no extension, no path separators). REQUIRED for action:\\\"restore\\\" (as shown by action:\\\"list\\\"). OPTIONAL for action:\\\"save\\\" — omit to let ComfyUI-Manager assign a timestamped name. Ignored by action:\\\"list\\\".\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"node_snapshot\"}"},{"name":"queue","hash":"4103079910f798709f3bae3560be8b46c1639a1e7046630ff23497739f1446b5","canonical_json":"{\"description\":\"Inspect and manage the ComfyUI execution queue. Driven by the `action` parameter:\\n- action:\\\"list\\\" — The job running now plus all pending jobs, each with its prompt_id and position. Read-only; requires a reachable ComfyUI server (works against local or remote --comfyui-url). Omits queued workflow payloads by default to keep output small; set include_workflows:true when you need to inspect or edit the exact pending payload. Use this before action:\\\"cancel\\\" (running), action:\\\"cancel_queued\\\"/action:\\\"clear\\\" (pending), action:\\\"move\\\", or action:\\\"edit\\\".\\n- action:\\\"status\\\" — Check ONE job by its prompt_id (the id returned by enqueue_workflow). Queries the connected ComfyUI server; requires it to be running. Returns JSON with running, pending, and done booleans, plus optional status_str, error details, and execution_stats from ComfyUI history once the job is done. If the prompt is neither running nor queued AND /history has no record of it (a restart wipes both), it returns done:false + found:false with an explanatory message — a prompt ComfyUI never executed is NOT a completion, so do not wait for its outputs. Also returns text_outputs when the workflow contained text-preview nodes (Preview as Text, ShowText, …) — those produce no image file, so this is the ONLY way to read their result; report that text back to the user. Use action:\\\"list\\\" to see the whole queue at once, and get_history for full output filenames.\\n- action:\\\"get_workflow\\\" — The full workflow payload for one PENDING queue item by prompt_id. Read-only. Does not work for the currently running job because ComfyUI cannot safely edit a job after execution starts.\\n- action:\\\"move\\\" — Move a PENDING queue item to the front or back by removing it and re-enqueuing its saved workflow payload; `position` (\\\"front\\\"|\\\"back\\\") is required. The job receives a NEW prompt_id; the old prompt_id is removed. Running jobs cannot be moved.\\n- action:\\\"edit\\\" — Edit a PENDING queue item by removing it and re-enqueuing an updated workflow. Provide either a complete replacement `workflow` or `node_inputs` patches keyed by node id; `position` selects where to requeue (default back). The job receives a NEW prompt_id; the old prompt_id is removed. Running jobs cannot be edited.\\n- action:\\\"cancel\\\" — Stop the CURRENTLY RUNNING job ROBUSTLY. Sends an interrupt, then WAITS and verifies the job actually stopped — ComfyUI only honors interrupts BETWEEN steps, so a long single step (e.g. a high-res video sampler) can ignore a plain cancel. If the interrupt isn't honored it escalates to freeing VRAM (POST /free) and re-checks; if it STILL won't die it reports the job as WEDGED and tells you to restart_comfyui (an HTTP cancel cannot kill a stuck step). Set clear_pending:true to also drop ALL pending jobs in the same call — the correct \\\"reset the queue\\\" action, since cancelling alone leaves pending jobs that would run next. The partial result is discarded. With `prompt_id` given, only interrupts the running job when its prompt_id matches; omit to interrupt whatever is currently running. Use action:\\\"cancel_queued\\\" to remove one specific PENDING job instead.\\n- action:\\\"cancel_queued\\\" — Remove one specific PENDING job from the queue by prompt_id, then VERIFY the removal against a live /queue read on both sides of it. Only PENDING jobs can be removed this way: ComfyUI silently ignores the request for a job it has already started, so if the job won the race and is now RUNNING this reports isError and tells you the outputs will still be delivered — use action:\\\"cancel\\\" to interrupt that. Also reports isError when the prompt_id was not in the queue at all (it already finished, or was never queued) rather than calling that a removal.\\n- action:\\\"clear\\\" — Clear ALL pending jobs from the queue. Does not affect the currently running job.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which queue operation to perform. \\\"list\\\" and \\\"clear\\\" take no other parameters; \\\"status\\\", \\\"get_workflow\\\" and \\\"cancel_queued\\\" require `prompt_id`; \\\"move\\\" requires `prompt_id` + `position`; \\\"edit\\\" requires `prompt_id` (optional `workflow`/`node_inputs`/`position`); \\\"cancel\\\" takes an optional `prompt_id` and `clear_pending`.\",\"enum\":[\"list\",\"status\",\"get_workflow\",\"move\",\"edit\",\"cancel\",\"cancel_queued\",\"clear\"],\"type\":\"string\"},\"clear_pending\":{\"description\":\"action:\\\"cancel\\\" — also clear ALL pending jobs (recommended when resetting after a stuck/slow render, so a re-queue doesn't stack behind a backlog). Default false.\",\"type\":\"boolean\"},\"include_workflows\":{\"description\":\"action:\\\"list\\\" — include each running/pending job's workflow payload and extra_data. Can be large.\",\"type\":\"boolean\"},\"node_inputs\":{\"additionalProperties\":{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"description\":\"action:\\\"edit\\\" — optional input patches keyed by node id, e.g. {\\\"3\\\":{\\\"steps\\\":30,\\\"cfg\\\":7}}.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"position\":{\"description\":\"Where to requeue the job. REQUIRED for action:\\\"move\\\". OPTIONAL for action:\\\"edit\\\" — defaults to back.\",\"enum\":[\"front\",\"back\"],\"type\":\"string\"},\"prompt_id\":{\"description\":\"The prompt_id of a job (the id returned by enqueue_workflow). REQUIRED for actions \\\"status\\\", \\\"get_workflow\\\", \\\"move\\\", \\\"edit\\\" and \\\"cancel_queued\\\" (a PENDING queue item for all but \\\"status\\\"). OPTIONAL for action:\\\"cancel\\\" — if given, only interrupts the running job when its prompt_id matches; omit to interrupt whatever is currently running.\",\"type\":\"string\"},\"workflow\":{\"additionalProperties\":{},\"description\":\"action:\\\"edit\\\" — optional complete replacement API-format workflow. If omitted, the existing queued workflow is patched with `node_inputs`.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"queue\"}"},{"name":"report_issue","hash":"a721bdfc4e4d293d0ac1705291d3b2cc6cbbb97d70f5cd2684d0ef54edcb55ad","canonical_json":"{\"description\":\"File or triage a GitHub issue for a bug/problem you hit (ComfyUI, a workflow, a model, custom nodes, or comfyui-mcp/its panel). For OUR repos (artokun/comfyui-mcp, artokun/comfyui-mcp-panel) it sends the report to the AI triage worker, which searches existing OPEN and CLOSED issues, version-matches, and either files a new issue, adds context to an existing one, or — if the problem was already FIXED in a newer version than the user runs — answers with the fixing PR + fixed-in version and a recommendation to upgrade (no new issue). It returns that triage result plus an instant check of whether the user is on the latest versions. TIMING: this call BLOCKS while the triage runs — typically a few minutes — and that wait is normal, not a hang. It always returns eventually (every request is time-capped and the poll budget is bounded); on a failing network the caps make that wait longer, but never indefinite. Do not abort a slow call just to retry it: once the worker has accepted the report it keeps triaging on its own — filing, deduping into an existing issue, advising an upgrade, or (rarely) reporting that it could not file — so a blind retry can double-file. If triage outlasts the polling budget the call still returns, with pending:true (and a job_id when the worker gave one — an accepted submit whose acknowledgement was unreadable returns pending without it). If the worker is unreachable it falls back to a prefilled GitHub 'new issue' URL. For third-party repos it returns a prefilled URL to SHARE (it does not auto-file). ALWAYS pass mcp_version and panel_version from the known environment (the env line in your context, e.g. 'mcp=… panel=…') so the worker can tell the user if simply upgrading fixes it — the single most common resolution. Surface the worker's agent_message / upgrade advice to the user.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"body\":{\"description\":\"Issue body: what happened, steps to reproduce, the exact error text, and environment (GPU/VRAM, ComfyUI version, ComfyUI FRONTEND version, OS) if known. The FRONTEND version is a SEPARATE package from ComfyUI and they move independently — get_system_stats (action:\\\"health\\\") prints both, and for any panel/UI bug it is often the deciding variable. Scrub secrets first.\",\"minLength\":1,\"type\":\"string\"},\"labels\":{\"description\":\"Optional GitHub label names to prefill.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"mcp_version\":{\"description\":\"The running comfyui-mcp version (from the env line in your context). Auto-detected if omitted.\",\"type\":\"string\"},\"no_file\":{\"description\":\"Force the prefilled-URL path even for our repos (skip the Worker). Rarely needed.\",\"type\":\"boolean\"},\"panel_version\":{\"description\":\"The running comfyui-mcp-panel (sidebar) version, from the env line in your context, if known.\",\"type\":\"string\"},\"repo\":{\"description\":\"owner/repo (default 'artokun/comfyui-mcp'; use 'artokun/comfyui-mcp-panel' for the sidebar panel).\",\"type\":\"string\"},\"title\":{\"description\":\"Short, specific issue title.\",\"minLength\":1,\"type\":\"string\"}},\"required\":[\"title\",\"body\"],\"type\":\"object\"},\"name\":\"report_issue\"}"},{"name":"restart_comfyui","hash":"827d9d58b498de850ff5a8eeeaac5490f167048b232bc0961599fe2a36c6d4c9","canonical_json":"{\"description\":\"Control the lifecycle of the ComfyUI server process. Driven by the `action` parameter:\\n- action:\\\"restart\\\" — Restart ComfyUI: stops the running process (capturing its config), waits for the port to free, relaunches with the same arguments, and polls the API for bounded readiness. Also works against a REMOTE/tunnelled ComfyUI (via --comfyui-url) by rebooting through ComfyUI-Manager over HTTP and polling for it to come back (requires ComfyUI-Manager present and its security level permitting the reboot). When COMFYUI_RESTART_COMMAND is set, a LOCAL restart runs that command instead of kill+relaunch — the recovery path for an externally managed install (a container, a systemd unit, a launcher) whose launch path cannot be proven from here. This is the normal way to reload newly installed custom nodes, and the escalation when queue (action:\\\"cancel\\\") reports a job WEDGED.\\n- action:\\\"start\\\" — Start ComfyUI using process info saved from a previous action:\\\"stop\\\" call. Supports both Desktop app and manual Python installs. Polls the API for bounded readiness before reporting ready. Local installs only.\\n- action:\\\"stop\\\" — Stop the running ComfyUI process. Captures process info so it can be restarted with action:\\\"start\\\". Kills the process tree and resets the WebSocket client. Local installs only. Anything queued or rendering is lost.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which process operation to perform. None of them takes any other parameter. \\\"restart\\\" stops and relaunches in one call (and is the only action that also works against a remote/tunnelled ComfyUI); \\\"start\\\" relaunches from the info a previous \\\"stop\\\" saved; \\\"stop\\\" kills the running process tree.\",\"enum\":[\"restart\",\"start\",\"stop\"],\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"restart_comfyui\"}"},{"name":"runpod","hash":"41019f356692a58d139301562d0fc149cf79f30aa393dd9c6648ef32327b1623","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"idempotentHint\":false,\"openWorldHint\":true},\"description\":\"Deploy, start, stop, inspect and connect to RunPod cloud GPU pods, and switch rendering between your local machine and a pod. Driven by the `action` parameter. SPENDS MONEY: action:\\\"create\\\" and action:\\\"start\\\" put a pod into a billing state; action:\\\"stop\\\" ends GPU billing. Confirm with the user before creating or starting a pod, and stop pods when the work is done.\\n- action:\\\"create\\\" — Deploy a BRAND-NEW RunPod pod from our comfyui-mcp template (image with the panel + Manager + our nodes preinstalled), then it can be started/connected like any pod. One-tap alternative to the console deploy link for a user who already has a RunPod account + API key. Because our template is used, the agent can install the user's exact custom nodes/LoRAs + download models on it → full canvas parity. Tries several GPU types until one has capacity (on-demand availability fluctuates). NOTE: this bills GPU-time as soon as the pod boots — confirm with the user first, and stop it (action:\\\"stop\\\") when done. Created pods carry a DEAD-MAN SWITCH: if comfyui-mcp stops minding the pod (crash/offline), the pod STOPS ITSELF after a grace period so it can't bill forever — it uses the pod-scoped key RunPod auto-injects, so your account key never leaves this machine (disable with deadman:false). For onboarding a NEW RunPod user, prefer action:\\\"deploy_link\\\" so their signup credits our referral.\\n- action:\\\"start\\\" — Start (resume) a stopped/exited RunPod pod by ID — RunPod re-attaches a GPU and boots the container (billing resumes). Returns immediately once RunPod accepts the resume; the pod then takes ~30-90s to become reachable, so follow with action:\\\"status\\\" (or action:\\\"connect\\\", which verifies readiness) rather than assuming it's instantly up. If RunPod can't allocate the requested GPU it errors — try a different gpu_count or GPU type in the console.\\n- action:\\\"stop\\\" — Stop a running RunPod pod by ID — releases the GPU and stops GPU-time billing while KEEPING the pod and its disk (so you can start it again later). Use when the user is done rendering. Does NOT terminate/delete the pod (that's a console action). Confirm with the user before stopping a pod that has work in progress.\\n- action:\\\"status\\\" — Get the live state of a pod by ID: its desired status (RUNNING / EXITED / TERMINATED), GPU, uptime, $/hr cost, GPU/VRAM utilization, and — when it's running and exposes ComfyUI — the proxy URL to connect to. Call this first to see what state a pod is in before starting/stopping/connecting. Read-only.\\n- action:\\\"list\\\" — List all RunPod pods on the account (id, name, status, GPU, cost). Use when the user hasn't given a pod ID, or to find the one they mean. If the account has no pods, tell the user to create one and share action:\\\"deploy_link\\\". Read-only.\\n- action:\\\"connect\\\" — Connect comfyui-mcp to a pod's ComfyUI so ALL the other comfyui tools (generate, workflows, models, panel, …) run against that pod. Give it a pod ID: it verifies the pod is RUNNING with ComfyUI reachable, resolves the pod's proxy URL, and retargets this orchestrator's ComfyUI client to it. If the pod isn't ready it tells you what's missing (run action:\\\"start\\\" / runpod_watch action:\\\"troubleshoot\\\" first). This is the 'live connection' — after it succeeds, the rest of the session talks to the pod.\\n- action:\\\"use_local\\\" — Switch comfyui-mcp back to the LOCAL ComfyUI on this machine (the 'Local' half of the local⇄pod switch) — retargets rendering to loopback so generate/workflows run on the local GPU again. Stops broadcasting the pod's status but does NOT stop the pod itself (use action:\\\"stop\\\" to end billing). Use when the user wants to render locally again after working on a pod.\\n- action:\\\"deploy_link\\\" — Get the RunPod DEPLOY link for spinning up a NEW comfyui-mcp pod. Share this with the user whenever they have no pod, or want to create one — it opens RunPod pre-configured with our template AND carries our referral code, so their signup/spend credits us. Prefer handing over THIS link for pod creation (rather than describing the console steps), so the referral attaches. Read-only.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which RunPod operation to perform. \\\"start\\\", \\\"stop\\\", \\\"status\\\" and \\\"connect\\\" require `pod_id`; \\\"create\\\" takes the optional deploy parameters (name/gpu_type/cloud_type/connect/deadman); \\\"list\\\", \\\"use_local\\\" and \\\"deploy_link\\\" take no other parameters. \\\"create\\\" and \\\"start\\\" BILL; \\\"stop\\\" ends billing.\",\"enum\":[\"create\",\"start\",\"stop\",\"status\",\"list\",\"connect\",\"use_local\",\"deploy_link\"],\"type\":\"string\"},\"cloud_type\":{\"description\":\"action:\\\"create\\\" — COMMUNITY (cheaper, default) or SECURE.\",\"enum\":[\"COMMUNITY\",\"SECURE\"],\"type\":\"string\"},\"connect\":{\"description\":\"action:\\\"create\\\" — auto-connect when booted: the ORCHESTRATOR waits for ComfyUI to answer (1-3min), then retargets + watches — this call returns immediately (default false: deploy only; connect later with action:\\\"connect\\\"). This is the create-time flag, NOT the action of the same name.\",\"type\":\"boolean\"},\"deadman\":{\"description\":\"action:\\\"create\\\" — arm the pod-side dead-man watchdog (default true for OUR stock template): the pod STOPS ITSELF if comfyui-mcp's heartbeats stop (process crash/offline — boot grace ~45min, then ~20min without beats). Uses the pod-scoped API key RunPod auto-injects into every pod — your account key never leaves this machine. false deploys without the watchdog. With a custom template (RUNPOD_TEMPLATE_ID) the default is OFF — pass true only if that image ships our watchdog.\",\"type\":\"boolean\"},\"gpu_count\":{\"description\":\"action:\\\"start\\\" — GPUs to attach on resume (default 1).\",\"maximum\":8,\"minimum\":1,\"type\":\"integer\"},\"gpu_type\":{\"description\":\"action:\\\"create\\\" — GPU type to prefer, e.g. \\\"NVIDIA GeForce RTX 4090\\\". Default tries: NVIDIA GeForce RTX 4090, NVIDIA RTX A6000, NVIDIA RTX PRO 4500 Blackwell, NVIDIA A40, NVIDIA RTX A5000.\",\"type\":\"string\"},\"name\":{\"description\":\"action:\\\"create\\\" — pod name (default 'comfyui-mcp').\",\"type\":\"string\"},\"pod_id\":{\"description\":\"The RunPod pod ID (from console.runpod.io, or action:\\\"list\\\"). REQUIRED for actions \\\"start\\\", \\\"stop\\\", \\\"status\\\" and \\\"connect\\\". Ignored by \\\"create\\\", \\\"list\\\", \\\"use_local\\\" and \\\"deploy_link\\\".\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"runpod\"}"},{"name":"runpod_watch","hash":"3f543ae39b1ad2e1d62f0803c5d0fa489c4f582e09240a03cf22004b49e66852","canonical_json":"{\"description\":\"Watch a RunPod pod's live status in the control panel, stop watching it, or diagnose why it isn't usable. Driven by the `action` parameter. None of these actions DEPLOYS or resumes a pod — the runpod tool does that. One of them CAN stop one, though: action:\\\"watch\\\" arms the idle auto-stop, so a watched pod whose ComfyUI sits idle past the configured timeout is stopped to save cost. Do not watch a pod that is deliberately idle but must stay up.\\n- action:\\\"watch\\\" — Start broadcasting a pod's LIVE status to the control panel (desktop + mobile) — status, GPU/VRAM utilization, uptime, $/hr, and an idle-auto-stop countdown — refreshed every ~15s. runpod action:\\\"connect\\\" already starts this for the pod it connects to; call this to watch a pod WITHOUT retargeting comfyui-mcp at it (e.g. monitor a pod that's still booting). While watched, if the pod's ComfyUI sits idle past the configured timeout it is auto-stopped to save cost.\\n- action:\\\"unwatch\\\" — Stop broadcasting a pod's live status to the control panel (does NOT stop the pod itself — use runpod action:\\\"stop\\\" for that). Also disables idle auto-stop for it.\\n- action:\\\"troubleshoot\\\" — Diagnose why a RunPod pod isn't usable — call this when the pod 'won't connect', ComfyUI is unreachable, or a render can't reach the pod. Checks: does the pod exist, is it RUNNING (vs stopped/exited — then start it), is a GPU attached, is ComfyUI's port exposed as an HTTP proxy port, and does ComfyUI actually ANSWER at its proxy URL (probes /system_stats). Returns the specific blocker and the next step. Read-only.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which watch operation to perform. \\\"watch\\\" and \\\"troubleshoot\\\" require `pod_id`; \\\"unwatch\\\" takes no other parameters (it clears whichever pod is currently watched).\",\"enum\":[\"watch\",\"unwatch\",\"troubleshoot\"],\"type\":\"string\"},\"pod_id\":{\"description\":\"The RunPod pod ID. REQUIRED for actions \\\"watch\\\" and \\\"troubleshoot\\\". Ignored by \\\"unwatch\\\", which clears the single currently watched pod.\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"runpod_watch\"}"},{"name":"save_workflow","hash":"b586fc06bf40db0c2d8695017b0a598558e9c90863cee722d85b9c8044499688","canonical_json":"{\"description\":\"WRITE to the ComfyUI user library: persist a workflow, or capture/verify its provenance lock. This is the only tool here that writes — reading is get_workflow. Driven by the `action` parameter:\\n- action:\\\"save\\\" — Save a workflow JSON to the connected ComfyUI server's user library so it appears in the ComfyUI web UI. Requires a running ComfyUI server; this writes to that server's userdata and OVERWRITES any existing file with the same filename without confirmation. Web-UI-format JSON ({ nodes: [], links: [] }) is saved as-is and is the preferred input — when re-saving an existing workflow, load it with get_workflow (action:\\\"get\\\", format='ui') and modify THAT. API-format graphs ({ '1': { class_type, inputs } }) are AUTO-CONVERTED to Web UI format with a generated layout so the saved file always opens in the ComfyUI canvas (the canvas cannot open raw API format). Returns a confirmation message (noting the conversion and any warnings), or the HTTP status and error text on failure.\\n- action:\\\"lock\\\" — Capture a provenance lock for a saved workflow so it can be exactly reproduced later. Walks the workflow's model loaders (CheckpointLoaderSimple, UNETLoader, VAELoader, LoraLoader, ControlNetLoader, etc.), SHA-256s every referenced model file, records the git commit currently checked out for every custom node pack the workflow's class_types come from, and captures ComfyUI's reported version. WRITES `.lock.json` next to the workflow in ComfyUI's user library. Requires local filesystem access: models resolve from the data/model roots, and pack commits inspect custom_nodes on the live --base-directory / COMFYUI_PATH data root (not COMFYUI_CODE_PATH). Pair with action:\\\"verify_lock\\\" later to detect drift.\\n- action:\\\"verify_lock\\\" — Compare a saved workflow's lock file against the current state of the local install and report drift. Loads `.lock.json`, re-computes a current lock from the same workflow, and diffs: which models have a different SHA-256, which custom node packs are on a different commit, whether ComfyUI's version changed. Use before re-running an important workflow days or weeks later to confirm it'll behave the same. Supports split local installs (models and packs stay on the data/base root). Read-only; returns a structured drift report (empty arrays everywhere mean perfect parity).\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which write/provenance operation to perform. All three require `filename`; \\\"save\\\" also requires `workflow`.\",\"enum\":[\"save\",\"lock\",\"verify_lock\"],\"type\":\"string\"},\"filename\":{\"description\":\"Workflow filename in the ComfyUI user library (e.g. 'my_workflow.json'). REQUIRED for every action. For action:\\\"save\\\" this OVERWRITES an existing file of the same name; for \\\"lock\\\"/\\\"verify_lock\\\" the lock is read/written as '.lock.json' alongside it.\",\"type\":\"string\"},\"workflow\":{\"additionalProperties\":{},\"description\":\"action:\\\"save\\\" (REQUIRED) — Workflow JSON to save. Web UI format ({ nodes: [], links: [] }) is stored verbatim; API format ({ '1': { class_type, inputs } }) is auto-converted to Web UI format (generated layout) so it stays openable in ComfyUI's canvas. Not validated against the server before saving.\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"save_workflow\"}"},{"name":"search_custom_nodes","hash":"e666874b48b477e6b6d6aa84b5aa2c619bb34622f5252314c8238060be1ffa31","canonical_json":"{\"description\":\"Discover ComfyUI custom node PACKS in the public ComfyUI Registry (registry.comfy.org). Read-only and network-only: queries the hosted registry over HTTP and does NOT require a running ComfyUI or COMFYUI_PATH. This searches node PACKS, not models (use download_model action:\\\"search\\\") and not local installs (use list_local_models action:\\\"list\\\"). To actually install what you find, or to manage packs already installed, use install_custom_node. Driven by the `action` parameter:\\n- action:\\\"search\\\" — Search by keyword; `query` required. Returns a ranked list of packs with id, name, author, install count, and latest version. The keyword search ranks a fixed window of packs client-side, so when it matches nothing the query is also tried as an exact registry id automatically (e.g. 'comfyui kjnodes' → 'comfyui-kjnodes'). Pass a returned id to action:\\\"details\\\" for full info, or to install_custom_node (action:\\\"install\\\").\\n- action:\\\"details\\\" — Full details for ONE pack by its exact registry id: description, author, license, repository, install count, latest version, the node types it provides, and recent version changelogs. Look up the id via action:\\\"search\\\" first.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which registry lookup to perform. \\\"search\\\" requires `query` (and takes optional `limit`/`page`); \\\"details\\\" requires `id`.\",\"enum\":[\"search\",\"details\"],\"type\":\"string\"},\"id\":{\"description\":\"action:\\\"details\\\" — REQUIRED. Exact registry pack id (the 'id' field from action:\\\"search\\\"), e.g. 'comfyui-impact-pack'.\",\"type\":\"string\"},\"limit\":{\"description\":\"action:\\\"search\\\" — max results to return (default 10).\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"page\":{\"description\":\"action:\\\"search\\\" — page number for pagination (default 1).\",\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"query\":{\"description\":\"action:\\\"search\\\" — REQUIRED. Keyword(s) to match against pack name/description, e.g. 'impact', 'controlnet aux'.\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"search_custom_nodes\"}"},{"name":"train_doctor","hash":"ba61a88ff8ede545079b20d71874a6f5b2fc06bb85f46b144f72a8c2191b788e","canonical_json":"{\"description\":\"Preflight and set up the TRAINER ITSELF — the docker/GPU/venv machinery every training job needs. Touches no dataset and no job. Driven by the `action` parameter:\\n- action:\\\"doctor\\\" — Preflight the local trainer: docker daemon reachable, `--gpus all` GPU passthrough working (NVIDIA Container Toolkit), trainer image built. Read-only, takes no other parameters. Returns per-check booleans + setup hints. Also reports the training data root and whether HF_TOKEN is set (needed to download FLUX.1-dev on first run), the native (dockerless) bootstrap status, and the connected pod. Run this first when a training start fails.\\n- action:\\\"bootstrap\\\" — Set up the NATIVE (dockerless) trainer on this machine (`target` 'local', the default) or on a pod (`target` 'pod', optional `pod_id`): clone ai-toolkit at the pinned commit, create its venv, install torch + requirements. One-time per machine/pod (~10 min fresh, idempotent; a pod's /workspace persists it across restarts). Needed before a target 'pod' train_start on a fresh pod (no docker there). Long-running.\\n- action:\\\"build_image\\\" — Build the headless GPU trainer image (comfyui-mcp-trainer:latest) from docker/trainer/Dockerfile — one-time, several minutes (CUDA + torch + ai-toolkit). Requires a reachable docker daemon. `aiToolkitRef` pins the ai-toolkit commit/tag for reproducibility. The docker alternative to action:\\\"bootstrap\\\".\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which trainer-setup operation to perform. \\\"doctor\\\" is read-only and takes no other parameters; \\\"bootstrap\\\" takes `target` (+ `pod_id` for target 'pod'); \\\"build_image\\\" takes an optional `aiToolkitRef`. None of them touches a dataset or a job.\",\"enum\":[\"doctor\",\"bootstrap\",\"build_image\"],\"type\":\"string\"},\"aiToolkitRef\":{\"description\":\"action:\\\"build_image\\\" — ai-toolkit git ref (commit/tag) to build against. Default: the Dockerfile's pinned ref.\",\"type\":\"string\"},\"pod_id\":{\"description\":\"action:\\\"bootstrap\\\" — pod to bootstrap (target 'pod'). Default: the connected pod.\",\"type\":\"string\"},\"target\":{\"default\":\"local\",\"description\":\"action:\\\"bootstrap\\\" — where to install the native trainer. Default local.\",\"enum\":[\"local\",\"pod\"],\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"train_doctor\"}"},{"name":"train_prepare_dataset","hash":"2dd772c2957ee51a5e0a44336d872e10cf3a18ce290ccb3e1f22af91055159df","canonical_json":"{\"description\":\"Stage and curate the training DATASETS a LoRA run consumes — the images and their captions. Datasets are keyed by `name`; the jobs that train on them live in the separate `train_start` tool and are keyed by `id`. Driven by the `action` parameter:\\n- action:\\\"prepare\\\" — Stage training images + captions into a dataset dir the trainer consumes. Each item is an image (absolute `path`, OR a ComfyUI `ref` {filename,subfolder?,type?} resolved against the connected ComfyUI's output/input dirs — how phone/panel pickers hand over selections) with an optional caption (a missing caption falls back to defaultCaption — typically the trigger word). Requires `name` + `items`. Returns the datasetPath to pass to train_start (action:\\\"start\\\"). Character LoRA guidance: 10-30 varied images; caption what changes between images, keep the trigger word constant.\\n- action:\\\"list\\\" — List staged datasets, newest-first, with image/caption counts. Read-only, takes no other parameters. Pair with action:\\\"detail\\\" to see one dataset's images + captions.\\n- action:\\\"detail\\\" — Show ONE staged dataset by `name`: its dir (datasetPath — reusable as train_start's datasetPath) and every image with its caption (null when uncaptioned). Images render via action:\\\"file\\\". Read-only.\\n- action:\\\"update\\\" — Edit a staged dataset by `name`: set/replace per-image captions (`setCaptions`) and/or delete individual images with their caption files (`deleteImages`). Refuses while a running/queued job trains from it. Returns per-file warnings for unknown files. This is the SURGICAL edit — it removes only the filenames you list, leaving the dataset itself in place.\\n- action:\\\"delete\\\" — DESTROY a whole staged DATASET by `name`: every image and every caption under it. Irreversible, and the images are typically hand-curated and unrecoverable — confirm with the user first. Refuses while a running/queued job trains from it. THIS DELETES A DATASET, NOT A TRAINING JOB: to delete a finished job's record and checkpoints use the separate `train_start` tool with action:\\\"delete\\\", which is keyed by `id` rather than `name`. To remove only SOME images, use action:\\\"update\\\" with `deleteImages`.\\n- action:\\\"file\\\" — Fetch an image under the training root (dataset image, job sample) by absolute `path` as an inline image — the tunnel-safe way for a phone/panel to render training files it can't reach over /view. Bounded: image files only, ≤ 2MB.\\n- action:\\\"caption_image\\\" — Caption ONE image by absolute `path` with the user's own Claude subscription (one vision turn through the Agent SDK — not a paid API). Returns the bare caption and does NOT write it — review, then save with action:\\\"update\\\", or use action:\\\"caption_dataset\\\" to write directly. Optional `guide` steers the style; optional `trigger` is prepended by the model.\\n- action:\\\"caption_dataset\\\" — Caption a whole staged dataset by `name` (or the `only` subset) with the user's own Claude subscription and WRITE the captions into its .txt files (one vision turn per image, sequential). Captioning ALWAYS runs through Claude (Agent SDK) regardless of the panel's active backend, so it needs a logged-in Claude Code session (or ANTHROPIC_API_KEY). Use after gathering images, before train_start (action:\\\"start\\\"). Per-file transient failures are reported without stopping the batch, but a persistent auth/credential failure stops immediately with an actionable error rather than failing every image. Optional `guide` steers all captions; optional `trigger` is prepended to each.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which dataset operation to perform. \\\"list\\\" takes no other parameters; \\\"prepare\\\" requires `name` + `items`; \\\"detail\\\", \\\"update\\\", \\\"delete\\\" and \\\"caption_dataset\\\" require `name`; \\\"file\\\" and \\\"caption_image\\\" require `path`. NOTE \\\"delete\\\" here destroys a DATASET (images + captions) — deleting a training JOB is train_start action:\\\"delete\\\".\",\"enum\":[\"prepare\",\"list\",\"detail\",\"update\",\"delete\",\"file\",\"caption_image\",\"caption_dataset\"],\"type\":\"string\"},\"defaultCaption\":{\"description\":\"action:\\\"prepare\\\" — fallback caption for items without one; usually the trigger word.\",\"type\":\"string\"},\"deleteImages\":{\"description\":\"action:\\\"update\\\" — image filenames to delete from the dataset (caption files go too). Removes only these files; action:\\\"delete\\\" removes the whole dataset.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"guide\":{\"description\":\"actions \\\"caption_image\\\"/\\\"caption_dataset\\\" — extra style guidance for the captioner (e.g. 'focus on outfits and backgrounds').\",\"type\":\"string\"},\"items\":{\"description\":\"action:\\\"prepare\\\" — the images to stage. REQUIRED for that action.\",\"items\":{\"properties\":{\"caption\":{\"description\":\"Caption for this image.\",\"type\":\"string\"},\"path\":{\"description\":\"Absolute path to a source image (png/jpg/jpeg/webp).\",\"minLength\":1,\"type\":\"string\"},\"ref\":{\"description\":\"ComfyUI file ref (e.g. from get_image (action:\\\"list_outputs\\\") format:json) — resolved server-side with containment checks. Give path OR ref.\",\"properties\":{\"filename\":{\"description\":\"Basename only — no path separators.\",\"minLength\":1,\"type\":\"string\"},\"subfolder\":{\"description\":\"Subfolder under the root (default top level).\",\"type\":\"string\"},\"type\":{\"default\":\"output\",\"description\":\"Which ComfyUI dir to resolve against (default output).\",\"enum\":[\"output\",\"input\"],\"type\":\"string\"}},\"required\":[\"filename\"],\"type\":\"object\"}},\"type\":\"object\"},\"minItems\":1,\"type\":\"array\"},\"name\":{\"description\":\"Dataset name — the staging dir name. REQUIRED for actions \\\"prepare\\\" (it is created), \\\"detail\\\", \\\"update\\\", \\\"delete\\\" and \\\"caption_dataset\\\" (from action:\\\"list\\\"). This is a DATASET name, never a training job id.\",\"minLength\":1,\"type\":\"string\"},\"only\":{\"description\":\"action:\\\"caption_dataset\\\" — subset of filenames to caption (default: all images).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"path\":{\"description\":\"Absolute path of a file under the training root. REQUIRED for action:\\\"file\\\" (a dataset image or job sample, from action:\\\"detail\\\"'s datasetPath or train_start action:\\\"status\\\"'s samples) and for action:\\\"caption_image\\\" (the image to caption).\",\"minLength\":1,\"type\":\"string\"},\"setCaptions\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"action:\\\"update\\\" — {filename: caption} pairs to write (replaces existing captions).\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"trigger\":{\"description\":\"actions \\\"caption_image\\\"/\\\"caption_dataset\\\" — trigger word to prepend to the caption(s).\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"train_prepare_dataset\"}"},{"name":"train_start","hash":"34fd689dc3bafbaefcba33df1d6de53f17939c54dbbd032e33c546994620baa0","canonical_json":"{\"description\":\"Run and inspect LoRA training JOBS — launch a run, poll it, stop it, delete it, and read back the settings behind it. Jobs are keyed by `id`; the datasets they train on live in the separate `train_prepare_dataset` tool and are keyed by `name`. Driven by the `action` parameter:\\n- action:\\\"start\\\" — Start a LoRA training job: target 'local' builds the config and launches the GPU trainer container (docker run --gpus all); target 'pod' ssh-drives pod-native training on a connected RunPod pod (pod_id, or the connector's currently connected pod). Requires `name` + `datasetPath`. Returns a job id for action:\\\"status\\\"/action:\\\"cancel\\\". Long-running — returns immediately; poll action:\\\"status\\\". On completion the LoRA is delivered per deliverTo (pod/local/both) and cataloged when local. Run train_doctor first if unsure the image/docker/GPU (local) or bootstrap (pod) are ready.\\n- action:\\\"status\\\" — Check training progress: pass an `id` for one job (step/total, loss, recent samples, log tail, result paths when done) or OMIT `id` for all jobs newest-first. Read-only.\\n- action:\\\"cancel\\\" — STOP a RUNNING job (docker stop) by `id` and mark it cancelled. Nothing is erased: checkpoints already saved stay in the job's output dir; no LoRA is handed off to models/loras, so the run can be inspected afterwards. Returns ok:false when the container could not be confirmed stopped (the job reverts to running). This is the RECOVERABLE stop — use action:\\\"delete\\\" only when you also want the artifacts gone.\\n- action:\\\"delete\\\" — DESTROY a finished job by `id`: its record AND its output dir with checkpoints/samples, unless keep_outputs is true. Irreversible — confirm with the user first. The delivered LoRA in models/loras is NOT removed. Running/queued jobs must be cancelled first (action:\\\"cancel\\\"). THIS DELETES A JOB, NOT A DATASET: to delete the staged images and captions a run consumed use the separate `train_prepare_dataset` tool with action:\\\"delete\\\", which is keyed by `name` rather than `id`.\\n- action:\\\"list_flows\\\" — List the LoRA training flows and base models the local trainer supports (phase 1: character LoRA on FLUX.1-dev), with the default training params. Read-only, takes no other parameters — call this first to see what action:\\\"start\\\" accepts.\\n- action:\\\"job_config\\\" — Show the effective settings a job ran with by `id` (steps/lr/rank/resolution/batch/saveEvery/sampleEvery/quantize), read back from the ai-toolkit config.yml it consumed, plus flow/model/trigger/datasetPath — everything needed to run the job again with tweaks. Read-only.\\n- action:\\\"preview_config\\\" — Show the RAW ai-toolkit config.yml action:\\\"start\\\" WOULD write for these settings (the ostris-UI 'raw config' view) — no side effects, nothing is written or started. Requires `name` + `datasetPath`. Use it to review a run before launching; pass the same params to action:\\\"start\\\" to execute.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which training-job operation to perform. \\\"list_flows\\\" takes no other parameters; \\\"status\\\" takes an OPTIONAL `id` (omit for all jobs); \\\"cancel\\\", \\\"delete\\\" and \\\"job_config\\\" require `id`; \\\"start\\\" and \\\"preview_config\\\" require `name` + `datasetPath`. NOTE \\\"delete\\\" here destroys a training JOB — deleting a staged DATASET is train_prepare_dataset action:\\\"delete\\\".\",\"enum\":[\"start\",\"status\",\"cancel\",\"delete\",\"list_flows\",\"job_config\",\"preview_config\"],\"type\":\"string\"},\"datasetPath\":{\"description\":\"Dataset dir from train_prepare_dataset (images + same-basename .txt captions). REQUIRED for actions \\\"start\\\" and \\\"preview_config\\\".\",\"minLength\":1,\"type\":\"string\"},\"deliverTo\":{\"default\":\"both\",\"description\":\"action:\\\"start\\\", pod jobs only: where the finished LoRA lands.\",\"enum\":[\"pod\",\"local\",\"both\"],\"type\":\"string\"},\"device\":{\"description\":\"action:\\\"start\\\" — GPU selector, default cuda:0.\",\"type\":\"string\"},\"flow\":{\"default\":\"character\",\"description\":\"action:\\\"start\\\" — training flow (see action:\\\"list_flows\\\").\",\"enum\":[\"character\"],\"type\":\"string\"},\"id\":{\"description\":\"Training job id, as returned by action:\\\"start\\\" (e.g. \\\"t8f3k2ab\\\") — NEVER a dataset name. REQUIRED and must be non-empty for actions \\\"cancel\\\", \\\"delete\\\" and \\\"job_config\\\". OPTIONAL for action:\\\"status\\\": omit it (or pass an empty string) to list every job newest-first. Unused by \\\"start\\\", \\\"list_flows\\\" and \\\"preview_config\\\".\",\"type\":\"string\"},\"keep_outputs\":{\"description\":\"action:\\\"delete\\\" — keep the job's output dir (checkpoints/samples) and delete only the record.\",\"type\":\"boolean\"},\"model\":{\"default\":\"flux1-dev\",\"description\":\"action:\\\"start\\\" — base model (see action:\\\"list_flows\\\").\",\"enum\":[\"flux1-dev\"],\"type\":\"string\"},\"model_path\":{\"description\":\"action:\\\"start\\\" — override the base model path AS THE TRAINER SEES IT (pod path for target 'pod', container path for 'local') — e.g. a pre-uploaded local HF snapshot dir when the default HF repo id is gated/unreachable.\",\"type\":\"string\"},\"name\":{\"description\":\"Job name — becomes the output .safetensors basename (e.g. 'aria_character'). REQUIRED for actions \\\"start\\\" and \\\"preview_config\\\". This names the RUN, not the dataset it reads.\",\"minLength\":1,\"type\":\"string\"},\"params\":{\"description\":\"Training param overrides for actions \\\"start\\\" and \\\"preview_config\\\" (steps/lr/rank/resolution/batchSize/saveEvery/sampleEvery/quantize). Omitted keys fall back to the defaults from action:\\\"list_flows\\\". action:\\\"preview_config\\\" enforces the SAME bounds action:\\\"start\\\" does, so a preview always reflects a run that could actually launch.\",\"properties\":{\"batchSize\":{\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"lr\":{\"description\":\"Learning rate (max 1).\",\"exclusiveMinimum\":0,\"maximum\":1,\"type\":\"number\"},\"quantize\":{\"description\":\"8-bit mixed precision — needed to fit Flux on 24GB.\",\"type\":\"boolean\"},\"rank\":{\"description\":\"LoRA rank (16 simple, 16-32 detailed; max 1024).\",\"maximum\":1024,\"minimum\":1,\"type\":\"integer\"},\"resolution\":{\"description\":\"Resolution buckets, e.g. [512,768,1024] (each 64-4096).\",\"items\":{\"maximum\":4096,\"minimum\":64,\"type\":\"integer\"},\"minItems\":1,\"type\":\"array\"},\"sampleEvery\":{\"description\":\"Sample-image cadence (steps).\",\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"saveEvery\":{\"description\":\"Checkpoint cadence (steps).\",\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"steps\":{\"description\":\"Total training steps (200 = smoke test, 1500-3000 real; max 100000).\",\"maximum\":100000,\"minimum\":1,\"type\":\"integer\"}},\"type\":\"object\"},\"pod_id\":{\"description\":\"action:\\\"start\\\" — RunPod pod to train on (target 'pod'). Default: the connector's currently connected/watched pod.\",\"type\":\"string\"},\"target\":{\"default\":\"local\",\"description\":\"action:\\\"start\\\" — 'local' = docker on this rig; 'pod' = pod-native over ssh on a RunPod pod.\",\"enum\":[\"local\",\"pod\"],\"type\":\"string\"},\"trigger\":{\"description\":\"Unique trigger word (e.g. 'ohwx person') — injected as trigger_word and usable in prompts.\",\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"train_start\"}"},{"name":"upload_image","hash":"e2f63571a45ff4473d4bff2b7e0ccf363887a32db9f2f6edf90fb780b66f1f33","canonical_json":"{\"description\":\"Put a file where ComfyUI (or cloud storage) can read it. Driven by the `action` parameter:\\n- action:\\\"image\\\" — Upload a local image file to the connected ComfyUI's input/ directory via the HTTP /upload/image endpoint so it can be referenced in LoadImage nodes. Works for both local and remote ComfyUI. Nested filenames that LoadImage does not enumerate are re-registered at the input root; the returned filename is the one a LoadImage combo can select.\\n- action:\\\"video\\\" — Upload a local video file (.mp4, .mov, .webm, .avi, .mkv, .m4v) to the connected ComfyUI's input/ directory via the HTTP /upload/image endpoint for use in video-loading nodes such as VHS_LoadVideo (ComfyUI-VideoHelperSuite). Works for both local and remote ComfyUI. Returns the stored filename.\\n- action:\\\"audio\\\" — Upload a local audio file (.wav, .mp3, .flac, .ogg, .m4a, .aac) to the connected ComfyUI's input/ directory via the HTTP /upload/image endpoint for use in audio-conditioned workflows (e.g. LoadAudio). Works for both local and remote ComfyUI. Returns the stored filename.\\n- action:\\\"stage\\\" — Stage an EXISTING ComfyUI output (or temp/preview) as an INPUT so the next stage's loader (LoadImage / VHS_LoadVideo / LoadAudio) can read it. This is the CORRECT way to chain a multi-stage pipeline (e.g. Krea2 image → LTX video → WAN extend): it fetches the output's bytes from the server via /view and re-registers them as an input via /upload/image — the same endpoints get_image and the uploads above use. Because it goes entirely through the server API, it works even when ComfyUI was launched with a CUSTOM input/output directory. Do NOT instead copy the output file or guess a filesystem `input/` path — the server's input dir may be custom and it will reject the file (\\\"Invalid image file\\\"), wasting the render. Pass an existing output reference ({ filename, subfolder?, type? }); the media kind (image/video/audio) is inferred from the extension unless you set `kind`. Nested video as_filename values are staged at the input root because VHS_LoadVideo lists only top-level files. Returns { filename, subfolder, type: \\\"input\\\", kind } — drop `filename` into LoadImage / VHS_LoadVideo / LoadAudio combo widgets. VHS_LoadVideoPath needs the returned filesystem path, not that combo filename (\\\"Invalid file path\\\" otherwise).\\n- action:\\\"output\\\" — Upload a generated ComfyUI output to CLOUD storage (this is the only action that sends bytes off the machine). Source can be asset_id or a local path under COMFYUI_PATH/output. Destination can be S3, Azure Blob, HTTP PUT, or HuggingFace via the hf CLI.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"What to upload and where. \\\"image\\\"/\\\"video\\\"/\\\"audio\\\" send a LOCAL file (`source_path`) to ComfyUI's input/ directory; \\\"stage\\\" re-registers an EXISTING server-side output (`filename`) as an input; \\\"output\\\" ships a generated output to cloud storage (`destination`).\",\"enum\":[\"image\",\"video\",\"audio\",\"output\",\"stage\"],\"type\":\"string\"},\"as_filename\":{\"description\":\"action:\\\"stage\\\" — override the filename it is registered under in the input/ directory (defaults to the source filename).\",\"type\":\"string\"},\"asset_id\":{\"description\":\"action:\\\"output\\\" — registered asset id from a completed job. Provide exactly one of asset_id or path.\",\"type\":\"string\"},\"destination\":{\"description\":\"action:\\\"output\\\" — REQUIRED. Exactly one upload destination.\",\"properties\":{\"azure\":{\"properties\":{\"blob_prefix\":{\"description\":\"Optional blob name prefix\",\"type\":\"string\"},\"container\":{\"description\":\"Destination Azure Blob container\",\"minLength\":1,\"type\":\"string\"}},\"required\":[\"container\"],\"type\":\"object\"},\"hf\":{\"properties\":{\"path\":{\"description\":\"Optional path prefix inside the repo\",\"type\":\"string\"},\"repo\":{\"description\":\"HuggingFace repo in owner/name format\",\"minLength\":1,\"type\":\"string\"},\"repo_type\":{\"description\":\"Repo type; defaults to model\",\"enum\":[\"model\",\"dataset\",\"space\"],\"type\":\"string\"}},\"required\":[\"repo\"],\"type\":\"object\"},\"http\":{\"properties\":{\"url\":{\"description\":\"HTTP(S) URL to PUT the output file to\",\"format\":\"uri\",\"type\":\"string\"}},\"required\":[\"url\"],\"type\":\"object\"},\"s3\":{\"properties\":{\"async\":{\"description\":\"Accepted for API compatibility; uploads complete before the tool returns.\",\"type\":\"boolean\"},\"bucket\":{\"description\":\"Destination S3 bucket\",\"minLength\":1,\"type\":\"string\"},\"prefix\":{\"description\":\"Optional object key prefix\",\"type\":\"string\"}},\"required\":[\"bucket\"],\"type\":\"object\"}},\"type\":\"object\"},\"filename\":{\"description\":\"Two meanings, one per action. actions \\\"image\\\"/\\\"video\\\"/\\\"audio\\\" — OPTIONAL override for the filename in ComfyUI's input/ directory (auto-detected from source_path if omitted). A path prefix (e.g. assets/clip.mp4) places the upload in that SUBFOLDER of input/ — \\\"..\\\" is refused — and the returned filename reference includes the subfolder when the loader enumerates it. action:\\\"image\\\" verifies the name against LoadImage /object_info and, if a nested path is stored but not listed, returns a verified root filename instead. action:\\\"stage\\\" — REQUIRED filename of the EXISTING output/temp asset to re-register (from get_history or get_image action:\\\"list_outputs\\\"), e.g. LTX_video_00001.mp4; its destination name override is `as_filename`, not this field.\",\"type\":\"string\"},\"kind\":{\"description\":\"action:\\\"stage\\\" — force the media kind instead of inferring it from the file extension.\",\"enum\":[\"image\",\"video\",\"audio\"],\"type\":\"string\"},\"path\":{\"description\":\"action:\\\"output\\\" — path to a generated output under COMFYUI_PATH/output. Provide exactly one of asset_id or path.\",\"type\":\"string\"},\"source_path\":{\"description\":\"Absolute path to the local file to upload. REQUIRED for actions \\\"image\\\", \\\"video\\\" and \\\"audio\\\".\",\"type\":\"string\"},\"subfolder\":{\"description\":\"action:\\\"stage\\\" — subfolder the source asset currently lives in, if any.\",\"type\":\"string\"},\"type\":{\"description\":\"action:\\\"stage\\\" — source directory the asset lives in: output (default) or temp (previews).\",\"enum\":[\"output\",\"temp\"],\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"upload_image\"}"},{"name":"visualize_workflow","hash":"dc6fb2d4b3d27d679623ca9dbf297febd7efd9e153084959de8b8c8989dbe31d","canonical_json":"{\"description\":\"DRAW a diagram of, or convert, workflow JSON you PASS IN (a JSON string or object) — it does NOT read the user's live canvas, so for 'show me what's on the canvas' / the CURRENTLY-OPEN graph use panel_graph_outline instead. Driven by the `action` parameter:\\n- action:\\\"render\\\" — Mermaid flowchart of the whole graph: nodes grouped by category, connections labeled by data type.\\n- action:\\\"render_hierarchical\\\" — the same graph SECTIONED rather than flat, which is what you want past ~20 nodes. `view` picks a compact overview, one section in detail, a text listing, or an AI-oriented structured summary.\\n- action:\\\"mermaid\\\" — the INVERSE of render: a Mermaid flowchart back into executable API-format workflow JSON, wired from /object_info schemas.\\n- action:\\\"to_dsl\\\" — API-format JSON into the compact, human/LLM-readable authoring DSL: `key <- nodeId.outputIndex` for connections, `key = ` for literals. Round-trips losslessly. (Experimental.)\\n- action:\\\"from_dsl\\\" — that DSL back into executable JSON, plus advisory wiring warnings when ComfyUI is reachable (the conversion succeeds either way). (Experimental.)\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which rendering/conversion to perform. \\\"render\\\", \\\"render_hierarchical\\\" and \\\"to_dsl\\\" require `workflow`; \\\"mermaid\\\" requires `mermaid`; \\\"from_dsl\\\" requires `dsl`.\",\"enum\":[\"render\",\"render_hierarchical\",\"mermaid\",\"to_dsl\",\"from_dsl\"],\"type\":\"string\"},\"direction\":{\"description\":\"action:\\\"render\\\" / action:\\\"render_hierarchical\\\" — Flowchart direction: LR (left-to-right) or TB (top-to-bottom). Default LR for \\\"render\\\" and for the hierarchical detail view, TB for the hierarchical overview.\",\"enum\":[\"LR\",\"TB\"],\"type\":\"string\"},\"dsl\":{\"description\":\"action:\\\"from_dsl\\\" (REQUIRED) — Workflow DSL text\",\"type\":\"string\"},\"mermaid\":{\"description\":\"action:\\\"mermaid\\\" (REQUIRED) — Mermaid flowchart text (with or without ```mermaid code fence). Nodes should use ComfyUI class_type names as labels. Connections should be labeled with data types (e.g., -->|MODEL|).\",\"type\":\"string\"},\"section\":{\"description\":\"action:\\\"render_hierarchical\\\" — Section name to show in detail view (required when view=detail). Use view=list to see available section names.\",\"type\":\"string\"},\"show_values\":{\"default\":true,\"description\":\"action:\\\"render\\\" / action:\\\"render_hierarchical\\\" — Include widget values (seed, steps, cfg, etc.) in node labels (detail view only, for the hierarchical action).\",\"type\":\"boolean\"},\"view\":{\"default\":\"overview\",\"description\":\"action:\\\"render_hierarchical\\\" — overview: compact diagram with sections as summary nodes; detail: full diagram for one section; list: text summary of all sections; summary: structured text optimized for AI ingestion with node IDs, key settings, virtual wires, and full connection graph\",\"enum\":[\"overview\",\"detail\",\"list\",\"summary\"],\"type\":\"string\"},\"workflow\":{\"anyOf\":[{\"type\":\"string\"},{\"additionalProperties\":{},\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}],\"description\":\"ComfyUI workflow JSON (as a JSON string or object; API or UI format is auto-detected). REQUIRED for action:\\\"render\\\", action:\\\"render_hierarchical\\\" and action:\\\"to_dsl\\\" — \\\"to_dsl\\\" expects API format (node ID -> {class_type, inputs}).\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"visualize_workflow\"}"},{"name":"workspace","hash":"b242ca52472061fc8dc26e142188c7d8f9e4b67ffb915a1ac0edfe96a935275d","canonical_json":"{\"description\":\"Inspect and manage ComfyUI workspaces (local installs). Driven by the `action` parameter:\\n- action:\\\"get\\\" — Report the active ComfyUI workspace (mirrors `comfy-cli which`): the local installation path being used (from COMFYUI_PATH or auto-detection), the source of that path, any persisted default workspace, and the resolved API target the MCP server talks to.\\n- action:\\\"set_default\\\" — Persist a default ComfyUI workspace path to the MCP config file (mirrors `comfy-cli set-default`). The value is stored under the OS config dir (e.g. ~/.config/comfyui-mcp/workspace.json) and reported by action:\\\"get\\\"/action:\\\"list\\\". Does NOT change the live API target. `path` is REQUIRED, e.g. {action:\\\"set_default\\\", path:\\\"/opt/ComfyUI\\\"}.\\n- action:\\\"list\\\" — List known/auto-detected ComfyUI installations on this machine. Scans common install locations across macOS, Linux, and Windows and marks which one is active and which is the saved default.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Which workspace operation to perform. \\\"get\\\" and \\\"list\\\" take no other parameters; \\\"set_default\\\" requires `path`.\",\"enum\":[\"get\",\"set_default\",\"list\"],\"type\":\"string\"},\"path\":{\"description\":\"action:\\\"set_default\\\" — REQUIRED absolute path to a ComfyUI installation directory to remember as the default workspace.\",\"minLength\":1,\"type\":\"string\"}},\"required\":[\"action\"],\"type\":\"object\"},\"name\":\"workspace\"}"}],"entry_hash":"0035331e51a79d47482fe4205ff52be424879166993dfa3757c8d240ef27ef40"} {"seq":1,"prev_entry_hash":"0035331e51a79d47482fe4205ff52be424879166993dfa3757c8d240ef27ef40","observed_at":"2026-09-02T07:54:52.414Z","server_id":"4914d06c4a8c19cf","server_name":"@zereight/mcp-gitlab","source":"npm","set_hash":"934618408b307921353924c7b7ad37f1fea861fb638f5e1580e23223f9c2f116","tools":[{"name":"approve_merge_request","hash":"3793d2a76afd33bc14a5dd603580e6874fafec33233170fec15b1222c15a34f0","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Approve a merge request. Use this to record an approval on an existing merge request; it does not merge the request or change its source branch. The operation changes review state, may require re-authentication or approval permission, and returns the updated approval result or a permission/state error.\",\"inputSchema\":{\"properties\":{\"approval_password\":{\"description\":\"Current user's password. Required if 'Require user re-authentication to approve' is enabled in the project settings\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of the merge request to approve\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"sha\":{\"description\":\"The HEAD of the merge request. Optional, but used to ensure the merge request hasn't changed since you last reviewed it\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"approve_merge_request\"}"},{"name":"bulk_publish_draft_notes","hash":"4575d5d7382a6daefb1b29db5205379f61e478f97eb0b3101bfb6719fe8a24e2","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Publish all draft notes for a merge request. Optionally sets reviewer_state and posts a summary note (GitLab 19.2+). Can set reviewer_state even with no drafts. Use this for the specific operation described; choose a sibling tool when you need a different resource or lifecycle action. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"internal\":{\"description\":\"If true, the summary note is internal (GitLab 19.2+, default false)\",\"type\":\"boolean\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note\":{\"description\":\"Summary note body to post on the merge request (GitLab 19.2+)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"reviewer_state\":{\"description\":\"Set reviewer review state after publishing (GitLab 19.2+). Does not record a formal approval. Works even with no draft notes.\",\"enum\":[\"requested_changes\",\"reviewed\"],\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"bulk_publish_draft_notes\"}"},{"name":"create_branch","hash":"e8307f4184acae829b41f0e5303d8ed12fd3d020417ce8add82d7bcf5f97e6c3","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new branch. Use this to create a branch from a branch, tag, or commit; use `get_branch` or `list_branches` to inspect branches and `protect_branch` to configure protection afterward. The operation changes remote repository state, requires branch-creation permission, and returns the new branch or a validation, missing-ref, protected-project, or already-exists error. `project_id` accepts a numeric ID or URL-encoded path, `branch` is the new name, and `ref` selects its starting revision.\",\"inputSchema\":{\"properties\":{\"branch\":{\"description\":\"Name for the new branch\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"ref\":{\"description\":\"Source branch/commit for new branch\",\"type\":\"string\"}},\"required\":[\"branch\",\"project_id\"],\"type\":\"object\"},\"name\":\"create_branch\"}"},{"name":"create_commit_status","hash":"2bd1cabeac583a2f033f549eac9cb70c18991668049b2cfc0bdcbcc495850656","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create or update the status of a commit. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"context\":{\"description\":\"Alias for name. Provide either name or context, not both.\",\"maxLength\":255,\"type\":\"string\"},\"coverage\":{\"description\":\"Total code coverage for this status\",\"type\":\"number\"},\"description\":{\"description\":\"Short status description\",\"maxLength\":255,\"type\":\"string\"},\"name\":{\"description\":\"Status name. GitLab defaults to 'default' when omitted.\",\"maxLength\":255,\"type\":\"string\"},\"pipeline_id\":{\"description\":\"Pipeline ID to attach the status to\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"ref\":{\"description\":\"The branch or tag ref\",\"maxLength\":255,\"type\":\"string\"},\"sha\":{\"description\":\"The commit hash to set the status on\",\"type\":\"string\"},\"state\":{\"description\":\"Commit status state\",\"enum\":[\"pending\",\"running\",\"success\",\"failed\",\"canceled\",\"skipped\"],\"type\":\"string\"},\"target_url\":{\"description\":\"Target URL associated with this status\",\"maxLength\":255,\"type\":\"string\"}},\"required\":[\"sha\",\"state\",\"project_id\"],\"type\":\"object\"},\"name\":\"create_commit_status\"}"},{"name":"create_draft_note","hash":"a7af8d77c9e6441b7de7405b2816369c967312f3d39a33fbf80329024cb3aa54","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a draft note for a merge request. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the draft note\",\"type\":\"string\"},\"in_reply_to_discussion_id\":{\"description\":\"The ID of a discussion the draft note replies to\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"position\":{\"description\":\"Position when creating a diff note\",\"properties\":{\"base_sha\":{\"description\":\"REQUIRED: Base commit SHA in the source branch. Get this from merge request diff_refs.base_sha.\",\"type\":\"string\"},\"head_sha\":{\"description\":\"REQUIRED: SHA referencing HEAD of the source branch. Get this from merge request diff_refs.head_sha.\",\"type\":\"string\"},\"height\":{\"description\":\"IMAGE DIFFS ONLY: Height of the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"line_range\":{\"anyOf\":[{\"description\":\"Line range for multiline comments on GitLab merge request diffs. VALIDATION RULES: 1) line_code is critical for GitLab API success, 2) start/end must have consistent types, 3) line numbers must form valid range, 4) get line_code from GitLab diff API, never generate manually.\",\"properties\":{\"end\":{\"description\":\"End line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither. Range must be valid (end >= start).\",\"properties\":{\"line_code\":{\"description\":\"CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_12_17'. Must be from same file as start.line_code.\",\"type\":[\"string\",\"null\"]},\"new_line\":{\"description\":\"Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines. MUST be >= start.new_line if both specified.\",\"type\":[\"number\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines. MUST be >= start.old_line if both specified.\",\"type\":[\"number\",\"null\"]},\"type\":{\"anyOf\":[{\"enum\":[\"new\",\"old\",\"expanded\",\"logic\",\"style\"],\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. SHOULD MATCH start.type for consistent ranges (don't mix old/new types).\"}},\"type\":\"object\"},\"start\":{\"description\":\"Start line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither.\",\"properties\":{\"line_code\":{\"description\":\"CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_10_15'. Get this from GitLab diff API response, never fabricate.\",\"type\":[\"string\",\"null\"]},\"new_line\":{\"description\":\"Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines.\",\"type\":[\"number\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines.\",\"type\":[\"number\",\"null\"]},\"type\":{\"anyOf\":[{\"enum\":[\"new\",\"old\",\"expanded\",\"logic\",\"style\"],\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. MUST match the line_code format and old_line/new_line values.\"}},\"type\":\"object\"}},\"required\":[\"start\",\"end\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line.\"},\"new_line\":{\"description\":\"Line number in modified file (after changes). Use for added lines or context lines. NULL for deleted lines. For single-line comments on new lines.\",\"type\":[\"number\",\"null\"]},\"new_path\":{\"description\":\"File path after changes. REQUIRED for most diff comments. Use same as old_path if file wasn't renamed.\",\"type\":[\"string\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines.\",\"type\":[\"number\",\"null\"]},\"old_path\":{\"description\":\"File path before changes. REQUIRED for most diff comments. Use same as new_path if file wasn't renamed.\",\"type\":[\"string\",\"null\"]},\"position_type\":{\"description\":\"REQUIRED: Position type. Use 'text' for code diffs, 'image' for image diffs, 'file' for file-level comments.\",\"enum\":[\"text\",\"image\",\"file\"],\"type\":\"string\"},\"start_sha\":{\"description\":\"REQUIRED: SHA referencing the start commit of the source branch. Get this from merge request diff_refs.start_sha.\",\"type\":\"string\"},\"width\":{\"description\":\"IMAGE DIFFS ONLY: Width of the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"x\":{\"description\":\"IMAGE DIFFS ONLY: X coordinate on the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"y\":{\"description\":\"IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image').\",\"type\":[\"number\",\"null\"]}},\"required\":[\"base_sha\",\"head_sha\",\"start_sha\",\"position_type\"],\"type\":\"object\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"resolve_discussion\":{\"description\":\"Whether to resolve the discussion when publishing\",\"type\":\"boolean\"}},\"required\":[\"body\",\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"create_draft_note\"}"},{"name":"create_group","hash":"c82188864057846d1e4a03c4e013a27feec816e39845c1cb0ad5912807b78e1a","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create new group or subgroup. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"description\":{\"description\":\"The group's description\",\"type\":\"string\"},\"name\":{\"description\":\"The name of the group\",\"type\":\"string\"},\"parent_id\":{\"description\":\"The parent group ID for creating a subgroup\",\"type\":\"number\"},\"path\":{\"description\":\"The path of the group\",\"type\":\"string\"},\"visibility\":{\"description\":\"The group's visibility level\",\"enum\":[\"private\",\"internal\",\"public\"],\"type\":\"string\"}},\"required\":[\"name\",\"path\"],\"type\":\"object\"},\"name\":\"create_group\"}"},{"name":"create_issue","hash":"2e30c684b6b3723f6fa2177d3f3189f7526aad49734d3a00c5c7a8f26007dc64","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new issue. Use this to open a new issue; use `update_issue` for an existing issue and `create_issue_note` to add discussion without changing issue fields. The operation creates remote project data, requires issue creation permission, and returns the new issue or a validation, permission, or duplicate-related error.\",\"inputSchema\":{\"properties\":{\"assignee_ids\":{\"description\":\"Array of user IDs to assign\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"description\":{\"description\":\"Issue description\",\"type\":\"string\"},\"issue_type\":{\"default\":\"issue\",\"description\":\"The type of issue. One of issue, incident, test_case or task.\",\"enum\":[\"issue\",\"incident\",\"test_case\",\"task\"],\"type\":\"string\"},\"labels\":{\"description\":\"Array of label names\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"milestone_id\":{\"description\":\"Milestone ID to assign\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"title\":{\"description\":\"Issue title\",\"type\":\"string\"},\"weight\":{\"description\":\"Weight of the issue (numeric, typically hours of work)\",\"type\":\"number\"}},\"required\":[\"title\",\"project_id\"],\"type\":\"object\"},\"name\":\"create_issue\"}"},{"name":"create_issue_emoji_reaction","hash":"ddd226f2477c40e2aeb7b19550f3dd419f268b3b45dd23056b64d8afb1afc063","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add an emoji reaction to an issue (e.g. thumbsup, rocket, eyes). Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"name\":{\"description\":\"Name of the emoji without colons (e.g. 'thumbsup', 'rocket', 'eyes')\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"name\",\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"create_issue_emoji_reaction\"}"},{"name":"create_issue_link","hash":"354713a6f71ebfdc7d2e40cedf49ac60f8c8960ba64b386cc35b56ccda10f45e","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create an issue link between two issues. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The internal ID of a project's issue\",\"type\":\"string\"},\"link_type\":{\"description\":\"The type of the relation, defaults to relates_to\",\"enum\":[\"relates_to\",\"blocks\",\"is_blocked_by\"],\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"},\"target_issue_iid\":{\"description\":\"The internal ID of a target project's issue\",\"type\":\"string\"},\"target_project_id\":{\"description\":\"The ID or URL-encoded path of a target project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\",\"target_project_id\",\"target_issue_iid\"],\"type\":\"object\"},\"name\":\"create_issue_link\"}"},{"name":"create_issue_note","hash":"b1c7771bba223e59116ae737ff9c0358495c5119e8308d3f0505f74583e2ae21","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add a note to an issue, optionally replying to a discussion thread. Use this to add a note to an existing issue, optionally as a reply to a discussion; use `update_issue` for issue fields and `create_note` only when the generic endpoint is required. The operation creates remote discussion content, requires note permission, and returns the note or a missing-issue/thread/permission error.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the note or reply\",\"type\":\"string\"},\"created_at\":{\"description\":\"Date the note was created at (ISO 8601 format)\",\"type\":\"string\"},\"discussion_id\":{\"description\":\"The ID of a thread. If provided, replies to that thread; otherwise creates a top-level note\",\"type\":\"string\"},\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"body\",\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"create_issue_note\"}"},{"name":"create_issue_note_emoji_reaction","hash":"49fc29bf8b1b4660783be9f425cc393e226152e6ef6f9fa4d93fef077adab1ea","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add an emoji reaction to an issue note. Pass discussion_id for discussion thread replies. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"discussion_id\":{\"description\":\"The ID of a discussion thread. Required for notes that are discussion replies; omit for top-level notes.\",\"type\":\"string\"},\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"name\":{\"description\":\"Name of the emoji without colons (e.g. 'thumbsup', 'rocket', 'eyes')\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a note (comment or thread reply)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"name\",\"project_id\",\"issue_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"create_issue_note_emoji_reaction\"}"},{"name":"create_label","hash":"86f1eb84f870910265fc19e36bd1f4e334f477c7fa5a7d4f68cd0786cb30f8b6","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new label in a project. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"color\":{\"description\":\"The color of the label given in 6-digit hex notation with leading '#' sign\",\"type\":\"string\"},\"description\":{\"description\":\"The description of the label\",\"type\":\"string\"},\"name\":{\"description\":\"The name of the label\",\"type\":\"string\"},\"priority\":{\"description\":\"The priority of the label\",\"type\":[\"number\",\"null\"]},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"name\",\"color\",\"project_id\"],\"type\":\"object\"},\"name\":\"create_label\"}"},{"name":"create_merge_request","hash":"2a88b31e55abd7f919c3974485fb350dc830f953ad488bf0e4d11736474922cd","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new merge request. Use this to open a new merge request from an existing source branch to a target branch; use `update_merge_request` after it exists. The operation creates remote review state, requires project access, and returns the new merge request or a validation, permission, branch, or duplicate-related error.\",\"inputSchema\":{\"properties\":{\"allow_collaboration\":{\"description\":\"Allow commits from upstream members\",\"type\":\"boolean\"},\"assignee_ids\":{\"description\":\"The ID of the users to assign the MR to\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"description\":{\"description\":\"Merge request description\",\"type\":\"string\"},\"draft\":{\"description\":\"Create as draft merge request\",\"type\":\"boolean\"},\"labels\":{\"description\":\"Labels for the MR\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"remove_source_branch\":{\"description\":\"Flag indicating if a merge request should remove the source branch when merging.\",\"type\":[\"boolean\",\"null\"]},\"reviewer_ids\":{\"description\":\"The ID of the users to assign as reviewers of the MR\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"source_branch\":{\"description\":\"Branch containing changes\",\"type\":\"string\"},\"squash\":{\"description\":\"If true, squash all commits into a single commit on merge.\",\"type\":[\"boolean\",\"null\"]},\"target_branch\":{\"description\":\"Branch to merge into\",\"type\":\"string\"},\"target_project_id\":{\"description\":\"Numeric ID of the target project.\",\"type\":\"string\"},\"title\":{\"description\":\"Merge request title\",\"type\":\"string\"}},\"required\":[\"title\",\"source_branch\",\"target_branch\",\"project_id\"],\"type\":\"object\"},\"name\":\"create_merge_request\"}"},{"name":"create_merge_request_discussion_note","hash":"0a7bbbf91e5e69ba3cbb47592bb44c1cc83bff69c146557ce69fd029803a9567","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add a new discussion note to an existing merge request thread. Use this to reply inside an existing merge request discussion; use `create_merge_request_thread` to start a new thread and `create_merge_request_note` for a top-level note. The operation creates remote review content, requires note permission, and returns the new note or a missing-discussion/position/permission error.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the note or reply\",\"type\":\"string\"},\"created_at\":{\"description\":\"Date the note was created at (ISO 8601 format)\",\"type\":\"string\"},\"discussion_id\":{\"description\":\"The ID of a thread\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"body\",\"project_id\",\"merge_request_iid\",\"discussion_id\"],\"type\":\"object\"},\"name\":\"create_merge_request_discussion_note\"}"},{"name":"create_merge_request_emoji_reaction","hash":"b40a998a35be6de922c9a8bb88673cd2d3ceb10b944e7e5c637916990ce8ff54","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add an emoji reaction to a merge request (e.g. thumbsup, rocket, eyes). Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"name\":{\"description\":\"Name of the emoji without colons (e.g. 'thumbsup', 'rocket', 'eyes')\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"name\",\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"create_merge_request_emoji_reaction\"}"},{"name":"create_merge_request_note","hash":"259b4b05dec066a0dbfae206cb40a6878fb87c8de012667e6d8c2beecd358908","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add a new note to a merge request. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the note or reply\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"body\",\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"create_merge_request_note\"}"},{"name":"create_merge_request_note_emoji_reaction","hash":"6b52edf306f4a5ccddd3290bf6d7f302c51e9b6b92b4f059ddf61fc5638ec94c","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Add an emoji reaction to a merge request note. Pass discussion_id for discussion thread replies. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"discussion_id\":{\"description\":\"The ID of a discussion thread. Required for notes that are discussion replies; omit for top-level notes.\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"name\":{\"description\":\"Name of the emoji without colons (e.g. 'thumbsup', 'rocket', 'eyes')\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a note (comment or thread reply)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"name\",\"project_id\",\"merge_request_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"create_merge_request_note_emoji_reaction\"}"},{"name":"create_merge_request_thread","hash":"2d02e4d037fa0e45be51749c7c024e758c3d0ebd83e16170adef755938e49c32","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new thread on a merge request. Use this to start a review thread on a merge request; use `create_merge_request_note` for an unthreaded note and `create_merge_request_discussion_note` to reply to an existing thread. The operation creates remote review content, requires note permission, and returns the discussion or a position/permission/validation error.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the thread\",\"type\":\"string\"},\"created_at\":{\"description\":\"Date the thread was created at (ISO 8601 format)\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"position\":{\"description\":\"Position when creating a diff note\",\"properties\":{\"base_sha\":{\"description\":\"REQUIRED: Base commit SHA in the source branch. Get this from merge request diff_refs.base_sha.\",\"type\":\"string\"},\"head_sha\":{\"description\":\"REQUIRED: SHA referencing HEAD of the source branch. Get this from merge request diff_refs.head_sha.\",\"type\":\"string\"},\"height\":{\"description\":\"IMAGE DIFFS ONLY: Height of the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"line_range\":{\"anyOf\":[{\"description\":\"Line range for multiline comments on GitLab merge request diffs. VALIDATION RULES: 1) line_code is critical for GitLab API success, 2) start/end must have consistent types, 3) line numbers must form valid range, 4) get line_code from GitLab diff API, never generate manually.\",\"properties\":{\"end\":{\"description\":\"End line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither. Range must be valid (end >= start).\",\"properties\":{\"line_code\":{\"description\":\"CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_12_17'. Must be from same file as start.line_code.\",\"type\":[\"string\",\"null\"]},\"new_line\":{\"description\":\"Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines. MUST be >= start.new_line if both specified.\",\"type\":[\"number\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines. MUST be >= start.old_line if both specified.\",\"type\":[\"number\",\"null\"]},\"type\":{\"anyOf\":[{\"enum\":[\"new\",\"old\",\"expanded\",\"logic\",\"style\"],\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. SHOULD MATCH start.type for consistent ranges (don't mix old/new types).\"}},\"type\":\"object\"},\"start\":{\"description\":\"Start line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither.\",\"properties\":{\"line_code\":{\"description\":\"CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_10_15'. Get this from GitLab diff API response, never fabricate.\",\"type\":[\"string\",\"null\"]},\"new_line\":{\"description\":\"Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines.\",\"type\":[\"number\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines.\",\"type\":[\"number\",\"null\"]},\"type\":{\"anyOf\":[{\"enum\":[\"new\",\"old\",\"expanded\",\"logic\",\"style\"],\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. MUST match the line_code format and old_line/new_line values.\"}},\"type\":\"object\"}},\"required\":[\"start\",\"end\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line.\"},\"new_line\":{\"description\":\"Line number in modified file (after changes). Use for added lines or context lines. NULL for deleted lines. For single-line comments on new lines.\",\"type\":[\"number\",\"null\"]},\"new_path\":{\"description\":\"File path after changes. REQUIRED for most diff comments. Use same as old_path if file wasn't renamed.\",\"type\":[\"string\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines.\",\"type\":[\"number\",\"null\"]},\"old_path\":{\"description\":\"File path before changes. REQUIRED for most diff comments. Use same as new_path if file wasn't renamed.\",\"type\":[\"string\",\"null\"]},\"position_type\":{\"description\":\"REQUIRED: Position type. Use 'text' for code diffs, 'image' for image diffs, 'file' for file-level comments.\",\"enum\":[\"text\",\"image\",\"file\"],\"type\":\"string\"},\"start_sha\":{\"description\":\"REQUIRED: SHA referencing the start commit of the source branch. Get this from merge request diff_refs.start_sha.\",\"type\":\"string\"},\"width\":{\"description\":\"IMAGE DIFFS ONLY: Width of the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"x\":{\"description\":\"IMAGE DIFFS ONLY: X coordinate on the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"y\":{\"description\":\"IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image').\",\"type\":[\"number\",\"null\"]}},\"required\":[\"base_sha\",\"head_sha\",\"start_sha\",\"position_type\"],\"type\":\"object\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"body\",\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"create_merge_request_thread\"}"},{"name":"create_note","hash":"b9387630e411917eacdc58cf55caa5169b04d4f5d2a2f535f8f9489ebfcde9ac","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new note (comment) to an issue or merge request. Use this for a top-level comment on an issue or merge request when no typed discussion operation is needed; use `create_merge_request_thread` or `create_issue_note` for threaded replies. The operation creates remote discussion content, requires note permission, and returns the created note or a target/permission/validation error.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"Note content\",\"type\":\"string\"},\"noteable_iid\":{\"description\":\"IID of the issue or merge request\",\"type\":\"string\"},\"noteable_type\":{\"description\":\"Type of noteable (issue or merge_request)\",\"enum\":[\"issue\",\"merge_request\"],\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or namespace/project_path\",\"type\":\"string\"}},\"required\":[\"noteable_type\",\"body\",\"project_id\",\"noteable_iid\"],\"type\":\"object\"},\"name\":\"create_note\"}"},{"name":"create_or_update_file","hash":"a0129fc836f0de4008dd80a0a7c80a2e425b9fe49c72afd844af5e3bbd925a43","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create or update a file in a GitLab project. Use this for a single repository file when you know whether the target path is new or already exists; use `push_files` for a multi-file commit. Optional `encoding` (`text` or `base64`) defaults to `GITLAB_REPO_FILE_ENCODING` so existing callers stay unchanged. The operation creates or updates remote content in a commit, requires repository write permission, and returns the commit result or a conflict/validation error.\",\"inputSchema\":{\"properties\":{\"branch\":{\"description\":\"Branch to create/update the file in\",\"type\":\"string\"},\"commit_id\":{\"description\":\"Current file commit ID (for update operations)\",\"type\":\"string\"},\"commit_message\":{\"description\":\"Commit message\",\"type\":\"string\"},\"content\":{\"description\":\"Content of the file\",\"type\":\"string\"},\"encoding\":{\"description\":\"Content encoding. Use 'base64' for binary files (content must already be base64-encoded). When omitted, GITLAB_REPO_FILE_ENCODING applies.\",\"enum\":[\"text\",\"base64\"],\"type\":\"string\"},\"file_path\":{\"description\":\"Path where to create/update the file\",\"type\":\"string\"},\"last_commit_id\":{\"description\":\"Last known file commit ID\",\"type\":\"string\"},\"previous_path\":{\"description\":\"Path of the file to move/rename\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"file_path\",\"content\",\"commit_message\",\"branch\",\"project_id\"],\"type\":\"object\"},\"name\":\"create_or_update_file\"}"},{"name":"create_repository","hash":"2a15194dd8ec09c5fcd98dfbffeb9686563df6350712a31a16ed5e1fcad23938","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Create a new GitLab project. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"description\":{\"description\":\"Repository description\",\"type\":\"string\"},\"initialize_with_readme\":{\"description\":\"Initialize with README.md\",\"type\":\"boolean\"},\"name\":{\"description\":\"Repository name\",\"type\":\"string\"},\"namespace_id\":{\"description\":\"Group namespace ID to create the project in. Omit to use the current user's namespace.\",\"minimum\":1,\"type\":\"integer\"},\"visibility\":{\"description\":\"Repository visibility level\",\"enum\":[\"private\",\"internal\",\"public\"],\"type\":\"string\"}},\"required\":[\"name\"],\"type\":\"object\"},\"name\":\"create_repository\"}"},{"name":"delete_branch","hash":"25b61d86befc11edc5b638eed0fe837b9a0e4aff2c09c427c7888894f6a6c60c","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete branch from project. Use this only after confirming the branch name and intended data loss; use `get_branch` or `list_branches` before deletion and never use it to remove branch protection. The operation permanently removes a remote branch, requires branch-delete permission, and returns the deletion result or a protected-branch, missing-resource, or permission error.\",\"inputSchema\":{\"properties\":{\"branch_name\":{\"description\":\"Name of the branch to delete\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"branch_name\",\"project_id\"],\"type\":\"object\"},\"name\":\"delete_branch\"}"},{"name":"delete_draft_note","hash":"644beed4b861c7c5898bef450a9500878a91502a7b8690d02c2bf1a29c4c634b","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete a draft note. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"draft_note_id\":{\"description\":\"The ID of the draft note\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"draft_note_id\"],\"type\":\"object\"},\"name\":\"delete_draft_note\"}"},{"name":"delete_issue","hash":"b105191542740bc2b900d3b80a7f5e9da0e91eebb01da6d5f6cbf6c70a209690","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete an issue. Use this only after confirming the issue and intended permanent removal; use `update_issue` to close or edit an issue without deleting it. The operation permanently removes issue data, requires delete permission, and returns the deletion result or a missing-resource, permission, or policy error.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The internal ID of the project issue\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"delete_issue\"}"},{"name":"delete_issue_emoji_reaction","hash":"624a3d2f03c25a652c8ed733d83c225c18980764629913eb63397280b04fa9e2","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Remove an emoji reaction from an issue. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"award_id\":{\"description\":\"The ID of the emoji reaction to delete\",\"type\":\"string\"},\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\",\"award_id\"],\"type\":\"object\"},\"name\":\"delete_issue_emoji_reaction\"}"},{"name":"delete_issue_link","hash":"236a090ef20928153357f23c711b50e44af08745469b2bbfc118e1f198e6a0ab","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete an issue link. Use this to remove an existing relationship between two issues; use `list_issue_links` or `get_issue_link` to verify the link first. The operation changes issue relationships, requires issue-edit permission, and returns the result or an error when the link is missing or access is denied.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The internal ID of a project's issue\",\"type\":\"string\"},\"issue_link_id\":{\"description\":\"The ID of an issue relationship\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\",\"issue_link_id\"],\"type\":\"object\"},\"name\":\"delete_issue_link\"}"},{"name":"delete_issue_note_emoji_reaction","hash":"6ed9a69b0d6f9c025e06d134f900feb7d73760f2c9478dfe4bfa92f12f41f56c","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Remove an emoji reaction from an issue note. Pass discussion_id for discussion thread replies. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"award_id\":{\"description\":\"The ID of the emoji reaction to delete\",\"type\":\"string\"},\"discussion_id\":{\"description\":\"The ID of a discussion thread. Required for notes that are discussion replies; omit for top-level notes.\",\"type\":\"string\"},\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a note (comment or thread reply)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\",\"note_id\",\"award_id\"],\"type\":\"object\"},\"name\":\"delete_issue_note_emoji_reaction\"}"},{"name":"delete_label","hash":"8cbc4ed129ef05d2636dd955bc40729aaa3c05dbf411f2c5ae41eeacb0dc1d4b","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete a label from a project. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"label_id\":{\"description\":\"The ID or title of a project's label\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"label_id\"],\"type\":\"object\"},\"name\":\"delete_label\"}"},{"name":"delete_merge_request_discussion_note","hash":"e77e8a8076eb6be4c625a8d25c25401e68112ad39cc15a11f307404a7bbfb088","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete a discussion note on a merge request. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"discussion_id\":{\"description\":\"The ID of a thread\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a thread note\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"discussion_id\",\"note_id\"],\"type\":\"object\"},\"name\":\"delete_merge_request_discussion_note\"}"},{"name":"delete_merge_request_emoji_reaction","hash":"d8c2ddb546635ddb7a0e49365e450d8aa6cad90367a853e2917581d5ef627e78","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Remove an emoji reaction from a merge request. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"award_id\":{\"description\":\"The ID of the emoji reaction to delete\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"award_id\"],\"type\":\"object\"},\"name\":\"delete_merge_request_emoji_reaction\"}"},{"name":"delete_merge_request_note","hash":"31df03cba6ed9aba30052a17bb7fa2b5ebde40cb65a5288609edc935586d8750","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Delete an existing merge request note. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a thread note\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"delete_merge_request_note\"}"},{"name":"delete_merge_request_note_emoji_reaction","hash":"9b8911205bbba4cf6d37f96724b11625a108163fa2d78996c6b1cab94e397a31","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Remove an emoji reaction from a merge request note. Pass discussion_id for discussion thread replies. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"award_id\":{\"description\":\"The ID of the emoji reaction to delete\",\"type\":\"string\"},\"discussion_id\":{\"description\":\"The ID of a discussion thread. Required for notes that are discussion replies; omit for top-level notes.\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a note (comment or thread reply)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"note_id\",\"award_id\"],\"type\":\"object\"},\"name\":\"delete_merge_request_note_emoji_reaction\"}"},{"name":"discover_tools","hash":"1a43ddd866eb638045f0eadc84c583970d3b373569d503a2848c8244185b381f","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Discover and activate additional tool categories for this session. Available categories: merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, users, workitems, webhooks, search, variables, dependency_proxy, vulnerabilities. Already-active categories are listed in the response. Use this when a needed opt-in category is not currently exposed; omit `category` to inspect available categories, then call it with a category to activate that group for the current session. It changes only the session's tool registry, returns the active-tool summary, and does not change GitLab data.\",\"inputSchema\":{\"properties\":{\"category\":{\"description\":\"Toolset category to activate (e.g. 'pipelines', 'wiki'). Omit to list available categories.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"discover_tools\"}"},{"name":"download_attachment","hash":"03cebf98c27c3098691f056a9e5436c9cda48a78f10e267ddefb11dcd17f21ba","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Download an uploaded file from a project (images returned as base64; use local_path to save to disk). Use this to retrieve a previously uploaded project attachment; remote mode returns inline base64 for images or a download URL, while local mode can save to a path. It is read-only with respect to GitLab, requires project access, and returns the file content or an attachment/permission error.\",\"inputSchema\":{\"properties\":{\"filename\":{\"description\":\"The filename of the upload\",\"type\":\"string\"},\"local_path\":{\"description\":\"Local path to save the file (optional, defaults to current directory)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path of the project\",\"type\":\"string\"},\"secret\":{\"description\":\"The 32-character secret of the upload\",\"type\":\"string\"}},\"required\":[\"project_id\",\"secret\",\"filename\"],\"type\":\"object\"},\"name\":\"download_attachment\"}"},{"name":"fork_repository","hash":"c2eb61c4bc3f3ba60ae25f379794c66e68b9555ce03ed642f85c63c956610bf3","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Fork a project to your account or specified namespace. Use this to create a copy of an existing project in the current user's namespace or a permitted namespace; use `search_repositories` or `get_project` to inspect projects without copying them. The operation creates a new project, requires fork permission, and returns the forked project or a namespace/permission error.\",\"inputSchema\":{\"properties\":{\"namespace\":{\"description\":\"Namespace to fork to (full path)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"fork_repository\"}"},{"name":"get_branch","hash":"cef7c74ddf6a0e5526613161fc44ddcfc4d22aa64419f508170c57ff392d8dd2","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get branch details (commit, protection status). Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"branch_name\":{\"description\":\"Name of the branch\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"branch_name\",\"project_id\"],\"type\":\"object\"},\"name\":\"get_branch\"}"},{"name":"get_branch_diffs","hash":"68297da2e0e2254a92e1ea47b0be5be6bcd834953da8292ce8813ef51dd1d3a5","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get diffs between two branches or commits. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"excluded_file_patterns\":{\"description\":\"Array of regex patterns to exclude files from the diff results. Each pattern is a JavaScript-compatible regular expression that matches file paths to ignore. Examples: [\\\"^vendor/\\\", \\\"^test/mocks/\\\", \\\"\\\\.spec\\\\.ts$\\\", \\\"package-lock\\\\.json\\\"]\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"from\":{\"description\":\"The base branch or commit SHA to compare from\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"straight\":{\"description\":\"Comparison method: false for '...' (default), true for '--'\",\"type\":\"boolean\"},\"to\":{\"description\":\"The target branch or commit SHA to compare to\",\"type\":\"string\"}},\"required\":[\"from\",\"to\",\"project_id\"],\"type\":\"object\"},\"name\":\"get_branch_diffs\"}"},{"name":"get_ci_catalog_resource","hash":"283b776980facf4e1f6a4d124d9b9eacf7ed74bce3403afae6d8e8ccc49c2686","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details for a GitLab CI/CD Catalog resource, including versions and components. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"component_limit\":{\"description\":\"Number of components per version to include (default: 20, max: 50)\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"component_name\":{\"description\":\"Filter returned components by component name\",\"type\":\"string\"},\"full_path\":{\"description\":\"CI/CD Catalog resource full project path. Required when id is omitted.\",\"minLength\":1,\"type\":\"string\"},\"id\":{\"description\":\"CI/CD Catalog resource global ID. Required when full_path is omitted.\",\"minLength\":1,\"type\":\"string\"},\"include_readme\":{\"description\":\"Include version README content\",\"type\":\"boolean\"},\"version_limit\":{\"description\":\"Number of versions to include (default: 5, max: 20)\",\"maximum\":20,\"minimum\":1,\"type\":\"integer\"}},\"type\":\"object\"},\"name\":\"get_ci_catalog_resource\"}"},{"name":"get_commit","hash":"02cce135ab0c17cbf8ac4711552e5a7875ad9bbc0a388dddd76501eee9111788","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details of a specific commit. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"sha\":{\"description\":\"The commit hash or name of a repository branch or tag\",\"type\":\"string\"},\"stats\":{\"description\":\"Include commit stats\",\"type\":\"boolean\"}},\"required\":[\"sha\",\"project_id\"],\"type\":\"object\"},\"name\":\"get_commit\"}"},{"name":"get_commit_diff","hash":"a607dd86ca8aef2695f538b7deb48a194fbfe4ba29f0c15713e91366cc89621e","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get changes/diffs of a specific commit. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"full_diff\":{\"description\":\"Whether to return the full diff or only first page (default: false)\",\"type\":\"boolean\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"sha\":{\"description\":\"The commit hash or name of a repository branch or tag\",\"type\":\"string\"}},\"required\":[\"sha\",\"project_id\"],\"type\":\"object\"},\"name\":\"get_commit_diff\"}"},{"name":"get_draft_note","hash":"ff304666ac61bb0043b4d22383f884764e517822e095da4bb53122e687ef4a9d","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get a single draft note from a merge request. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"draft_note_id\":{\"description\":\"The ID of the draft note\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"draft_note_id\"],\"type\":\"object\"},\"name\":\"get_draft_note\"}"},{"name":"get_file_blame","hash":"e6526cd20e7d6acc2adec328d6d2b14b1dd424421d16d904c99aab2dff932c5a","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.\",\"inputSchema\":{\"properties\":{\"file_path\":{\"description\":\"The full path of the file to blame, relative to repo root\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"range_end\":{\"description\":\"Last line of the blame range (inclusive, 1-based). Both range[start] and range[end] must be set together.\",\"type\":\"integer\"},\"range_start\":{\"description\":\"First line of the blame range (inclusive, 1-based). Both range[start] and range[end] must be set together.\",\"type\":\"integer\"},\"ref\":{\"description\":\"The name of branch, tag or commit (required by GitLab blame API)\",\"type\":\"string\"}},\"required\":[\"file_path\",\"ref\"],\"type\":\"object\"},\"name\":\"get_file_blame\"}"},{"name":"get_file_contents","hash":"b87a674dbb8bbb152fc3bf8608560ab5139c908d34c4aa1b3392a93bd1b0dce8","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get contents of a file or directory from a GitLab project. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"file_path\":{\"description\":\"Path to the file or directory. Takes precedence over 'path' when both are provided\",\"type\":\"string\"},\"path\":{\"description\":\"Alias of file_path\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path (optional; falls back to env)\",\"type\":\"string\"},\"ref\":{\"description\":\"Branch/tag/commit to get contents from\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"get_file_contents\"}"},{"name":"get_issue","hash":"c7759992bf0c2fc81eb37a1284361e936085ce9653b6f8054457b8a6af4057dd","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details of a specific issue. Returns a slim milestone by default; set full_response=true for the complete milestone object. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"full_response\":{\"description\":\"If true, return the complete issue object including the full milestone description. Default returns a slim milestone (id, iid, title, state, web_url) to reduce token usage.\",\"type\":\"boolean\"},\"issue_iid\":{\"description\":\"The internal ID of the project issue\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"get_issue\"}"},{"name":"get_issue_link","hash":"13339147ca06adeaa47cc65b50bf28678653d8e81be88503f63ce6287c659186","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get a specific issue link. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The internal ID of a project's issue\",\"type\":\"string\"},\"issue_link_id\":{\"description\":\"ID of an issue relationship\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\",\"issue_link_id\"],\"type\":\"object\"},\"name\":\"get_issue_link\"}"},{"name":"get_label","hash":"15b1ac658754ee42da7b9b758c2fa7634a288bd7129beec060d5beb85f243443","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get a single label from a project. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"include_ancestor_groups\":{\"description\":\"Include ancestor groups\",\"type\":\"boolean\"},\"label_id\":{\"description\":\"The ID or title of a project's label\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"label_id\"],\"type\":\"object\"},\"name\":\"get_label\"}"},{"name":"get_merge_request","hash":"342a4adb7f08dc98c92550c2369ce551a93db6fcf9a062c4cdf697c3855cab84","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details of a merge request (mergeRequestIid or branchName required). Set include_summaries=true for deployment/commit/approval summaries. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"include_summaries\":{\"description\":\"If true, include deployment_summary, commit_addition_summary and approval_summary (extra API calls, larger response). Default false to reduce token usage.\",\"type\":\"boolean\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"source_branch\":{\"description\":\"Source branch name\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"get_merge_request\"}"},{"name":"get_merge_request_approval_state","hash":"703e3792433de334b6e4843804988c13cf3f404adf3c593de72ccee7b940bfda","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get merge request approval details including approvers. Use this to inspect approval rules and approvers before deciding whether a merge request can be merged; use `approve_merge_request` to change approval state. It is read-only and returns the approval-state response, while missing requests, unsupported GitLab versions, and permission failures are reported as errors.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of the merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"get_merge_request_approval_state\"}"},{"name":"get_merge_request_conflicts","hash":"55df4a7548adb09608a6156879cdd36e3c14d27d30d64c83326602697dbb025c","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get the conflicts of a merge request. Use this to inspect merge conflicts before attempting `merge_merge_request`; it reports conflicts and does not resolve them. It is read-only, requires access to the project and merge request, and returns GitLab's conflict data or an error when the request cannot be evaluated.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of the merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"get_merge_request_conflicts\"}"},{"name":"get_merge_request_diffs","hash":"eb19d0bd421a5a7f8e3b427d83a0cbc20d9cc53e82b0df6d37239baab300ba8c","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get the changes/diffs of a merge request (mergeRequestIid or branchName required). Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"excluded_file_patterns\":{\"description\":\"Array of regex patterns to exclude files from the diff results. Each pattern is a JavaScript-compatible regular expression that matches file paths to ignore. Examples: [\\\"^vendor/\\\", \\\"^test/mocks/\\\", \\\"\\\\.spec\\\\.ts$\\\", \\\"package-lock\\\\.json\\\"]\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"source_branch\":{\"description\":\"Source branch name\",\"type\":\"string\"},\"view\":{\"description\":\"Diff view type\",\"enum\":[\"inline\",\"parallel\"],\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"get_merge_request_diffs\"}"},{"name":"get_merge_request_file_diff","hash":"067927a9abde9d85603f56521f5fda225e38cc6beeab96bd498d38256d5c9552","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get diffs for specific files from a merge request (mergeRequestIid or branchName required). Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"file_paths\":{\"description\":\"List of file paths to retrieve diffs for (e.g. ['src/api/users.ts', 'src/repo/user.go']). Call list_merge_request_changed_files first to get the full list of changed paths.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"source_branch\":{\"description\":\"Source branch name\",\"type\":\"string\"},\"unidiff\":{\"description\":\"Present diff in the unified diff format. Default is false.\",\"type\":\"boolean\"}},\"required\":[\"project_id\",\"file_paths\"],\"type\":\"object\"},\"name\":\"get_merge_request_file_diff\"}"},{"name":"get_merge_request_note","hash":"9be4ad50714933f3c92e6ddfb0a1e360a57a61db2450cdbc9bb6c08b2ddaa65e","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get a specific note for a merge request. Use this to fetch one known merge request note by note identifier; use `get_merge_request_notes` for a collection and `mr_discussions` for threaded context. It is read-only and returns the note object or an error for an invalid identifier, missing note, or insufficient permission.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a thread note\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"get_merge_request_note\"}"},{"name":"get_merge_request_notes","hash":"55f4008b83745a6c66616d3ef5776112407b953e762e799ebe3bb9419697dec6","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List notes for a merge request. Use this to list flat notes on a merge request; use `mr_discussions` when thread structure and resolution state are required. It is read-only and returns note records, while invalid identifiers, missing resources, and pagination or permission errors are reported by GitLab.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"order_by\":{\"description\":\"The field to sort the notes by\",\"enum\":[\"created_at\",\"updated_at\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"sort\":{\"description\":\"The sort order of the notes\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"get_merge_request_notes\"}"},{"name":"get_merge_request_version","hash":"182eb7c20be251de731d144b041df9608d2a5851101c048b0ac1d6a30638836d","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get a specific version of a merge request. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The internal ID of the merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"unidiff\":{\"description\":\"Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5.\",\"type\":\"boolean\"},\"version_id\":{\"description\":\"The ID of the merge request diff version\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"version_id\"],\"type\":\"object\"},\"name\":\"get_merge_request_version\"}"},{"name":"get_namespace","hash":"fd8debb03f849a534b396aa169c104cd9641abf3e5a968a1f090508d423ec62d","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"namespace_id\":{\"description\":\"Namespace ID or full path\",\"type\":\"string\"}},\"required\":[\"namespace_id\"],\"type\":\"object\"},\"name\":\"get_namespace\"}"},{"name":"get_project","hash":"aa1b37563f3a9ccb506df95cfa1513116e38c41be83a5c993bc2be1b31c20225","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details of a specific project. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"get_project\"}"},{"name":"get_project_events","hash":"58864903c49293160f8994fe1c8d8fa8716b9132516444c34b87e2b541a83041","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List events for a project (before/after: YYYY-MM-DD). Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"action\":{\"description\":\"If defined, returns events with the specified action type\",\"type\":\"string\"},\"after\":{\"description\":\"If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28\",\"type\":\"string\"},\"before\":{\"description\":\"If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30\",\"type\":\"string\"},\"page\":{\"description\":\"Returns the specified results page. Default: 1\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of results per page. Default: 20\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"},\"sort\":{\"description\":\"Direction to sort the results by creation date. Default: desc\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"target_type\":{\"description\":\"If defined, returns events with the specified target type\",\"enum\":[\"epic\",\"issue\",\"merge_request\",\"milestone\",\"note\",\"project\",\"snippet\",\"user\"],\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"get_project_events\"}"},{"name":"get_protected_branch","hash":"1adca195475c2a8e9ea11ba2ba29f8c848797eb21e048214da0d859c14b9cf63","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get details of a single protected branch (access levels, force push settings). Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"branch_name\":{\"description\":\"Name of the protected branch\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"branch_name\",\"project_id\"],\"type\":\"object\"},\"name\":\"get_protected_branch\"}"},{"name":"get_repository_tree","hash":"a736a7ffc74e6a6c74d3de23e92357e28df3464e27822ffec8198b3ca27897b2","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List files and directories in a repository. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"page_token\":{\"description\":\"Token for keyset pagination. Use the next_page_token value returned in the previous response to retrieve the next page.\",\"type\":\"string\"},\"pagination\":{\"description\":\"Pagination method. Use 'keyset' for keyset-based pagination (required for repositories with many files). Non-keyset calls keep the legacy array response for backward compatibility; that legacy response shape is deprecated and may be removed in a future major release. Keyset calls return a structured response with items and next_page_token when more pages are available.\",\"type\":\"string\"},\"path\":{\"description\":\"The path inside the repository\",\"type\":\"string\"},\"per_page\":{\"description\":\"Number of results to show per page\",\"type\":\"number\"},\"project_id\":{\"description\":\"The ID or URL-encoded path of the project\",\"type\":\"string\"},\"recursive\":{\"description\":\"Boolean value to get a recursive tree\",\"type\":\"boolean\"},\"ref\":{\"description\":\"The name of a repository branch or tag. Defaults to the default branch.\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"get_repository_tree\"}"},{"name":"get_user","hash":"5fd11018eabc6545f1d0605dd9f37fbb2572144c4ee6b41ae98c3a4d3a266dee","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get user details by ID. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"user_id\":{\"description\":\"The ID of the user\",\"type\":\"string\"}},\"required\":[\"user_id\"],\"type\":\"object\"},\"name\":\"get_user\"}"},{"name":"get_users","hash":"e3f5182b693acc40292000c8e660c6342aa310ae8679397f57870c127cab41c5","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get GitLab user details by usernames. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"usernames\":{\"description\":\"Array of usernames to search for\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"usernames\"],\"type\":\"object\"},\"name\":\"get_users\"}"},{"name":"health_check","hash":"2e3e470fada55be419ec347a3660502af19993813540776ad6e89dd907da3ebc","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Verify server status and authentication. When authenticated, also reports the GitLab instance version from GET /api/v4/version (version, revision, enterprise). Version lookup failures do not fail the health check — those fields are omitted. Use this to verify server connectivity and authentication before making GitLab requests; use `whoami` when the authenticated user's identity is the goal. It does not mutate GitLab state and returns server/authentication status plus GitLab version details when available.\",\"inputSchema\":{\"properties\":{},\"type\":\"object\"},\"name\":\"health_check\"}"},{"name":"list_branches","hash":"93d4d58369987ec7e9fbb884e1a47bde25e39694d85f918285b811beb43a9626","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List branches in project with search filter. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"search\":{\"description\":\"Search term to filter branches by name\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_branches\"}"},{"name":"list_ci_catalog_resources","hash":"ee002dfdba7b44890f8fa2dfbee45a7463e973cf5d6224bd32daa823bf3f175f","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List GitLab CI/CD Catalog resources/components visible to the user. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"after\":{\"description\":\"GraphQL cursor for the next page\",\"type\":\"string\"},\"first\":{\"description\":\"Number of resources to return (default: 20, max: 100)\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"group_ids\":{\"description\":\"Filter to catalog resources in these group IDs\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"scope\":{\"description\":\"Catalog resource scope\",\"enum\":[\"ALL\",\"NAMESPACES\"],\"type\":\"string\"},\"search\":{\"description\":\"Search catalog resources by name or description\",\"type\":\"string\"},\"sort\":{\"description\":\"Sort order\",\"enum\":[\"CREATED_ASC\",\"CREATED_DESC\",\"LATEST_RELEASED_AT_ASC\",\"LATEST_RELEASED_AT_DESC\",\"NAME_ASC\",\"NAME_DESC\",\"STAR_COUNT_ASC\",\"STAR_COUNT_DESC\",\"USAGE_COUNT_ASC\",\"USAGE_COUNT_DESC\"],\"type\":\"string\"},\"topics\":{\"description\":\"Filter by project topic names\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"verification_level\":{\"description\":\"Filter by verification level\",\"enum\":[\"GITLAB_MAINTAINED\",\"GITLAB_PARTNER_MAINTAINED\",\"UNVERIFIED\",\"VERIFIED_CREATOR_MAINTAINED\",\"VERIFIED_CREATOR_SELF_MANAGED\"],\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"list_ci_catalog_resources\"}"},{"name":"list_commit_statuses","hash":"1577e4d97fc1363cef4c128c16f2a7497cf124a20aa16d23012d775f9c8059a1","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List statuses for a commit. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"all\":{\"description\":\"Return all statuses, not only latest ones\",\"type\":\"boolean\"},\"name\":{\"description\":\"Filter statuses by status name or context\",\"type\":\"string\"},\"order_by\":{\"description\":\"Field to order statuses by\",\"enum\":[\"id\",\"pipeline_id\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"pipeline_id\":{\"description\":\"Filter statuses by pipeline ID\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"ref\":{\"description\":\"Filter statuses by Git ref\",\"type\":\"string\"},\"sha\":{\"description\":\"The commit hash or name of a repository branch or tag\",\"type\":\"string\"},\"sort\":{\"description\":\"Sort direction\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"stage\":{\"description\":\"Filter statuses by build stage\",\"type\":\"string\"}},\"required\":[\"sha\",\"project_id\"],\"type\":\"object\"},\"name\":\"list_commit_statuses\"}"},{"name":"list_commits","hash":"7dd26cf71638e47883d5f49d0b9335b4e518ddaaa761788b60d0df69919286ae","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List repository commits with filtering options. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"all\":{\"description\":\"Retrieve every commit from the repository\",\"type\":\"boolean\"},\"author\":{\"description\":\"Search commits by commit author\",\"type\":\"string\"},\"first_parent\":{\"description\":\"Follow only the first parent commit upon seeing a merge commit\",\"type\":\"boolean\"},\"order\":{\"description\":\"List commits in order\",\"enum\":[\"default\",\"topo\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"path\":{\"description\":\"The file path\",\"type\":\"string\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"ref_name\":{\"description\":\"The name of a repository branch, tag or revision range, or if not given the default branch\",\"type\":\"string\"},\"since\":{\"description\":\"Only commits after or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ\",\"type\":\"string\"},\"trailers\":{\"description\":\"Parse and include Git trailers for every commit\",\"type\":\"boolean\"},\"until\":{\"description\":\"Only commits before or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ\",\"type\":\"string\"},\"with_stats\":{\"description\":\"Stats about each commit are added to the response\",\"type\":\"boolean\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_commits\"}"},{"name":"list_draft_notes","hash":"3fd2d898b9f64ef0f11fd993279c48ad93b601e43c44fddbbc43a17aa1815d13","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List draft notes for a merge request. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"list_draft_notes\"}"},{"name":"list_events","hash":"ad37abe5b2344d36695faedb5968fb0378c02c94101ddcd47d9634e97a2384e4","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List events for the authenticated user (before/after: YYYY-MM-DD). Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"action\":{\"description\":\"If defined, returns events with the specified action type\",\"type\":\"string\"},\"after\":{\"description\":\"If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28\",\"type\":\"string\"},\"before\":{\"description\":\"If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30\",\"type\":\"string\"},\"page\":{\"description\":\"Returns the specified results page. Default: 1\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of results per page. Default: 20\",\"type\":\"number\"},\"scope\":{\"description\":\"Include all events across a user's projects\",\"type\":\"string\"},\"sort\":{\"description\":\"Direction to sort the results by creation date. Default: desc\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"target_type\":{\"description\":\"If defined, returns events with the specified target type\",\"enum\":[\"epic\",\"issue\",\"merge_request\",\"milestone\",\"note\",\"project\",\"snippet\",\"user\"],\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"list_events\"}"},{"name":"list_group_iterations","hash":"aa2ada6b0513ea22c63d0e899cdf050117032662239e147214425167266c0b3b","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List group iterations with filtering options. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"group_id\":{\"description\":\"Group ID or URL-encoded path\",\"type\":\"string\"},\"include_ancestors\":{\"description\":\"Include iterations for group and its ancestors. Defaults to true.\",\"type\":\"boolean\"},\"include_descendants\":{\"description\":\"Include iterations for group and its descendants. Defaults to false.\",\"type\":\"boolean\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"search\":{\"description\":\"Return only iterations with a title matching the provided string.\",\"type\":\"string\"},\"search_in\":{\"description\":\"Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title].\",\"items\":{\"enum\":[\"title\",\"cadence_title\"],\"type\":\"string\"},\"type\":\"array\"},\"state\":{\"description\":\"Return opened, upcoming, current, closed, or all iterations.\",\"enum\":[\"opened\",\"upcoming\",\"current\",\"closed\",\"all\"],\"type\":\"string\"},\"updated_after\":{\"description\":\"Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z).\",\"type\":\"string\"},\"updated_before\":{\"description\":\"Return only iterations updated before the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z).\",\"type\":\"string\"}},\"required\":[\"group_id\"],\"type\":\"object\"},\"name\":\"list_group_iterations\"}"},{"name":"list_group_members","hash":"974978b16e3f008f71d2724ede3dce677d6697715fe8b4fcb0a430498b3f5fa8","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List members of a GitLab group with optional name or username search. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"group_id\":{\"description\":\"Group ID or URL-encoded path\",\"type\":\"string\"},\"include_inheritance\":{\"description\":\"Include inherited members. Defaults to false.\",\"type\":\"boolean\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (default: 20, max: 100)\",\"type\":\"number\"},\"query\":{\"description\":\"Search for members by name or username\",\"type\":\"string\"},\"skip_users\":{\"description\":\"User IDs to exclude\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"user_ids\":{\"description\":\"Filter by user IDs\",\"items\":{\"type\":\"number\"},\"type\":\"array\"}},\"required\":[\"group_id\"],\"type\":\"object\"},\"name\":\"list_group_members\"}"},{"name":"list_group_merge_requests","hash":"aac942918568459ae3428b45c29e800f5717b7009cc90a65d859ff041bb4b58f","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List merge requests across all projects of a group and its subgroups. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"approved_by_usernames\":{\"description\":\"Returns merge requests approved by the given usernames (array).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"assignee_id\":{\"description\":\"Return MRs assigned to the given user ID (integer), 'none', or 'any'. Mutually exclusive with assignee_username.\",\"type\":\"string\"},\"assignee_username\":{\"description\":\"Returns merge requests assigned to the given username. Mutually exclusive with assignee_id.\",\"type\":\"string\"},\"author_id\":{\"description\":\"Returns merge requests created by the given user ID (integer). Mutually exclusive with author_username.\",\"type\":\"string\"},\"author_username\":{\"description\":\"Returns merge requests created by the given username. Mutually exclusive with author_id.\",\"type\":\"string\"},\"created_after\":{\"description\":\"Return merge requests created after the given time\",\"type\":\"string\"},\"created_before\":{\"description\":\"Return merge requests created before the given time\",\"type\":\"string\"},\"group_id\":{\"description\":\"Group ID or URL-encoded path\",\"type\":\"string\"},\"labels\":{\"description\":\"Array of label names\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"milestone\":{\"description\":\"Milestone title\",\"type\":\"string\"},\"non_archived\":{\"description\":\"Return merge requests from non-archived projects only. Defaults to true.\",\"type\":\"boolean\"},\"order_by\":{\"description\":\"Return merge requests ordered by the given field\",\"enum\":[\"created_at\",\"updated_at\",\"priority\",\"label_priority\",\"milestone_due\",\"popularity\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"reviewer_id\":{\"description\":\"Returns merge requests which have the user as a reviewer. Must be an integer, 'none', or 'any'. Mutually exclusive with reviewer_username.\",\"type\":\"string\"},\"reviewer_username\":{\"description\":\"Returns merge requests which have the user as a reviewer by username. Mutually exclusive with reviewer_id.\",\"type\":\"string\"},\"scope\":{\"description\":\"Return merge requests from a specific scope\",\"enum\":[\"created_by_me\",\"assigned_to_me\",\"all\"],\"type\":\"string\"},\"search\":{\"description\":\"Search for specific terms\",\"type\":\"string\"},\"sort\":{\"description\":\"Return merge requests sorted in ascending or descending order\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"source_branch\":{\"description\":\"Return merge requests from a specific source branch\",\"type\":\"string\"},\"source_project_id\":{\"description\":\"Return merge requests with the given source project ID\",\"type\":\"string\"},\"state\":{\"description\":\"Return merge requests with a specific state\",\"enum\":[\"opened\",\"closed\",\"locked\",\"merged\",\"all\"],\"type\":\"string\"},\"target_branch\":{\"description\":\"Return merge requests targeting a specific branch\",\"type\":\"string\"},\"updated_after\":{\"description\":\"Return merge requests updated after the given time\",\"type\":\"string\"},\"updated_before\":{\"description\":\"Return merge requests updated before the given time\",\"type\":\"string\"},\"wip\":{\"description\":\"Filter merge requests against their wip status\",\"enum\":[\"yes\",\"no\"],\"type\":\"string\"},\"with_labels_details\":{\"description\":\"Return more details for each label\",\"type\":\"boolean\"}},\"required\":[\"group_id\"],\"type\":\"object\"},\"name\":\"list_group_merge_requests\"}"},{"name":"list_group_projects","hash":"0a1597da650a37c38ec7e4b9e5c883fa1bdb87cb2f6920338fdbc213327dd2aa","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List projects in a group. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"archived\":{\"description\":\"Filter for archived projects\",\"type\":\"boolean\"},\"group_id\":{\"description\":\"Group ID or path\",\"type\":\"string\"},\"include_subgroups\":{\"description\":\"Include projects from subgroups\",\"type\":\"boolean\"},\"min_access_level\":{\"description\":\"Filter by minimum access level\",\"type\":\"number\"},\"order_by\":{\"description\":\"Field to sort by\",\"enum\":[\"name\",\"path\",\"created_at\",\"updated_at\",\"last_activity_at\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"search\":{\"description\":\"Search term to filter projects\",\"type\":\"string\"},\"sort\":{\"description\":\"Sort direction\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"starred\":{\"description\":\"Filter by starred projects\",\"type\":\"boolean\"},\"statistics\":{\"description\":\"Include project statistics\",\"type\":\"boolean\"},\"topic\":{\"description\":\"Filter by topic (projects tagged with this topic)\",\"type\":\"string\"},\"visibility\":{\"description\":\"Filter by project visibility\",\"enum\":[\"public\",\"internal\",\"private\"],\"type\":\"string\"},\"with_custom_attributes\":{\"description\":\"Include custom attributes\",\"type\":\"boolean\"},\"with_issues_enabled\":{\"description\":\"Filter projects with issues feature enabled\",\"type\":\"boolean\"},\"with_merge_requests_enabled\":{\"description\":\"Filter projects with merge requests feature enabled\",\"type\":\"boolean\"},\"with_programming_language\":{\"description\":\"Filter by programming language\",\"type\":\"string\"},\"with_security_reports\":{\"description\":\"Include security reports\",\"type\":\"boolean\"}},\"required\":[\"group_id\"],\"type\":\"object\"},\"name\":\"list_group_projects\"}"},{"name":"list_issue_discussions","hash":"8bac4128d49c8e64e2caf812725f3ea49676cd7ee36f522d4a47d3dda4d2dc25","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List discussions for an issue. Use this to inspect threaded discussions for an issue; use `list_issues` for issue records and `get_issue` for one issue's fields. It is read-only and returns discussion items, while invalid identifiers, missing issues, and permission failures are reported as errors.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The internal ID of the project issue\",\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"list_issue_discussions\"}"},{"name":"list_issue_emoji_reactions","hash":"ed7eba495096e9582b9cff4679353ae66d763a3ac1158d0bc7387945724cb93b","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all emoji reactions on an issue. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"list_issue_emoji_reactions\"}"},{"name":"list_issue_links","hash":"01ece275a79495be28873457c487570572780373850718016f32ce738dceab48","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all issue links for a specific issue. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"issue_iid\":{\"description\":\"The internal ID of a project's issue\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"list_issue_links\"}"},{"name":"list_issue_note_emoji_reactions","hash":"5bf263a642b8545473d7e70505d79ee3f48ff826b0f2da5f0911c3967ff8b059","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all emoji reactions on an issue note. Pass discussion_id for discussion thread replies. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"discussion_id\":{\"description\":\"The ID of a discussion thread. Required for notes that are discussion replies; omit for top-level notes.\",\"type\":\"string\"},\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a note (comment or thread reply)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"issue_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"list_issue_note_emoji_reactions\"}"},{"name":"list_issues","hash":"16404c7665137e667b1606302b341d18c77865c1c0cc403aa96ba85eb4b4fc1a","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List issues (default: created by current user; use scope='all' for all). Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"assignee_id\":{\"description\":\"Return issues assigned to the given user ID (user id, none, or any). Mutually exclusive with assignee_username.\",\"type\":\"string\"},\"assignee_username\":{\"description\":\"Return issues assigned to the given username. Mutually exclusive with assignee_id.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"author_id\":{\"description\":\"Return issues created by the given user ID. Mutually exclusive with author_username.\",\"type\":\"string\"},\"author_username\":{\"description\":\"Return issues created by the given username. Mutually exclusive with author_id.\",\"type\":\"string\"},\"confidential\":{\"description\":\"Filter confidential or public issues\",\"type\":\"boolean\"},\"created_after\":{\"description\":\"Return issues created after the given time\",\"type\":\"string\"},\"created_before\":{\"description\":\"Return issues created before the given time\",\"type\":\"string\"},\"due_date\":{\"description\":\"Return issues that have the due date\",\"type\":\"string\"},\"issue_type\":{\"description\":\"Filter to a given type of issue. One of issue, incident, test_case or task\",\"enum\":[\"issue\",\"incident\",\"test_case\",\"task\"],\"type\":\"string\"},\"iteration_id\":{\"description\":\"Return issues assigned to the given iteration ID. None returns issues that do not belong to an iteration. Any returns issues that belong to an iteration. \",\"type\":\"string\"},\"labels\":{\"description\":\"Array of label names\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"milestone\":{\"description\":\"Milestone title\",\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path (optional - if not provided, lists issues across all accessible projects)\",\"type\":\"string\"},\"scope\":{\"description\":\"Return issues from a specific scope\",\"enum\":[\"created_by_me\",\"assigned_to_me\",\"all\"],\"type\":\"string\"},\"search\":{\"description\":\"Search for specific terms\",\"type\":\"string\"},\"state\":{\"description\":\"Return issues with a specific state\",\"enum\":[\"opened\",\"closed\",\"all\"],\"type\":\"string\"},\"updated_after\":{\"description\":\"Return issues updated after the given time\",\"type\":\"string\"},\"updated_before\":{\"description\":\"Return issues updated before the given time\",\"type\":\"string\"},\"with_labels_details\":{\"description\":\"Return more details for each label\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"list_issues\"}"},{"name":"list_labels","hash":"bbb2d342259ec805abc90fd0da76a718c0a1dab6c620bb773a79a13b38d77249","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List labels for a project. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"include_ancestor_groups\":{\"description\":\"Include ancestor groups\",\"type\":\"boolean\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"},\"search\":{\"description\":\"Keyword to filter labels by\",\"type\":\"string\"},\"with_counts\":{\"description\":\"Whether to include issue and merge request counts\",\"type\":\"boolean\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_labels\"}"},{"name":"list_merge_request_changed_files","hash":"027c13c057bddb5e94393c6543734b51e7562ee803a395735c947e2cad0d8857","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List changed file paths in a merge request without diff content (mergeRequestIid or branchName required). Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"excluded_file_patterns\":{\"description\":\"Array of regex patterns to exclude files. Examples: [\\\"^vendor/\\\", \\\"\\\\.pb\\\\.go$\\\"]\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"source_branch\":{\"description\":\"Source branch name\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_merge_request_changed_files\"}"},{"name":"list_merge_request_diffs","hash":"844d6689d5ede953c0848f25b131dc13ceaca06a7d5857658757d60be6e3fcc6","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List merge request diffs with pagination (mergeRequestIid or branchName required). Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"source_branch\":{\"description\":\"Source branch name\",\"type\":\"string\"},\"unidiff\":{\"description\":\"Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5.\",\"type\":\"boolean\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_merge_request_diffs\"}"},{"name":"list_merge_request_emoji_reactions","hash":"eee3de51836afdd47976f69d7e467062bca43a054385d80ca1c1837a95897c83","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all emoji reactions on a merge request. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"list_merge_request_emoji_reactions\"}"},{"name":"list_merge_request_note_emoji_reactions","hash":"b269f91ee3387c19fb554972946878939679a4c24b6636738fc7f975eaffc8a8","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all emoji reactions on a merge request note. Pass discussion_id for discussion thread replies. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"discussion_id\":{\"description\":\"The ID of a discussion thread. Required for notes that are discussion replies; omit for top-level notes.\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a note (comment or thread reply)\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"list_merge_request_note_emoji_reactions\"}"},{"name":"list_merge_request_pipelines","hash":"9c4fc716dd08d036b0482fc4fff04dc0cdb1bd89a6e42c0d612fb04705cdfb35","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List pipelines for a merge request with pagination. Use this to inspect pipelines associated with one merge request; use `list_pipelines` for project-wide pipeline filtering. It is read-only and paginated, requires project access, and returns pipeline records or GitLab errors for invalid identifiers, missing resources, or rate limits.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The internal ID of the merge request\",\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"merge_request_iid\",\"project_id\"],\"type\":\"object\"},\"name\":\"list_merge_request_pipelines\"}"},{"name":"list_merge_request_versions","hash":"1964bff52fc42ce8c5ae1ad16dcc40743bd149b29c6d067fd13833d79c40c3ad","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all versions of a merge request. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The internal ID of the merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"list_merge_request_versions\"}"},{"name":"list_merge_requests","hash":"cd4db35ecd214d39bc82324746cd4d65e12877061e5214c3a9fc52340e7b36a9","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List merge requests (without project_id: user's MRs; with project_id: project MRs). Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"approved_by_usernames\":{\"description\":\"Returns merge requests approved by the given usernames (array).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"assignee_id\":{\"description\":\"Return MRs assigned to the given user ID (integer), 'none', or 'any'. Mutually exclusive with assignee_username.\",\"type\":\"string\"},\"assignee_username\":{\"description\":\"Returns merge requests assigned to the given username. Mutually exclusive with assignee_id.\",\"type\":\"string\"},\"author_id\":{\"description\":\"Returns merge requests created by the given user ID (integer). Mutually exclusive with author_username.\",\"type\":\"string\"},\"author_username\":{\"description\":\"Returns merge requests created by the given username. Mutually exclusive with author_id.\",\"type\":\"string\"},\"created_after\":{\"description\":\"Return merge requests created after the given time\",\"type\":\"string\"},\"created_before\":{\"description\":\"Return merge requests created before the given time\",\"type\":\"string\"},\"labels\":{\"description\":\"Array of label names\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"milestone\":{\"description\":\"Milestone title\",\"type\":\"string\"},\"order_by\":{\"description\":\"Return merge requests ordered by the given field\",\"enum\":[\"created_at\",\"updated_at\",\"priority\",\"label_priority\",\"milestone_due\",\"popularity\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path (optional - if not provided, lists all merge requests the user has access to)\",\"type\":\"string\"},\"reviewer_id\":{\"description\":\"Returns merge requests which have the user as a reviewer. Must be an integer, 'none', or 'any'. Mutually exclusive with reviewer_username.\",\"type\":\"string\"},\"reviewer_username\":{\"description\":\"Returns merge requests which have the user as a reviewer by username. Mutually exclusive with reviewer_id.\",\"type\":\"string\"},\"scope\":{\"description\":\"Return merge requests from a specific scope\",\"enum\":[\"created_by_me\",\"assigned_to_me\",\"all\"],\"type\":\"string\"},\"search\":{\"description\":\"Search for specific terms\",\"type\":\"string\"},\"sort\":{\"description\":\"Return merge requests sorted in ascending or descending order\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"source_branch\":{\"description\":\"Return merge requests from a specific source branch\",\"type\":\"string\"},\"state\":{\"description\":\"Return merge requests with a specific state\",\"enum\":[\"opened\",\"closed\",\"locked\",\"merged\",\"all\"],\"type\":\"string\"},\"target_branch\":{\"description\":\"Return merge requests targeting a specific branch\",\"type\":\"string\"},\"updated_after\":{\"description\":\"Return merge requests updated after the given time\",\"type\":\"string\"},\"updated_before\":{\"description\":\"Return merge requests updated before the given time\",\"type\":\"string\"},\"wip\":{\"description\":\"Filter merge requests against their wip status\",\"enum\":[\"yes\",\"no\"],\"type\":\"string\"},\"with_labels_details\":{\"description\":\"Return more details for each label\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"list_merge_requests\"}"},{"name":"list_namespaces","hash":"de446da737aa5bf03926645526b7f05d0664d6cc98abaece417bfa9faa46db6c","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"owned\":{\"description\":\"Filter for namespaces owned by current user\",\"type\":\"boolean\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"search\":{\"description\":\"Search term for namespaces\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"list_namespaces\"}"},{"name":"list_project_members","hash":"7f6c37f8aaf4714e51e2d4974b5ff4eb295c7bb3f40fde9468a40da0e5d2947f","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List members of a GitLab project. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"include_inheritance\":{\"description\":\"Include inherited members. Defaults to false.\",\"type\":\"boolean\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (default: 20, max: 100)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"},\"query\":{\"description\":\"Search for members by name or username\",\"type\":\"string\"},\"skip_users\":{\"description\":\"User IDs to exclude\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"user_ids\":{\"description\":\"Filter by user IDs\",\"items\":{\"type\":\"number\"},\"type\":\"array\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_project_members\"}"},{"name":"list_projects","hash":"5cd8d0634ef21e515a211a49f71b9cd46a376c3d522b94d39a20db53333c7551","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List projects accessible by the current user. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"archived\":{\"description\":\"Filter for archived projects\",\"type\":\"boolean\"},\"membership\":{\"description\":\"Filter for projects where current user is a member\",\"type\":\"boolean\"},\"min_access_level\":{\"description\":\"Filter by minimum access level\",\"type\":\"number\"},\"order_by\":{\"description\":\"Return projects ordered by field\",\"enum\":[\"id\",\"name\",\"path\",\"created_at\",\"updated_at\",\"last_activity_at\"],\"type\":\"string\"},\"owned\":{\"description\":\"Filter for projects owned by current user\",\"type\":\"boolean\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"search\":{\"description\":\"Search term for projects\",\"type\":\"string\"},\"search_namespaces\":{\"description\":\"Needs to be true if search is full path\",\"type\":\"boolean\"},\"simple\":{\"description\":\"Return only limited fields\",\"type\":\"boolean\"},\"sort\":{\"description\":\"Return projects sorted in ascending or descending order\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"topic\":{\"description\":\"Filter by topic (projects tagged with this topic)\",\"type\":\"string\"},\"visibility\":{\"description\":\"Filter by project visibility\",\"enum\":[\"public\",\"internal\",\"private\"],\"type\":\"string\"},\"with_issues_enabled\":{\"description\":\"Filter projects with issues feature enabled\",\"type\":\"boolean\"},\"with_merge_requests_enabled\":{\"description\":\"Filter projects with merge requests feature enabled\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"list_projects\"}"},{"name":"list_protected_branches","hash":"06602586b43855eea73e686a44d9b006c87b3a6dc6700bd7a3615a86751c3f95","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List protected branches in a project, supports search filter. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"search\":{\"description\":\"Search term to filter protected branches by name\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"list_protected_branches\"}"},{"name":"list_todos","hash":"1d02109bb4cc025219b888fb6da544350d5dbf9640144f7942334a42d49d7175","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List GitLab to-do items for the current user. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"action\":{\"description\":\"Filter by to-do action\",\"enum\":[\"assigned\",\"mentioned\",\"build_failed\",\"marked\",\"approval_required\",\"unmergeable\",\"directly_addressed\",\"merge_train_removed\",\"member_access_requested\"],\"type\":\"string\"},\"author_id\":{\"description\":\"Filter by author ID\",\"type\":\"number\"},\"group_id\":{\"description\":\"Filter by group ID\",\"type\":\"number\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Filter by project ID\",\"type\":\"number\"},\"state\":{\"description\":\"Filter by to-do state\",\"enum\":[\"pending\",\"done\"],\"type\":\"string\"},\"type\":{\"description\":\"Filter by to-do target type\",\"enum\":[\"Issue\",\"MergeRequest\",\"Commit\",\"Epic\",\"DesignManagement::Design\",\"AlertManagement::Alert\",\"Project\",\"Namespace\",\"Vulnerability\",\"WikiPage::Meta\"],\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"list_todos\"}"},{"name":"mark_all_todos_done","hash":"736a0ff1b962bea17ecae9103aef8cab14e815cf9326c668a70fba9c8d5d107f","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Mark all pending GitLab to-do items as done for the current user. Use this for the specific operation described; choose a sibling tool when you need a different resource or lifecycle action. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{},\"type\":\"object\"},\"name\":\"mark_all_todos_done\"}"},{"name":"mark_todo_done","hash":"608fbe9102ed25a043ba54746c86ca7a6c0c66ab1b51860775eb396d09769a2c","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Mark a GitLab to-do item as done. Use this for the specific operation described; choose a sibling tool when you need a different resource or lifecycle action. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"id\":{\"description\":\"The ID of the to-do item\",\"type\":\"number\"}},\"required\":[\"id\"],\"type\":\"object\"},\"name\":\"mark_todo_done\"}"},{"name":"merge_merge_request","hash":"1253343c1b55c8ad1a7c0ed60d4b31b80802279297e82c828f095cbd2b9e28fc","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Merge a merge request. Use this only after checking the merge request approval, conflict, and pipeline state; use `approve_merge_request` to approve rather than merge. The operation changes repository state and may squash commits, schedule auto-merge, or delete the source branch, so it requires merge permission and returns GitLab's merge result or a mergeability error. Pass `sha` from `get_merge_request` (`sha` or `diff_refs.head_sha`); GitLab 19.2+ groups may reject merges without it.\",\"inputSchema\":{\"properties\":{\"auto_merge\":{\"default\":false,\"description\":\"If true, the merge request merges when the pipeline succeeds.\",\"type\":\"boolean\"},\"merge_commit_message\":{\"description\":\"Custom merge commit message\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"merge_when_pipeline_succeeds\":{\"default\":false,\"description\":\"If true, the merge request merges when the pipeline succeeds. Deprecated in GitLab 17.11. Use `auto_merge` instead.\",\"type\":\"boolean\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"sha\":{\"description\":\"SHA of the source-branch HEAD from get_merge_request (`sha` or `diff_refs.head_sha`). If provided, GitLab merges only when HEAD still matches. GitLab 19.2+ groups may require this (Require a commit SHA on the merge requests API).\",\"type\":\"string\"},\"should_remove_source_branch\":{\"default\":false,\"description\":\"Remove source branch after merge\",\"type\":\"boolean\"},\"squash\":{\"default\":false,\"description\":\"Squash commits into a single commit when merging\",\"type\":\"boolean\"},\"squash_commit_message\":{\"description\":\"Custom squash commit message\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"merge_merge_request\"}"},{"name":"mr_discussions","hash":"e69d0c191b6cc59d630cfa02c9db38205a89c6360b49e06063cc023aa77dd73a","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List discussion items for a merge request. Use this to list complete discussion threads for a merge request; use `get_merge_request_notes` when only flat notes are needed. It is read-only and returns threaded discussion items, while invalid merge request identifiers, missing resources, and permission failures are reported as errors.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"mr_discussions\"}"},{"name":"my_issues","hash":"e7f0424e1d88863d9000cf1abf95df7844a2db24fbe202e849901caad5fc161e","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"List issues assigned to the authenticated user. Use this for the specific operation described; choose a sibling tool when you need a different resource or lifecycle action. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"created_after\":{\"description\":\"Return issues created after the given time (ISO 8601)\",\"type\":\"string\"},\"created_before\":{\"description\":\"Return issues created before the given time (ISO 8601)\",\"type\":\"string\"},\"labels\":{\"description\":\"Array of label names to filter by\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"milestone\":{\"description\":\"Milestone title to filter by\",\"type\":\"string\"},\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (default: 20, max: 100)\",\"type\":\"number\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path (optional to search across all accessible projects)\",\"type\":\"string\"},\"search\":{\"description\":\"Search for specific terms in title and description\",\"type\":\"string\"},\"state\":{\"description\":\"Return issues with a specific state (default: opened)\",\"enum\":[\"opened\",\"closed\",\"all\"],\"type\":\"string\"},\"updated_after\":{\"description\":\"Return issues updated after the given time (ISO 8601)\",\"type\":\"string\"},\"updated_before\":{\"description\":\"Return issues updated before the given time (ISO 8601)\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"my_issues\"}"},{"name":"protect_branch","hash":"1913c764d76fdea674dbc3176e7dda92e65e0cc26e3c1b7894055fc8be3a5ddf","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Protect a repository branch (set push/merge/unprotect access levels). Use this to create or update protection rules for a branch or wildcard; use `get_protected_branch` to inspect existing rules first. The operation changes who may push, merge, or unprotect, may enable force-push or code-owner settings, requires maintainer-level permission, and returns the protection rule or a validation/permission error.\",\"inputSchema\":{\"properties\":{\"allow_force_push\":{\"description\":\"Allow force push to the protected branch. Default: false\",\"type\":\"boolean\"},\"branch_name\":{\"description\":\"Branch name or wildcard pattern to protect\",\"type\":\"string\"},\"code_owner_approval_required\":{\"description\":\"Require code owner approval before merging (PREMIUM). Default: false\",\"type\":\"boolean\"},\"merge_access_level\":{\"description\":\"Access level for merging (0=No access, 30=Developer, 40=Maintainer, 60=Admin). GitLab default applies when omitted.\",\"type\":\"integer\"},\"name\":{\"description\":\"Deprecated alias for branch_name; prefer branch_name for consistency\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"push_access_level\":{\"description\":\"Access level for pushing (0=No access, 30=Developer, 40=Maintainer, 60=Admin). GitLab default applies when omitted.\",\"type\":\"integer\"},\"unprotect_access_level\":{\"description\":\"Access level for unprotecting (0=No access, 30=Developer, 40=Maintainer, 60=Admin). GitLab default applies when omitted.\",\"type\":\"integer\"}},\"required\":[\"branch_name\"],\"type\":\"object\"},\"name\":\"protect_branch\"}"},{"name":"publish_draft_note","hash":"77fb7a1962d7b5dd7fcb613fb8bd42295b354d63da42a74ac2f35961f199b06c","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Publish a single draft note. Use this for the specific operation described; choose a sibling tool when you need a different resource or lifecycle action. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"draft_note_id\":{\"description\":\"The ID of the draft note\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"draft_note_id\"],\"type\":\"object\"},\"name\":\"publish_draft_note\"}"},{"name":"push_files","hash":"4921d6a215cd0babdda7f83b06a10f1eec16aae656a1b39ce93a579910cc1182","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Push multiple files in a single commit. Use this to commit several file changes atomically; use `create_or_update_file` when only one path is involved. Each file defaults to action `create`; optional per-file `action` (create/update/delete/move) and `encoding` (text/base64) are additive. `GITLAB_PERMISSION_MODE=modify` rejects `delete` and `move`. The operation writes repository history on the selected branch, requires repository write permission, and returns the commit result or a validation, conflict, or protected-branch error.\",\"inputSchema\":{\"properties\":{\"branch\":{\"description\":\"Branch to push to\",\"type\":\"string\"},\"commit_message\":{\"description\":\"Commit message\",\"type\":\"string\"},\"files\":{\"description\":\"Array of files to push. Each entry defaults to action 'create'. Per-file fields: action (create/update/delete/move), encoding (text/base64; omitted uses GITLAB_REPO_FILE_ENCODING), previous_path (required for move). Content is required for create and update; omit content for delete, or for a move that should keep the original file. GITLAB_PERMISSION_MODE=modify rejects delete and move.\",\"items\":{\"additionalProperties\":false,\"properties\":{\"action\":{\"description\":\"Commit action for this file. Defaults to 'create'.\",\"enum\":[\"create\",\"update\",\"delete\",\"move\"],\"type\":\"string\"},\"content\":{\"description\":\"File content. Required for create and update. Omit for delete, or for a move that should keep the original content. Base64-encoded when encoding is 'base64'.\",\"type\":\"string\"},\"encoding\":{\"description\":\"Use 'base64' for binary files (content must already be base64-encoded). When omitted, GITLAB_REPO_FILE_ENCODING applies.\",\"enum\":[\"text\",\"base64\"],\"type\":\"string\"},\"file_path\":{\"description\":\"Path of the file in the repo\",\"type\":\"string\"},\"previous_path\":{\"description\":\"Previous path of the file. Required when action is 'move'.\",\"type\":\"string\"}},\"required\":[\"file_path\"],\"type\":\"object\"},\"type\":\"array\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"branch\",\"files\",\"commit_message\",\"project_id\"],\"type\":\"object\"},\"name\":\"push_files\"}"},{"name":"resolve_merge_request_thread","hash":"e4fe479d6152d901d307ecab27e3ec65d470b60836e9e6dc45f78992f19079c6","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Resolve a thread on a merge request. Use this to mark an existing merge request review thread resolved; use `update_merge_request_discussion_note` when the note text itself must change. The operation changes review state, requires permission to resolve discussions, and returns the updated discussion or a missing-thread/permission error.\",\"inputSchema\":{\"properties\":{\"discussion_id\":{\"description\":\"The ID of a thread\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"resolved\":{\"description\":\"Whether to resolve the thread\",\"type\":\"boolean\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"discussion_id\",\"resolved\"],\"type\":\"object\"},\"name\":\"resolve_merge_request_thread\"}"},{"name":"search_repositories","hash":"41ee9fdba4782fb0ea75acd0d0e8b74095b84f45f955bc21cc4058ce636b8de5","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Search for GitLab projects. Use this to discover matching content; choose a typed get or list tool when the target identifier is already known. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"page\":{\"description\":\"Page number for pagination (default: 1)\",\"type\":\"number\"},\"per_page\":{\"description\":\"Number of items per page (max: 100, default: 20)\",\"type\":\"number\"},\"query\":{\"description\":\"Search query (alias for 'search')\",\"type\":\"string\"},\"search\":{\"description\":\"Search query\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"search_repositories\"}"},{"name":"unapprove_merge_request","hash":"b005e83c9912757d7034adfc7e09c7ba28545a6aa68e833a25274bcdc94747a3","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Unapprove a merge request. Use this to remove the current user's approval from an existing merge request; use `merge_merge_request` only when you intend to merge. The operation changes review state and requires approval permission, and GitLab returns the updated result or an error when the request or approval is unavailable.\",\"inputSchema\":{\"properties\":{\"merge_request_iid\":{\"description\":\"The IID of the merge request to unapprove\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"merge_request_iid\"],\"type\":\"object\"},\"name\":\"unapprove_merge_request\"}"},{"name":"unprotect_branch","hash":"8cce9dce27cf46b63df362353185e5dfdcd7cf1c976fa22be265985c4361e819","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Remove protection from a previously protected branch. Use this to remove protection from an existing branch; use `protect_branch` to change access levels without removing the rule. The operation changes repository security controls, requires permission to manage protected branches, and returns the result or an error when the branch is missing or policy forbids the change.\",\"inputSchema\":{\"properties\":{\"branch_name\":{\"description\":\"Name of the protected branch to unprotect\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"branch_name\",\"project_id\"],\"type\":\"object\"},\"name\":\"unprotect_branch\"}"},{"name":"update_default_branch","hash":"be634a4d5405a25f0bc253c08ae46ccc88b2216aeaecf407caffa00af08e0db6","canonical_json":"{\"annotations\":{\"destructiveHint\":true,\"openWorldHint\":true},\"description\":\"Change the default branch of a project. Use this to change which branch GitLab treats as the project's default; use `create_branch` to create a branch rather than changing project defaults. The operation changes project settings and may affect clone, merge request, and CI defaults, requires project-maintainer permission, and returns the updated project or a validation/permission error.\",\"inputSchema\":{\"properties\":{\"default_branch\":{\"description\":\"The new default branch name for the project\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"default_branch\",\"project_id\"],\"type\":\"object\"},\"name\":\"update_default_branch\"}"},{"name":"update_draft_note","hash":"a88c451d698c9ba2fec00c05eacebb5a43c46bb2c03975b5a80c8b1ecad50210","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Update an existing draft note. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the draft note\",\"type\":\"string\"},\"draft_note_id\":{\"description\":\"The ID of the draft note\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"position\":{\"description\":\"Position when creating a diff note\",\"properties\":{\"base_sha\":{\"description\":\"REQUIRED: Base commit SHA in the source branch. Get this from merge request diff_refs.base_sha.\",\"type\":\"string\"},\"head_sha\":{\"description\":\"REQUIRED: SHA referencing HEAD of the source branch. Get this from merge request diff_refs.head_sha.\",\"type\":\"string\"},\"height\":{\"description\":\"IMAGE DIFFS ONLY: Height of the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"line_range\":{\"anyOf\":[{\"description\":\"Line range for multiline comments on GitLab merge request diffs. VALIDATION RULES: 1) line_code is critical for GitLab API success, 2) start/end must have consistent types, 3) line numbers must form valid range, 4) get line_code from GitLab diff API, never generate manually.\",\"properties\":{\"end\":{\"description\":\"End line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither. Range must be valid (end >= start).\",\"properties\":{\"line_code\":{\"description\":\"CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_12_17'. Must be from same file as start.line_code.\",\"type\":[\"string\",\"null\"]},\"new_line\":{\"description\":\"Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines. MUST be >= start.new_line if both specified.\",\"type\":[\"number\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines. MUST be >= start.old_line if both specified.\",\"type\":[\"number\",\"null\"]},\"type\":{\"anyOf\":[{\"enum\":[\"new\",\"old\",\"expanded\",\"logic\",\"style\"],\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. SHOULD MATCH start.type for consistent ranges (don't mix old/new types).\"}},\"type\":\"object\"},\"start\":{\"description\":\"Start line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither.\",\"properties\":{\"line_code\":{\"description\":\"CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_10_15'. Get this from GitLab diff API response, never fabricate.\",\"type\":[\"string\",\"null\"]},\"new_line\":{\"description\":\"Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines.\",\"type\":[\"number\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines.\",\"type\":[\"number\",\"null\"]},\"type\":{\"anyOf\":[{\"enum\":[\"new\",\"old\",\"expanded\",\"logic\",\"style\"],\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. MUST match the line_code format and old_line/new_line values.\"}},\"type\":\"object\"}},\"required\":[\"start\",\"end\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line.\"},\"new_line\":{\"description\":\"Line number in modified file (after changes). Use for added lines or context lines. NULL for deleted lines. For single-line comments on new lines.\",\"type\":[\"number\",\"null\"]},\"new_path\":{\"description\":\"File path after changes. REQUIRED for most diff comments. Use same as old_path if file wasn't renamed.\",\"type\":[\"string\",\"null\"]},\"old_line\":{\"description\":\"Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines.\",\"type\":[\"number\",\"null\"]},\"old_path\":{\"description\":\"File path before changes. REQUIRED for most diff comments. Use same as new_path if file wasn't renamed.\",\"type\":[\"string\",\"null\"]},\"position_type\":{\"description\":\"REQUIRED: Position type. Use 'text' for code diffs, 'image' for image diffs, 'file' for file-level comments.\",\"enum\":[\"text\",\"image\",\"file\"],\"type\":\"string\"},\"start_sha\":{\"description\":\"REQUIRED: SHA referencing the start commit of the source branch. Get this from merge request diff_refs.start_sha.\",\"type\":\"string\"},\"width\":{\"description\":\"IMAGE DIFFS ONLY: Width of the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"x\":{\"description\":\"IMAGE DIFFS ONLY: X coordinate on the image (for position_type='image').\",\"type\":[\"number\",\"null\"]},\"y\":{\"description\":\"IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image').\",\"type\":[\"number\",\"null\"]}},\"required\":[\"base_sha\",\"head_sha\",\"start_sha\",\"position_type\"],\"type\":\"object\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"resolve_discussion\":{\"description\":\"Whether to resolve the discussion when publishing\",\"type\":\"boolean\"}},\"required\":[\"project_id\",\"merge_request_iid\",\"draft_note_id\"],\"type\":\"object\"},\"name\":\"update_draft_note\"}"},{"name":"update_issue","hash":"129b56ff4273d76cad949015e0ea7dbab1c5db4b3f612b21ff16aa22a61bc532","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Update an issue. Returns a slim confirmation by default; set full_response=true for the complete updated issue object. Use this to change fields on an existing issue; use `update_issue_description_patch` for a targeted description edit that avoids sending the full body, and use `create_issue_note` for discussion. The operation mutates issue state, requires issue-edit permission, and returns the updated issue or a validation/permission/conflict error.\",\"inputSchema\":{\"properties\":{\"assignee_ids\":{\"description\":\"Array of user IDs to assign issue to\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"confidential\":{\"description\":\"Set the issue to be confidential\",\"type\":\"boolean\"},\"description\":{\"description\":\"The description of the issue\",\"type\":\"string\"},\"discussion_locked\":{\"description\":\"Flag to lock discussions\",\"type\":\"boolean\"},\"due_date\":{\"description\":\"Date the issue is due (YYYY-MM-DD)\",\"type\":\"string\"},\"full_response\":{\"description\":\"If true, return the complete updated issue object. Default returns a slim confirmation (iid, title, state, web_url, updated_at) to reduce token usage.\",\"type\":\"boolean\"},\"issue_iid\":{\"description\":\"The internal ID of the project issue\",\"type\":\"string\"},\"issue_type\":{\"description\":\"The type of issue. One of issue, incident, test_case or task.\",\"enum\":[\"issue\",\"incident\",\"test_case\",\"task\"],\"type\":\"string\"},\"labels\":{\"description\":\"Array of label names\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"milestone_id\":{\"description\":\"Milestone ID to assign\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"},\"state_event\":{\"description\":\"Update issue state (close/reopen)\",\"enum\":[\"close\",\"reopen\"],\"type\":\"string\"},\"title\":{\"description\":\"The title of the issue\",\"type\":\"string\"},\"weight\":{\"description\":\"Weight of the issue (numeric, typically hours of work)\",\"type\":\"number\"}},\"required\":[\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"update_issue\"}"},{"name":"update_issue_description_patch","hash":"fb6199fc9bd07a84f15a973f4160c2dc816bbcc2fee8f82e78f82aab49126bbc","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by allowing small changes without sending the full description. Supports dry_run to preview changes and create_note to summarize updates. Use this for a targeted search/replace or unified-diff change to an issue description; use `dry_run` before applying an uncertain patch and `create_note` when an audit summary is wanted. It changes the issue description when not dry-running, requires issue-edit permission, and returns the patch result or a mismatch/validation/permission error.\",\"inputSchema\":{\"properties\":{\"allow_multiple\":{\"description\":\"For search_replace: allow multiple matches to all be replaced (default: false — fail on duplicate)\",\"type\":\"boolean\"},\"create_note\":{\"description\":\"If true, add a note summarizing the change after update\",\"type\":\"boolean\"},\"dry_run\":{\"description\":\"If true, preview changes without updating the issue\",\"type\":\"boolean\"},\"issue_iid\":{\"description\":\"The internal ID of the project issue\",\"type\":\"string\"},\"patch\":{\"description\":\"The patch content to apply to the issue description\",\"maxLength\":50000,\"minLength\":1,\"type\":\"string\"},\"patch_type\":{\"description\":\"Type of patch format to apply\",\"enum\":[\"search_replace\",\"unified_diff\"],\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"patch_type\",\"patch\",\"project_id\",\"issue_iid\"],\"type\":\"object\"},\"name\":\"update_issue_description_patch\"}"},{"name":"update_issue_note","hash":"3145fc61b750c2eedda5e2cf3899aed63b5b544c7042f14b319ec8c40caee0b7","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Modify an existing issue thread note. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the note or reply\",\"type\":\"string\"},\"discussion_id\":{\"description\":\"The ID of a thread\",\"type\":\"string\"},\"issue_iid\":{\"description\":\"The IID of an issue\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a thread note\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"resolved\":{\"description\":\"Resolve or unresolve the note\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"update_issue_note\"}"},{"name":"update_label","hash":"5bf735f01e2394043be28fb6c1bc7ca58a5e2ec7f921313583e5cacc494a3758","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Update an existing label in a project. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"color\":{\"description\":\"The color of the label given in 6-digit hex notation with leading '#' sign\",\"type\":\"string\"},\"description\":{\"description\":\"The new description of the label\",\"type\":\"string\"},\"label_id\":{\"description\":\"The ID or title of a project's label\",\"type\":\"string\"},\"new_name\":{\"description\":\"The new name of the label\",\"type\":\"string\"},\"priority\":{\"description\":\"The new priority of the label\",\"type\":[\"number\",\"null\"]},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\",\"label_id\"],\"type\":\"object\"},\"name\":\"update_label\"}"},{"name":"update_merge_request","hash":"2d3970b01b92ee21d1e41d3de3caafe76d381406d5b068fcbbd4a038f107e984","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Update a merge request (mergeRequestIid or branchName required). Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"assignee_ids\":{\"description\":\"The ID of the users to assign the MR to\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"description\":{\"description\":\"The description of the merge request\",\"type\":\"string\"},\"draft\":{\"description\":\"Work in progress merge request\",\"type\":\"boolean\"},\"labels\":{\"description\":\"Labels for the MR\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"milestone_id\":{\"description\":\"Milestone ID to assign. Set to 0 to unassign. Null is treated as omitted.\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"remove_source_branch\":{\"description\":\"Flag indicating if the source branch should be removed\",\"type\":\"boolean\"},\"reviewer_ids\":{\"description\":\"The ID of the users to assign as reviewers of the MR\",\"items\":{\"type\":\"number\"},\"type\":\"array\"},\"source_branch\":{\"description\":\"Source branch name\",\"type\":\"string\"},\"squash\":{\"description\":\"Squash commits into a single commit when merging\",\"type\":\"boolean\"},\"state_event\":{\"description\":\"New state (close/reopen) for the MR\",\"enum\":[\"close\",\"reopen\"],\"type\":\"string\"},\"target_branch\":{\"description\":\"The target branch\",\"type\":\"string\"},\"title\":{\"description\":\"The title of the merge request\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"update_merge_request\"}"},{"name":"update_merge_request_discussion_note","hash":"831642f724dc07dcf797e62d4e9b71fdf2f172d8b796e860235c385364fcc653","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Update a discussion note on a merge request. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the note or reply\",\"type\":\"string\"},\"discussion_id\":{\"description\":\"The ID of a thread\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a thread note\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"resolved\":{\"description\":\"Resolve or unresolve the note\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"update_merge_request_discussion_note\"}"},{"name":"update_merge_request_note","hash":"10d2c8650222123bc2b32b1f05fdb2468d1b92754049cfb5714c45e24337e188","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Modify an existing merge request note. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"body\":{\"description\":\"The content of the note or reply\",\"type\":\"string\"},\"merge_request_iid\":{\"description\":\"The IID of a merge request\",\"type\":\"string\"},\"note_id\":{\"description\":\"The ID of a thread note\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"}},\"required\":[\"body\",\"project_id\",\"merge_request_iid\",\"note_id\"],\"type\":\"object\"},\"name\":\"update_merge_request_note\"}"},{"name":"update_project","hash":"e0718b117635e4435b449bd64ca6c2a2066387b8893be2e768af08046c5afca8","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Update project settings such as description, visibility, default branch, and feature access levels. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"builds_access_level\":{\"description\":\"CI/CD pipelines feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"container_registry_access_level\":{\"description\":\"Container registry feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"default_branch\":{\"description\":\"Default branch name\",\"type\":\"string\"},\"description\":{\"description\":\"Project description\",\"type\":\"string\"},\"environments_access_level\":{\"description\":\"Environments feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"forking_access_level\":{\"description\":\"Forking feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"issues_access_level\":{\"description\":\"Issues feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"merge_method\":{\"description\":\"Merge method\",\"enum\":[\"merge\",\"rebase_merge\",\"ff\"],\"type\":\"string\"},\"merge_requests_access_level\":{\"description\":\"Merge requests feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"name\":{\"description\":\"Project display name\",\"type\":\"string\"},\"only_allow_merge_if_all_discussions_are_resolved\":{\"description\":\"Require all discussions to be resolved before merge\",\"type\":\"boolean\"},\"only_allow_merge_if_pipeline_succeeds\":{\"description\":\"Require successful pipeline before merge\",\"type\":\"boolean\"},\"package_registry_access_level\":{\"description\":\"Package registry feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"pages_access_level\":{\"description\":\"Pages feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\",\"public\"],\"type\":\"string\"},\"path\":{\"description\":\"Project path/slug\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or complete URL-encoded path to project\",\"type\":\"string\"},\"remove_source_branch_after_merge\":{\"description\":\"Remove source branches after merge by default\",\"type\":\"boolean\"},\"request_access_enabled\":{\"description\":\"Allow users to request access\",\"type\":\"boolean\"},\"snippets_access_level\":{\"description\":\"Snippets feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"},\"squash_option\":{\"description\":\"Squash commits setting\",\"enum\":[\"never\",\"always\",\"default_on\",\"default_off\"],\"type\":\"string\"},\"topics\":{\"description\":\"Project topics\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"visibility\":{\"description\":\"Project visibility\",\"enum\":[\"private\",\"internal\",\"public\"],\"type\":\"string\"},\"wiki_access_level\":{\"description\":\"Wiki feature visibility\",\"enum\":[\"disabled\",\"private\",\"enabled\"],\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"update_project\"}"},{"name":"upload_markdown","hash":"69be61682708a7e0f2b6c52e87dac8520ecc1c155a6516869b331564c139157b","canonical_json":"{\"annotations\":{\"openWorldHint\":true},\"description\":\"Upload a file for use in markdown content. Use this for the specific operation described; choose a sibling tool when you need a different resource or lifecycle action. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"file_path\":{\"description\":\"Path to the file to upload\",\"type\":\"string\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path of the project\",\"type\":\"string\"}},\"required\":[\"project_id\",\"file_path\"],\"type\":\"object\"},\"name\":\"upload_markdown\"}"},{"name":"validate_ci_lint","hash":"fbbfef4a56fc62389415e29bb9543f4a728090a1b0c68e50c847556425f3be37","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Validate provided GitLab CI/CD YAML content for a project. Use this to check configuration without applying it; choose a create or update tool only after validation succeeds. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"content\":{\"description\":\"GitLab CI/CD YAML content to validate\",\"type\":\"string\"},\"dry_run\":{\"description\":\"Run pipeline creation simulation\",\"type\":\"boolean\"},\"include_jobs\":{\"description\":\"Include jobs in the lint response\",\"type\":\"boolean\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"},\"ref\":{\"description\":\"Branch or tag context for dry_run validation\",\"type\":\"string\"}},\"required\":[\"content\",\"project_id\"],\"type\":\"object\"},\"name\":\"validate_ci_lint\"}"},{"name":"validate_project_ci_lint","hash":"d8bd5993e322afc8a5d9ae4cee369a2ddbf4f1baaf246159220b1ff97ce55db9","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Validate an existing .gitlab-ci.yml configuration for a project. Use this to check configuration without applying it; choose a create or update tool only after validation succeeds. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When `project_id` or `group_id` is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.\",\"inputSchema\":{\"properties\":{\"content_ref\":{\"description\":\"Commit SHA, branch, or tag to read the existing CI config from\",\"type\":\"string\"},\"dry_run\":{\"description\":\"Run pipeline creation simulation\",\"type\":\"boolean\"},\"dry_run_ref\":{\"description\":\"Branch or tag context for dry_run validation\",\"type\":\"string\"},\"include_jobs\":{\"description\":\"Include jobs in the lint response\",\"type\":\"boolean\"},\"project_id\":{\"description\":\"Project ID or URL-encoded path\",\"type\":\"string\"}},\"required\":[\"project_id\"],\"type\":\"object\"},\"name\":\"validate_project_ci_lint\"}"},{"name":"verify_namespace","hash":"574aea64dd7e56e6bdf8265d2639da957a522e518887dd729fb8a2bb7cdcdaaa","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Verify if a namespace path exists. Use parent_id to scope the check to a specific parent namespace — required for nested namespaces where the same path may exist under different parents.\",\"inputSchema\":{\"properties\":{\"parent_id\":{\"description\":\"Parent namespace ID; required to correctly resolve paths in nested namespaces where the same path may exist under different parents\",\"type\":\"integer\"},\"path\":{\"description\":\"Namespace path to verify\",\"type\":\"string\"}},\"required\":[\"path\"],\"type\":\"object\"},\"name\":\"verify_namespace\"}"},{"name":"whoami","hash":"1023442fa24056a07743d2b8482806db6ba42c619af8e03cb896a8f59227ae6f","canonical_json":"{\"annotations\":{\"openWorldHint\":true,\"readOnlyHint\":true},\"description\":\"Get current authenticated user details. Use this to identify the authenticated GitLab user; use `get_user` or `get_users` when looking up another user. It is read-only and returns the current user profile, while missing credentials or GitLab permission failures are reported as errors.\",\"inputSchema\":{\"properties\":{},\"type\":\"object\"},\"name\":\"whoami\"}"}],"entry_hash":"c630274de0214623b39d3a135c781c91cbc065f9e3db55202d22945aac4800cf"} {"seq":2,"prev_entry_hash":"c630274de0214623b39d3a135c781c91cbc065f9e3db55202d22945aac4800cf","observed_at":"2026-09-02T07:54:53.504Z","server_id":"3a4463759a3d1629","server_name":"@currents/mcp","source":"npm","set_hash":"9fa88fe3d776dcf1ff620b47dbfc640462d50901f5e4172d4dd5bb4fb228a754","tools":[{"name":"currents-cancel-run","hash":"d7272f1fe6e3be04e099f0ed88d069bc06250685fe6813cfa7b768453291ed3c","canonical_json":"{\"description\":\"Cancel a run in progress. This will stop the run and mark it as cancelled. Requires runId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"runId\":{\"description\":\"The run ID to cancel.\",\"type\":\"string\"}},\"required\":[\"runId\"],\"type\":\"object\"},\"name\":\"currents-cancel-run\"}"},{"name":"currents-cancel-run-github-ci","hash":"d10b6b7d05792873804791b6a2b0ad97385a9fca3e2b409fc02f4a7c203ef579","canonical_json":"{\"description\":\"Cancel a run by GitHub Actions workflow run ID and attempt number. Optionally scope by projectId or ciBuildId. Requires githubRunId and githubRunAttempt.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"ciBuildId\":{\"description\":\"Optional CI build ID to scope the cancellation.\",\"type\":\"string\"},\"githubRunAttempt\":{\"description\":\"GitHub Actions workflow run attempt number.\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"githubRunId\":{\"description\":\"GitHub Actions workflow run ID.\",\"type\":\"string\"},\"projectId\":{\"description\":\"Optional project ID to scope the cancellation.\",\"type\":\"string\"}},\"required\":[\"githubRunId\",\"githubRunAttempt\"],\"type\":\"object\"},\"name\":\"currents-cancel-run-github-ci\"}"},{"name":"currents-create-action","hash":"37c9a7ee9fe1e3f5181a86370d06c71a982138f37b922d634b7f33433b2fec61","canonical_json":"{\"description\":\"Create a new action for a project. Actions define rules that automatically skip, quarantine, or tag tests based on conditions like test title, file path, git branch, etc. Requires projectId, name, action array, and matcher object.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Actions to perform when conditions match.\",\"items\":{\"anyOf\":[{\"properties\":{\"op\":{\"const\":\"skip\",\"type\":\"string\"}},\"required\":[\"op\"],\"type\":\"object\"},{\"properties\":{\"op\":{\"const\":\"quarantine\",\"type\":\"string\"}},\"required\":[\"op\"],\"type\":\"object\"},{\"properties\":{\"details\":{\"properties\":{\"tags\":{\"description\":\"Tags to add to matching tests\",\"items\":{\"type\":\"string\"},\"maxItems\":10,\"type\":\"array\"}},\"required\":[\"tags\"],\"type\":\"object\"},\"op\":{\"const\":\"tag\",\"type\":\"string\"}},\"required\":[\"op\",\"details\"],\"type\":\"object\"}]},\"minItems\":1,\"type\":\"array\"},\"description\":{\"anyOf\":[{\"maxLength\":1000,\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Optional description for the action.\"},\"expiresAfter\":{\"description\":\"Optional expiration date in ISO 8601 format.\",\"type\":[\"string\",\"null\"]},\"matcher\":{\"description\":\"Matcher defining which tests this action applies to.\",\"properties\":{\"cond\":{\"description\":\"List of conditions to match\",\"items\":{\"properties\":{\"op\":{\"enum\":[\"eq\",\"neq\",\"any\",\"empty\",\"in\",\"notIn\",\"inc\",\"notInc\",\"incAll\",\"notIncAll\"],\"type\":\"string\"},\"type\":{\"enum\":[\"testId\",\"project\",\"title\",\"file\",\"git_branch\",\"git_authorName\",\"git_authorEmail\",\"git_remoteOrigin\",\"git_message\",\"error_message\",\"titlePath\",\"annotation\",\"tag\"],\"type\":\"string\"},\"value\":{\"anyOf\":[{\"anyOf\":[{\"type\":\"string\"},{\"items\":{\"type\":\"string\"},\"type\":\"array\"}]},{\"type\":\"null\"}]}},\"required\":[\"type\",\"op\"],\"type\":\"object\"},\"minItems\":1,\"type\":\"array\"},\"op\":{\"description\":\"How to combine multiple conditions\",\"enum\":[\"AND\",\"OR\"],\"type\":\"string\"}},\"required\":[\"op\",\"cond\"],\"type\":\"object\"},\"name\":{\"description\":\"Human-readable name for the action.\",\"maxLength\":255,\"minLength\":1,\"type\":\"string\"},\"projectId\":{\"description\":\"The project ID to create the action for.\",\"type\":\"string\"}},\"required\":[\"projectId\",\"name\",\"action\",\"matcher\"],\"type\":\"object\"},\"name\":\"currents-create-action\"}"},{"name":"currents-create-jira-issue","hash":"19dd01139ef5651a425c062c44351a028ad32d15664a2abeecef9951236e8c03","canonical_json":"{\"description\":\"Create a Jira issue from a run test using the organization Jira integration. Requires projectId, runId, testId, jiraInstallationId, jiraProjectId, and jiraIssueType. Optional customFields array.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"customFields\":{\"description\":\"Optional Jira custom fields for issue creation.\",\"items\":{\"properties\":{\"fieldId\":{\"description\":\"Jira field ID from issue type discovery.\",\"minLength\":1,\"type\":\"string\"},\"value\":{\"description\":\"String value for the Jira custom field.\",\"minLength\":1,\"type\":\"string\"}},\"required\":[\"fieldId\",\"value\"],\"type\":\"object\"},\"type\":\"array\"},\"jiraInstallationId\":{\"description\":\"Jira installation ID for the org integration (dashboard Installation ID).\",\"minLength\":1,\"type\":\"string\"},\"jiraIssueType\":{\"description\":\"Jira issue type ID.\",\"minLength\":1,\"type\":\"string\"},\"jiraProjectId\":{\"description\":\"Jira project ID in which to create the issue.\",\"minLength\":1,\"type\":\"string\"},\"projectId\":{\"description\":\"Currents project ID.\",\"type\":\"string\"},\"runId\":{\"description\":\"Currents run ID containing the test.\",\"minLength\":1,\"type\":\"string\"},\"testId\":{\"description\":\"Test ID within the run.\",\"minLength\":1,\"type\":\"string\"}},\"required\":[\"projectId\",\"runId\",\"testId\",\"jiraInstallationId\",\"jiraProjectId\",\"jiraIssueType\"],\"type\":\"object\"},\"name\":\"currents-create-jira-issue\"}"},{"name":"currents-create-webhook","hash":"550d10af54ad30bc72ff9c20eb59b74907d35c0208e1ec86a80f6cd497ba348e","canonical_json":"{\"description\":\"Create a new webhook for a project. Specify the URL to receive POST notifications, optional custom headers (as JSON string), events to trigger on (RUN_FINISH, RUN_START, RUN_TIMEOUT, RUN_CANCELED), and an optional label. Requires projectId and url.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"headers\":{\"anyOf\":[{\"maxLength\":4096,\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Custom headers as a JSON object string (e.g., {\\\"Authorization\\\": \\\"Bearer token\\\"}).\"},\"hookEvents\":{\"description\":\"Events that trigger this webhook. Options: RUN_FINISH (run completed), RUN_START (run started), RUN_TIMEOUT (run timed out), RUN_CANCELED (run was cancelled).\",\"items\":{\"enum\":[\"RUN_FINISH\",\"RUN_START\",\"RUN_TIMEOUT\",\"RUN_CANCELED\"],\"type\":\"string\"},\"type\":\"array\"},\"label\":{\"anyOf\":[{\"maxLength\":255,\"minLength\":1,\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Human-readable label for the webhook.\"},\"projectId\":{\"description\":\"The project ID to create the webhook for.\",\"type\":\"string\"},\"url\":{\"description\":\"URL to send webhook POST requests to.\",\"maxLength\":2048,\"type\":\"string\"}},\"required\":[\"projectId\",\"url\"],\"type\":\"object\"},\"name\":\"currents-create-webhook\"}"},{"name":"currents-delete-action","hash":"8ea0a982efdc4e8426888bdde064e9db78e6078c1fcbc496fbe285642e9e3dc4","canonical_json":"{\"description\":\"Delete (archive) an action. This is a soft delete - the action will be marked as archived but not permanently removed. The actionId is globally unique.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"actionId\":{\"description\":\"The action ID to delete (archive).\",\"type\":\"string\"}},\"required\":[\"actionId\"],\"type\":\"object\"},\"name\":\"currents-delete-action\"}"},{"name":"currents-delete-run","hash":"09dede13fe0e097d3987980be08bd414f359e51b617c96a6dc817bb45fe22418","canonical_json":"{\"description\":\"Delete a run and all associated data. This is a permanent deletion. Requires runId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"runId\":{\"description\":\"The run ID to delete.\",\"type\":\"string\"}},\"required\":[\"runId\"],\"type\":\"object\"},\"name\":\"currents-delete-run\"}"},{"name":"currents-delete-webhook","hash":"c177f90f14df158df11f31a5d578fdeec542da53830ee4b6f177235b3267952b","canonical_json":"{\"description\":\"Delete a webhook. This permanently removes the webhook. The hookId is a UUID.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"hookId\":{\"description\":\"The webhook ID (UUID).\",\"type\":\"string\"}},\"required\":[\"hookId\"],\"type\":\"object\"},\"name\":\"currents-delete-webhook\"}"},{"name":"currents-disable-action","hash":"7ce1cb01bcae847e22fa934c15a4b01950782d533150ebcbb227c5d788bec9cb","canonical_json":"{\"description\":\"Disable an active action. Changes the action status to disabled, temporarily preventing it from applying to tests. The actionId is globally unique.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"actionId\":{\"description\":\"The action ID to disable.\",\"type\":\"string\"}},\"required\":[\"actionId\"],\"type\":\"object\"},\"name\":\"currents-disable-action\"}"},{"name":"currents-enable-action","hash":"47d9fd4c06fd04cf614797db449249ce112776b60696cb411ff1ba968b6e039a","canonical_json":"{\"description\":\"Enable a disabled action. Changes the action status from disabled to active, making it apply to matching tests again. The actionId is globally unique.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"actionId\":{\"description\":\"The action ID to enable.\",\"type\":\"string\"}},\"required\":[\"actionId\"],\"type\":\"object\"},\"name\":\"currents-enable-action\"}"},{"name":"currents-find-run","hash":"be8b2d11beaca105410430bd53a32d872e8c5b65ba36fe99461ebdefab1b8a1f","canonical_json":"{\"description\":\"Find a run by query parameters. Returns the most recent completed run matching the criteria. Can search by ciBuildId (exact match) or by branch/tags. Supports pwLastRun flag for Playwright last run info. Requires projectId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"branch\":{\"description\":\"Git branch name. Used when ciBuildId is not provided.\",\"type\":\"string\"},\"ciBuildId\":{\"description\":\"The CI build ID. If provided, returns the run with this exact ciBuildId.\",\"type\":\"string\"},\"projectId\":{\"description\":\"The project ID to search for runs in.\",\"type\":\"string\"},\"pwLastRun\":{\"description\":\"If true, includes information about failed tests from the last run (Playwright only).\",\"type\":\"boolean\"},\"tags\":{\"description\":\"Run tags to filter by (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\"],\"type\":\"object\"},\"name\":\"currents-find-run\"}"},{"name":"currents-get-action","hash":"d62a343173fce5f38789372470ce52b2949cf460f167627454f039531968b277","canonical_json":"{\"description\":\"Get a single action by ID. The actionId is globally unique, so projectId is not required. Returns full action details including matcher conditions and current status.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"actionId\":{\"description\":\"The action ID to fetch.\",\"type\":\"string\"}},\"required\":[\"actionId\"],\"type\":\"object\"},\"name\":\"currents-get-action\"}"},{"name":"currents-get-affected-executions","hash":"0d8080085ddd5d04707f61b19b6a64893b5267543c418a15359624d673b54030","canonical_json":"{\"description\":\"List test executions where a specific action/rule was applied, within a date range. Uses cursor-based pagination. Requires actionId, date_start, and date_end.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"actionId\":{\"description\":\"The action ID to fetch affected test executions for.\",\"type\":\"string\"},\"date_end\":{\"description\":\"End date in ISO 8601 format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Start date in ISO 8601 format (required).\",\"type\":\"string\"},\"ending_before\":{\"description\":\"Cursor for pagination. Returns items before this cursor value.\",\"type\":\"string\"},\"limit\":{\"description\":\"Maximum number of executions (1-50). Defaults to 25.\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"search\":{\"description\":\"Search by action name (case-insensitive).\",\"maxLength\":100,\"type\":\"string\"},\"starting_after\":{\"description\":\"Cursor for pagination. Returns items after this cursor value.\",\"type\":\"string\"}},\"required\":[\"actionId\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-affected-executions\"}"},{"name":"currents-get-affected-test-executions","hash":"a65b9ddb63026b697ee57c61b120345f57ecb5a5ae8120451245793dd0d24042","canonical_json":"{\"description\":\"Get execution details for a specific affected test (by signature) within a date range. Returns individual test execution records with action info. Uses cursor-based pagination. Requires projectId, signature, date_start, and date_end.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"date_end\":{\"description\":\"End date in ISO 8601 format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Start date in ISO 8601 format (required).\",\"type\":\"string\"},\"ending_before\":{\"description\":\"Cursor for pagination. Returns items before this cursor value.\",\"type\":\"string\"},\"limit\":{\"description\":\"Maximum number of executions (1-50). Defaults to 25.\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID.\",\"type\":\"string\"},\"search\":{\"description\":\"Search by action name (case-insensitive).\",\"maxLength\":100,\"type\":\"string\"},\"signature\":{\"description\":\"The test signature hash to fetch affected executions for.\",\"type\":\"string\"},\"starting_after\":{\"description\":\"Cursor for pagination. Returns items after this cursor value.\",\"type\":\"string\"}},\"required\":[\"projectId\",\"signature\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-affected-test-executions\"}"},{"name":"currents-get-context","hash":"79852dcd7f8ad493c664d1a5f95027e1c8c1a84e193ca1029620beb7508e3e49","canonical_json":"{\"description\":\"Get test failure context for AI debugging at run, instance, or test level. Supports json or md format, detail level, and pagination for failed tests. Requires run_id for run-level, or instance_id with optional test_id.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"attempt\":{\"description\":\"Attempt number (0-indexed); defaults to latest.\",\"maximum\":9007199254740991,\"minimum\":-9007199254740991,\"type\":\"integer\"},\"detail\":{\"description\":\"Controls output verbosity. default returns all available data; compact omits full steps and limits assets; summary minimizes output. Defaults to default.\",\"enum\":[\"default\",\"compact\",\"summary\"],\"type\":\"string\"},\"format\":{\"description\":\"Response format. Falls back to Accept header when absent. Defaults to json.\",\"enum\":[\"json\",\"md\"],\"type\":\"string\"},\"instance_id\":{\"description\":\"Instance identifier. Required for instance-level and test-level. Omit for run-level (use run_id only).\",\"type\":\"string\"},\"limit\":{\"description\":\"Maximum number of failed tests per page (run-level and instance-level only). Default 10.\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"max_length\":{\"description\":\"Truncate markdown response to this character limit (only applies when format=md).\",\"maximum\":50000,\"minimum\":1,\"type\":\"integer\"},\"page\":{\"description\":\"Page number for failed tests pagination, 0-indexed (run-level and instance-level only). Default 0.\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"run_id\":{\"description\":\"Run identifier. Required for run-level (run_id only) and instance-level (run_id + instance_id, no test_id). Omit for test-level (instance_id + test_id).\",\"type\":\"string\"},\"test_id\":{\"description\":\"Test identifier. When set, selects test-level detail and requires instance_id. run_id is not required in this case.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"currents-get-context\"}"},{"name":"currents-get-errors-explorer","hash":"3cb8c18fae365645ff39c046ce60f03dc2a3e05d68b02b762692e4a78aa39492","canonical_json":"{\"description\":\"Get aggregated error metrics for a project within a date range. Supports filtering by error_target, error_message, error_category, error_action, tags, branches, authors, and groups. Supports grouping by target, action, category, or message. Returns error counts, affected tests and branches, with timeline data. Requires projectId, date_start, and date_end.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"authors\":{\"description\":\"Filter by git authors (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter by branches (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"End date in ISO 8601 format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Start date in ISO 8601 format (required).\",\"type\":\"string\"},\"dir\":{\"description\":\"Sort direction. Defaults to 'desc'.\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"error_action\":{\"description\":\"Filter by error action.\",\"type\":\"string\"},\"error_category\":{\"description\":\"Filter by error category.\",\"type\":\"string\"},\"error_message\":{\"description\":\"Filter by error message (case-insensitive partial match).\",\"type\":\"string\"},\"error_target\":{\"description\":\"Filter by error target (e.g. CSS selector, URL).\",\"type\":\"string\"},\"group_by\":{\"description\":\"Group results by dimension (can be specified multiple times). Order matters: the first value is the primary grouping and filters out nulls for that dimension.\",\"items\":{\"enum\":[\"target\",\"action\",\"category\",\"message\"],\"type\":\"string\"},\"type\":\"array\"},\"groups\":{\"description\":\"Filter by groups (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"limit\":{\"description\":\"Maximum number of results (1-100). Defaults to 50.\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"metric\":{\"description\":\"Metric used for timeline ranking. Defaults to 'occurrence'.\",\"enum\":[\"occurrence\",\"test\",\"branch\"],\"type\":\"string\"},\"order_by\":{\"description\":\"Field to order results by. Defaults to 'count'.\",\"enum\":[\"count\",\"tests\",\"branches\",\"error\"],\"type\":\"string\"},\"page\":{\"description\":\"Page number (0-indexed). Defaults to 0.\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID to fetch error metrics from.\",\"type\":\"string\"},\"tags\":{\"description\":\"Filter by tags (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"tags_logical_operator\":{\"description\":\"Logical operator for tags filter: OR (match any) or AND (match all). Default: OR.\",\"enum\":[\"OR\",\"AND\"],\"type\":\"string\"},\"top_n\":{\"description\":\"Maximum number of top errors per timeline bucket (1-50). Default: 5.\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"}},\"required\":[\"projectId\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-errors-explorer\"}"},{"name":"currents-get-project","hash":"d437025a177ed7bd2bd3a01ad421e6e893999cd77b52e4727aa34e50ab5081b5","canonical_json":"{\"description\":\"Get a single project by ID. Returns project details including name, creation date, failFast setting, inactivity timeout, and default branch name.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"projectId\":{\"description\":\"The project ID to fetch details for.\",\"type\":\"string\"}},\"required\":[\"projectId\"],\"type\":\"object\"},\"name\":\"currents-get-project\"}"},{"name":"currents-get-project-insights","hash":"1a7cfb0c80fa6c9ecd01567385dc3df8a228675dcfea8c7a514cc7a6329f31b4","canonical_json":"{\"description\":\"Get aggregated run and test metrics for a project within a date range. Returns overall metrics and timeline data with configurable resolution (1h/1d/1w). Supports filtering by tags, branches, groups, and authors. Requires projectId, date_start, and date_end.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"authors\":{\"description\":\"Filter by git authors (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter by branches (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"End date in ISO 8601 format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Start date in ISO 8601 format (required).\",\"type\":\"string\"},\"groups\":{\"description\":\"Filter by groups (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"projectId\":{\"description\":\"The project ID to fetch insights for.\",\"type\":\"string\"},\"resolution\":{\"description\":\"Time resolution for histogram data. Defaults to '1d'.\",\"enum\":[\"1h\",\"1d\",\"1w\"],\"type\":\"string\"},\"tags\":{\"description\":\"Filter by tags (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-project-insights\"}"},{"name":"currents-get-projects","hash":"f889f7cfdd7977122f62dbdfd1f0ca16535bb4b74f3d6f9851facb7f65f758b0","canonical_json":"{\"description\":\"Retrieves projects available in the Currents platform. Supports cursor-based pagination with limit, starting_after, ending_before parameters, or set fetchAll=true for automatic pagination. This is a prerequisite for using any other tools that require project-specific information.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"ending_before\":{\"description\":\"Cursor for pagination. Returns items before this cursor value.\",\"type\":\"string\"},\"fetchAll\":{\"description\":\"If true, fetches all projects using automatic pagination. Ignores limit, starting_after, and ending_before.\",\"type\":\"boolean\"},\"limit\":{\"description\":\"Maximum number of items to return (default: 10, max: 100).\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"starting_after\":{\"description\":\"Cursor for pagination. Returns items after this cursor value.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"currents-get-projects\"}"},{"name":"currents-get-run-details","hash":"b864bef4c9715879b55d47b45df0497668e8500f473de8e38c5ac2c0c7e3eb8d","canonical_json":"{\"description\":\"Retrieves details of a specific test run. Requires a user-provided runId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"runId\":{\"description\":\"The run ID to fetch details for.\",\"type\":\"string\"}},\"required\":[\"runId\"],\"type\":\"object\"},\"name\":\"currents-get-run-details\"}"},{"name":"currents-get-runs","hash":"3eb59f40e4e0eaa962c603206e7996652609eff0df485aea2b42a6348546f7e6","canonical_json":"{\"description\":\"Retrieves a list of runs for a specific project with optional filtering. Supports filtering by branch, tags (with AND/OR operators), status (PASSED/FAILED/RUNNING/FAILING), completion state, date range, commit author, and search by ciBuildId or commit message. Requires a projectId. If the projectId is not known, first call 'currents-get-projects' and ask the user to select the project.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"authors\":{\"description\":\"Filter runs by git commit author names (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter runs by git branch names (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"completion_state\":{\"description\":\"Filter runs by completion state. COMPLETE: run finished normally, IN_PROGRESS: run is still executing, CANCELED: run was canceled, TIMEOUT: run timed out.\",\"items\":{\"enum\":[\"COMPLETE\",\"IN_PROGRESS\",\"CANCELED\",\"TIMEOUT\"],\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"Filter runs created before this date (ISO 8601 format).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Filter runs created on or after this date (ISO 8601 format).\",\"type\":\"string\"},\"ending_before\":{\"description\":\"Cursor for pagination. Returns items before this cursor value.\",\"type\":\"string\"},\"limit\":{\"description\":\"The maximum number of results to return per page (default: 10, max: 100).\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"pr_id\":{\"description\":\"Filter runs by normalized pull request id (meta.pr.id). Printable ASCII only, max 128 characters.\",\"maxLength\":128,\"minLength\":1,\"pattern\":\"^[!-~]+$\",\"type\":\"string\"},\"projectId\":{\"description\":\"The project ID to fetch runs from.\",\"type\":\"string\"},\"search\":{\"description\":\"Search runs by ciBuildId or commit message. Case-insensitive.\",\"maxLength\":200,\"type\":\"string\"},\"starting_after\":{\"description\":\"Cursor for pagination. Returns items after this cursor value.\",\"type\":\"string\"},\"status\":{\"description\":\"Filter runs by status. PASSED: all tests passed, FAILED: some tests failed, RUNNING: run is in progress and passing, FAILING: run is in progress but has failures.\",\"items\":{\"enum\":[\"PASSED\",\"FAILED\",\"RUNNING\",\"FAILING\"],\"type\":\"string\"},\"type\":\"array\"},\"tag_operator\":{\"description\":\"Logical operator for tag filtering. AND requires all tags to be present (default), OR requires any tag to be present.\",\"enum\":[\"AND\",\"OR\"],\"type\":\"string\"},\"tags\":{\"description\":\"Filter runs by tags (can be specified multiple times). Use tag_operator to control matching behavior.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\"],\"type\":\"object\"},\"name\":\"currents-get-runs\"}"},{"name":"currents-get-spec-files-performance","hash":"97f43a045d5f3566995c21ce04ca3f15cb2e5b93d647db890d34cb6147af3c4c","canonical_json":"{\"description\":\"Retrieves spec files performance metrics for a specific project within a date range. Supports ordering by avgDuration, failedExecutions, failureRate, flakeRate, flakyExecutions, fullyReported, overallExecutions, suiteSize, timeoutExecutions, or timeoutRate. Supports filtering by tags, branches, groups, and authors. Requires a projectId. If the projectId is not known, first call 'currents-get-projects' and ask the user to select the project.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"authors\":{\"description\":\"Filter results by git authors (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter results by branches (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"The end of the date range to fetch the metrics from. ISO 8601 date format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"The start of the date range to fetch the metrics from. ISO 8601 date format (required).\",\"type\":\"string\"},\"dir\":{\"description\":\"The direction to sort the results in. Defaults to 'desc'.\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"groups\":{\"description\":\"Filter results by groups (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"includeFailedInDuration\":{\"description\":\"Include failed executions in duration calculation. Defaults to false.\",\"type\":\"boolean\"},\"limit\":{\"description\":\"The maximum number of results to return per page (default: 50, max: 50).\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"order\":{\"description\":\"The field to order the spec files by. Defaults to 'avgDuration'.\",\"enum\":[\"avgDuration\",\"failedExecutions\",\"failureRate\",\"flakeRate\",\"flakyExecutions\",\"fullyReported\",\"overallExecutions\",\"suiteSize\",\"timeoutExecutions\",\"timeoutRate\"],\"type\":\"string\"},\"page\":{\"description\":\"The page number to fetch (0-indexed). Defaults to 0.\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID to fetch spec files performance metrics from.\",\"type\":\"string\"},\"specNameFilter\":{\"description\":\"Filter spec files by name (partial match).\",\"type\":\"string\"},\"tags\":{\"description\":\"Filter results by tags (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-spec-files-performance\"}"},{"name":"currents-get-spec-instance","hash":"99c12c371ba1e88ba4f3585acb7f659a86001c3f10272d722b7cf4d34e886502","canonical_json":"{\"description\":\"Retrieves debugging data from a specific execution of a test spec file by instanceId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"instanceId\":{\"description\":\"The instance ID to fetch debugging data from.\",\"type\":\"string\"}},\"required\":[\"instanceId\"],\"type\":\"object\"},\"name\":\"currents-get-spec-instance\"}"},{"name":"currents-get-test-evidence","hash":"25499bb64fe62f7c09f8810f341ef475fb18e0c8837865983bbfe70568105035","canonical_json":"{\"description\":\"Collect evidence artifacts (screenshots, videos, traces, attachments) produced by tests in a CI run, with signed download URLs grouped per test. Use to gather proof or a demo of an implemented feature from CI — e.g. before/after screenshots, text output stored as test attachments, or Playwright videos and traces — instead of running tests locally. Locates the run by runId, or by projectId with ciBuildId or branch (latest run). Supports filtering by spec file, test title, and test status. URLs are signed and time-limited, so download the files promptly.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"branch\":{\"description\":\"Git branch name. The most recent completed run on this branch is used. Requires projectId.\",\"type\":\"string\"},\"ciBuildId\":{\"description\":\"CI build ID for exact run lookup. Requires projectId. Takes precedence over branch.\",\"type\":\"string\"},\"maxInstances\":{\"description\":\"Maximum number of spec file instances to fetch artifacts for (default: 10, max: 25). Narrow with the spec filter instead of raising this.\",\"maximum\":25,\"minimum\":1,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID. Required unless runId is provided. Used to locate the run by ciBuildId or branch.\",\"type\":\"string\"},\"runId\":{\"description\":\"The run ID to collect evidence from. When provided, projectId, ciBuildId, and branch are ignored.\",\"type\":\"string\"},\"spec\":{\"description\":\"Filter spec files by substring match on the spec file path (case-insensitive).\",\"type\":\"string\"},\"testStatus\":{\"description\":\"Filter tests by status. When omitted, all tests are included.\",\"items\":{\"enum\":[\"passed\",\"failed\",\"pending\",\"skipped\"],\"type\":\"string\"},\"type\":\"array\"},\"testTitle\":{\"description\":\"Filter tests by substring match on the full test title, including describe blocks (case-insensitive).\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"currents-get-test-evidence\"}"},{"name":"currents-get-test-results","hash":"e04d052c2279ff0f2e58ef5c370e47f2ae5317b1700b9d85b6a5ee2401b54a03","canonical_json":"{\"description\":\"Retrieves historical test execution results for a specific test signature. Supports filtering by date range, branch, tags, git author, test status (passed/failed/pending/skipped), run group, flaky status, and annotations. Requires the test signature. If the signature is not known, first call 'currents-get-tests-signatures'.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"annotations\":{\"description\":\"Filter by test annotations. JSON-stringified array of objects: [{\\\"type\\\": \\\"string\\\", \\\"description\\\": \\\"string\\\" | [\\\"string\\\"] or null}]. Omit description or set to null to match any value for that annotation type.\",\"type\":\"string\"},\"authors\":{\"description\":\"Filter by git authors (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter by git branches (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"End date in ISO 8601 format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Start date in ISO 8601 format (required).\",\"type\":\"string\"},\"ending_before\":{\"description\":\"Cursor for pagination. Returns items before this cursor value.\",\"type\":\"string\"},\"flaky\":{\"description\":\"Filter by flaky status. When true, returns only flaky tests. When false, returns only non-flaky tests. When omitted, returns all tests regardless of flaky status.\",\"type\":\"boolean\"},\"groups\":{\"description\":\"Filter by run groups (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"limit\":{\"description\":\"Maximum number of items to return (default: 10, max: 100).\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"signature\":{\"description\":\"The test signature.\",\"type\":\"string\"},\"starting_after\":{\"description\":\"Cursor for pagination. Returns items after this cursor value.\",\"type\":\"string\"},\"status\":{\"description\":\"Filter by test status (can be specified multiple times).\",\"items\":{\"enum\":[\"passed\",\"failed\",\"pending\",\"skipped\"],\"type\":\"string\"},\"type\":\"array\"},\"tags\":{\"description\":\"Filter by run tags (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"signature\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-test-results\"}"},{"name":"currents-get-tests-performance","hash":"2024d1a9cf0b5ecc2396386150ad9bd0cb9f2eefeb017953c9cb09c79b4c0ec0","canonical_json":"{\"description\":\"Retrieves aggregated test metrics for a specific project within a date range. Supports ordering by failures, passes, flakiness, duration, executions, title, and various delta metrics. Supports filtering by spec name, test title, tags, branches, groups, authors, minimum executions, test state, and annotations. Requires a projectId. If the projectId is not known, first call 'currents-get-projects' and ask the user to select the project.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"annotations\":{\"description\":\"Filter by test annotations. JSON-stringified array of objects: [{\\\"type\\\": \\\"string\\\", \\\"description\\\": \\\"string\\\" | [\\\"string\\\"] or null}]. Omit description or set to null to match any value for that annotation type.\",\"type\":\"string\"},\"authors\":{\"description\":\"Filter results by git authors (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter results by branches (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"The end of the date range to fetch the metrics from. ISO 8601 date format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"The start of the date range to fetch the metrics from. ISO 8601 date format (required).\",\"type\":\"string\"},\"dir\":{\"description\":\"The direction to sort the results in. Defaults to 'desc'.\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"groups\":{\"description\":\"Filter results by groups (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"limit\":{\"description\":\"The maximum number of results to return per page (default: 50).\",\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"metric_settings\":{\"description\":\"Override which test statuses are included in metric calculations. Pass a JSON object with optional keys: executions, avgDuration, flakinessRate, failureRate. Each value is an array of status strings: passed, failed, pending, skipped. Example: {\\\"executions\\\":[\\\"failed\\\",\\\"passed\\\"],\\\"failureRate\\\":[\\\"failed\\\"]}\",\"type\":\"string\"},\"min_executions\":{\"description\":\"Minimum number of executions to include.\",\"maximum\":9007199254740991,\"minimum\":1,\"type\":\"integer\"},\"order\":{\"description\":\"The field to order the results by. Defaults to 'title'.\",\"enum\":[\"failures\",\"passes\",\"flakiness\",\"flakinessXSamples\",\"failRateXSamples\",\"duration\",\"durationDelta\",\"flakinessRateDelta\",\"failureRateDelta\",\"durationXSamples\",\"executions\",\"title\"],\"type\":\"string\"},\"page\":{\"description\":\"The page number to fetch (0-indexed). Defaults to 0.\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID to fetch test performance metrics from.\",\"type\":\"string\"},\"spec\":{\"description\":\"Filter tests by spec file name (partial match).\",\"type\":\"string\"},\"tags\":{\"description\":\"Filter results by tags (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"test_state\":{\"description\":\"Filter by test state (can be specified multiple times).\",\"items\":{\"enum\":[\"passed\",\"failed\",\"pending\",\"skipped\"],\"type\":\"string\"},\"type\":\"array\"},\"title\":{\"description\":\"Filter tests by title (partial match).\",\"type\":\"string\"}},\"required\":[\"projectId\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-get-tests-performance\"}"},{"name":"currents-get-tests-signatures","hash":"c2999d3aed5c265b71bb5c8959b72f28b1744ec97790b5a60e93140cd7d6e448","canonical_json":"{\"description\":\"Generates a unique test signature based on project, spec file path, and test title. The test title can be a string or array of strings (for nested describe blocks). Requires a projectId. If the projectId is not known, first call 'currents-get-projects' and ask the user to select the project.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"projectId\":{\"description\":\"The project ID to generate the test signature for.\",\"type\":\"string\"},\"specFilePath\":{\"description\":\"Full path to the spec file.\",\"type\":\"string\"},\"testTitle\":{\"anyOf\":[{\"type\":\"string\"},{\"items\":{\"type\":\"string\"},\"minItems\":1,\"type\":\"array\"}],\"description\":\"Test title or array of titles (for nested describe blocks).\"}},\"required\":[\"projectId\",\"specFilePath\",\"testTitle\"],\"type\":\"object\"},\"name\":\"currents-get-tests-signatures\"}"},{"name":"currents-get-webhook","hash":"7a4d537e25f1aaa759b2c3dbf4ac5026f4c99de92b718ce5aeb7f877bb5a0130","canonical_json":"{\"description\":\"Get a single webhook by ID. The hookId is a UUID. Returns full webhook details including url, headers, events, label, and timestamps.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"hookId\":{\"description\":\"The webhook ID (UUID).\",\"type\":\"string\"}},\"required\":[\"hookId\"],\"type\":\"object\"},\"name\":\"currents-get-webhook\"}"},{"name":"currents-link-jira-issue","hash":"e39148f48631ee886e34c2db8a85773c10c38aaf065ec51da5b25e5018802fad","canonical_json":"{\"description\":\"Link an existing Jira issue to a run test using the organization Jira integration. Requires projectId, jiraIssueKey, runId, testId, jiraInstallationId, jiraProjectId, and jiraIssueType. Optional comment and includeContextInComment.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"comment\":{\"description\":\"Optional text prepended to the Jira comment and Currents issue description before automated test context.\",\"type\":\"string\"},\"includeContextInComment\":{\"description\":\"When true (default), appends automated test context to the Jira comment. When false, comment is required and used alone.\",\"type\":\"boolean\"},\"jiraInstallationId\":{\"description\":\"Jira installation ID for the org integration (dashboard Installation ID).\",\"minLength\":1,\"type\":\"string\"},\"jiraIssueKey\":{\"description\":\"Existing Jira issue key to link (e.g. PROJ-123).\",\"minLength\":1,\"type\":\"string\"},\"jiraIssueType\":{\"description\":\"Jira issue type identifier stored on the Currents ticket.\",\"minLength\":1,\"type\":\"string\"},\"jiraProjectId\":{\"description\":\"Jira project ID for the linked issue.\",\"minLength\":1,\"type\":\"string\"},\"projectId\":{\"description\":\"Currents project ID.\",\"type\":\"string\"},\"runId\":{\"description\":\"Currents run ID containing the test.\",\"minLength\":1,\"type\":\"string\"},\"testId\":{\"description\":\"Test ID within the run.\",\"minLength\":1,\"type\":\"string\"}},\"required\":[\"projectId\",\"jiraIssueKey\",\"runId\",\"testId\",\"jiraInstallationId\",\"jiraProjectId\",\"jiraIssueType\"],\"type\":\"object\"},\"name\":\"currents-link-jira-issue\"}"},{"name":"currents-list-actions","hash":"4951907b5fa02ab88c4631748aea21c6c35074121e7927f7684f9cb7bd3e887a","canonical_json":"{\"description\":\"List all actions for a project with optional filtering. Actions are rules that automatically modify test behavior (skip, quarantine, tag). Supports filtering by status (active/disabled/archived/expired) and search by name. Requires a projectId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"projectId\":{\"description\":\"The project ID to fetch actions from.\",\"type\":\"string\"},\"search\":{\"description\":\"Search actions by name.\",\"maxLength\":100,\"type\":\"string\"},\"status\":{\"description\":\"Filter actions by status (can be specified multiple times).\",\"items\":{\"enum\":[\"active\",\"disabled\",\"archived\",\"expired\"],\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\"],\"type\":\"object\"},\"name\":\"currents-list-actions\"}"},{"name":"currents-list-affected-tests","hash":"4bb523aee39cbcac0bbccfb9478c4509b17c307c05245cdb33e3ec7656224fe9","canonical_json":"{\"description\":\"List tests affected by actions (quarantine, skip, tag) for a project within a date range. Returns aggregated data grouped by test signature. Supports filtering by action types, action ID, status, and search. Requires projectId, date_start, and date_end. Preview endpoint: fields and path may change.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action_id\":{\"description\":\"Filter by a specific action ID.\",\"type\":\"string\"},\"action_type\":{\"description\":\"Filter by action types (can be specified multiple times).\",\"items\":{\"enum\":[\"quarantine\",\"skip\",\"tag\"],\"type\":\"string\"},\"type\":\"array\"},\"date_end\":{\"description\":\"End date in ISO 8601 format (required).\",\"type\":\"string\"},\"date_start\":{\"description\":\"Start date in ISO 8601 format (required).\",\"type\":\"string\"},\"dir\":{\"description\":\"Sort direction for lastSeen. Defaults to 'desc'.\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"limit\":{\"description\":\"Maximum number of results (1-100). Defaults to 25.\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"page\":{\"description\":\"Page number (0-indexed). Defaults to 0.\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID to fetch affected tests from.\",\"type\":\"string\"},\"search\":{\"description\":\"Search by spec file path, test title, or action name (case-insensitive).\",\"maxLength\":100,\"type\":\"string\"},\"status\":{\"description\":\"Filter by action status. Accepts multiple values. Omit for all statuses.\",\"items\":{\"enum\":[\"active\",\"disabled\",\"expired\",\"archived\"],\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\",\"date_start\",\"date_end\"],\"type\":\"object\"},\"name\":\"currents-list-affected-tests\"}"},{"name":"currents-list-jira-issue-types","hash":"8c5e6ae31f333a6e00b98800772331da84357200af7ec6008ef107bbde3bebdb","canonical_json":"{\"description\":\"List Jira issue types and custom fields for a Jira project. Requires jiraProjectId and jira_installation_id.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"jiraProjectId\":{\"description\":\"Jira project ID.\",\"maxLength\":128,\"minLength\":1,\"type\":\"string\"},\"jira_installation_id\":{\"description\":\"Jira installation ID for the organization integration.\",\"minLength\":1,\"type\":\"string\"},\"limit\":{\"description\":\"Maximum issue types per page (default: 50, max: 100).\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"page\":{\"description\":\"Page number for discovery results (default: 0).\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"search\":{\"description\":\"Search issue types by name.\",\"type\":\"string\"}},\"required\":[\"jiraProjectId\",\"jira_installation_id\"],\"type\":\"object\"},\"name\":\"currents-list-jira-issue-types\"}"},{"name":"currents-list-jira-projects","hash":"c75b24fbed5b02b67600bcdbec7c47d0d5a857ac50ec88f2912a061860e4ac95","canonical_json":"{\"description\":\"List Jira projects available for the organization integration. Use returned project IDs as jiraProjectId when creating issues. Requires jira_installation_id.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"jira_installation_id\":{\"description\":\"Jira installation ID for the organization integration.\",\"minLength\":1,\"type\":\"string\"},\"limit\":{\"description\":\"Maximum projects per page (default: 50, max: 100).\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"page\":{\"description\":\"Page number for discovery results (default: 0).\",\"maximum\":9007199254740991,\"minimum\":0,\"type\":\"integer\"},\"search\":{\"description\":\"Search Jira projects by name or key.\",\"type\":\"string\"}},\"required\":[\"jira_installation_id\"],\"type\":\"object\"},\"name\":\"currents-list-jira-projects\"}"},{"name":"currents-list-project-terms","hash":"f8da514646911f561257344e61c936f1edabfdad611cb08502aa39ec43f12a5e","canonical_json":"{\"description\":\"List cursor-paginated project terms for one type (tag, branch, authorName, etc.). Supports search, sort direction, and starting_after or ending_before cursors. Requires projectId and termType.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"dir\":{\"description\":\"Sort direction by last update time (default: desc).\",\"enum\":[\"asc\",\"desc\"],\"type\":\"string\"},\"ending_before\":{\"description\":\"Cursor for backward pagination.\",\"type\":\"string\"},\"limit\":{\"description\":\"Maximum items per page (default: 100, max: 100).\",\"maximum\":100,\"minimum\":1,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID.\",\"type\":\"string\"},\"search\":{\"description\":\"Case-insensitive search filter for term values.\",\"maxLength\":128,\"type\":\"string\"},\"starting_after\":{\"description\":\"Cursor for forward pagination.\",\"type\":\"string\"},\"termType\":{\"description\":\"Term kind to list: tag, group, branch, authorName, authorEmail, framework, frameworkVersion, clientVersion, ann_type, or ann_desc.\",\"enum\":[\"tag\",\"group\",\"branch\",\"authorName\",\"authorEmail\",\"framework\",\"frameworkVersion\",\"clientVersion\",\"ann_type\",\"ann_desc\"],\"type\":\"string\"}},\"required\":[\"projectId\",\"termType\"],\"type\":\"object\"},\"name\":\"currents-list-project-terms\"}"},{"name":"currents-list-pull-requests","hash":"39793c5dc7c6fc97c9da55b38a11c4f5510563b4057c3d6fdc7e417efcf70abb","canonical_json":"{\"description\":\"List pull-request cards for a project (runs grouped by meta.pr.id). Supports cursor pagination, runs_per_pr preview count, and filters by tags, branches, authors, and latest-run status. Requires projectId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"authors\":{\"description\":\"Filter by git commit author glob patterns (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"branches\":{\"description\":\"Filter by git branch names (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"ending_before\":{\"description\":\"Cursor for backward pagination.\",\"type\":\"string\"},\"limit\":{\"description\":\"Maximum number of PR cards per page (default: 10, max: 50).\",\"maximum\":50,\"minimum\":1,\"type\":\"integer\"},\"projectId\":{\"description\":\"The project ID to list pull requests for.\",\"type\":\"string\"},\"runs_per_pr\":{\"description\":\"Number of recent runs to preview per PR card (default: 1, max: 10).\",\"maximum\":10,\"minimum\":1,\"type\":\"integer\"},\"starting_after\":{\"description\":\"Cursor for forward pagination.\",\"type\":\"string\"},\"status\":{\"description\":\"Filter PR cards by latest run status (can be specified multiple times).\",\"items\":{\"enum\":[\"PASSED\",\"FAILED\",\"RUNNING\",\"FAILING\"],\"type\":\"string\"},\"type\":\"array\"},\"tag_operator\":{\"description\":\"Logical operator for tag filtering. AND requires all tags (default), OR requires any tag.\",\"enum\":[\"AND\",\"OR\"],\"type\":\"string\"},\"tags\":{\"description\":\"Filter by run tags (can be specified multiple times).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"projectId\"],\"type\":\"object\"},\"name\":\"currents-list-pull-requests\"}"},{"name":"currents-list-webhooks","hash":"847eaaabb591a904f5a5d0eb2e6af2b67534bc8876d4a691259856cb32cf41c1","canonical_json":"{\"description\":\"List all webhooks for a project. Webhooks allow you to receive HTTP POST notifications when certain events occur in your test runs: RUN_FINISH (run completed), RUN_START (run started), RUN_TIMEOUT (run timed out), RUN_CANCELED (run was cancelled). Requires a projectId.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"projectId\":{\"description\":\"The project ID to fetch webhooks from.\",\"type\":\"string\"}},\"required\":[\"projectId\"],\"type\":\"object\"},\"name\":\"currents-list-webhooks\"}"},{"name":"currents-reset-run","hash":"3b75b3fd5bfefe335581a61d688afe371d25ed06c40c2498b1e61aba7d16739c","canonical_json":"{\"description\":\"Reset failed spec files in a run to allow re-execution. Requires runId and machineId array (1-63 machine IDs). Optionally supports batched orchestration.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"isBatchedOr8n\":{\"description\":\"Whether to use batched orchestration.\",\"type\":\"boolean\"},\"machineId\":{\"description\":\"Machine ID(s) to reset.\",\"items\":{\"type\":\"string\"},\"maxItems\":63,\"minItems\":1,\"type\":\"array\"},\"runId\":{\"description\":\"The run ID to reset.\",\"type\":\"string\"}},\"required\":[\"runId\",\"machineId\"],\"type\":\"object\"},\"name\":\"currents-reset-run\"}"},{"name":"currents-update-action","hash":"ed6efcfced42cf8646e538b5a4ca392cf2692ae35871847d129b69ad9eda464a","canonical_json":"{\"description\":\"Update an existing action. The actionId is globally unique. You can update name, description, action array, matcher, or expiration date. All fields are optional.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"action\":{\"description\":\"Actions to perform when conditions match.\",\"items\":{\"anyOf\":[{\"properties\":{\"op\":{\"const\":\"skip\",\"type\":\"string\"}},\"required\":[\"op\"],\"type\":\"object\"},{\"properties\":{\"op\":{\"const\":\"quarantine\",\"type\":\"string\"}},\"required\":[\"op\"],\"type\":\"object\"},{\"properties\":{\"details\":{\"properties\":{\"tags\":{\"description\":\"Tags to add to matching tests\",\"items\":{\"type\":\"string\"},\"maxItems\":10,\"type\":\"array\"}},\"required\":[\"tags\"],\"type\":\"object\"},\"op\":{\"const\":\"tag\",\"type\":\"string\"}},\"required\":[\"op\",\"details\"],\"type\":\"object\"}]},\"minItems\":1,\"type\":\"array\"},\"actionId\":{\"description\":\"The action ID to update.\",\"type\":\"string\"},\"description\":{\"anyOf\":[{\"maxLength\":1000,\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Optional description for the action.\"},\"expiresAfter\":{\"description\":\"Optional expiration date in ISO 8601 format.\",\"type\":[\"string\",\"null\"]},\"matcher\":{\"description\":\"Matcher defining which tests this action applies to.\",\"properties\":{\"cond\":{\"description\":\"List of conditions to match\",\"items\":{\"properties\":{\"op\":{\"enum\":[\"eq\",\"neq\",\"any\",\"empty\",\"in\",\"notIn\",\"inc\",\"notInc\",\"incAll\",\"notIncAll\"],\"type\":\"string\"},\"type\":{\"enum\":[\"testId\",\"project\",\"title\",\"file\",\"git_branch\",\"git_authorName\",\"git_authorEmail\",\"git_remoteOrigin\",\"git_message\",\"error_message\",\"titlePath\",\"annotation\",\"tag\"],\"type\":\"string\"},\"value\":{\"anyOf\":[{\"anyOf\":[{\"type\":\"string\"},{\"items\":{\"type\":\"string\"},\"type\":\"array\"}]},{\"type\":\"null\"}]}},\"required\":[\"type\",\"op\"],\"type\":\"object\"},\"minItems\":1,\"type\":\"array\"},\"op\":{\"description\":\"How to combine multiple conditions\",\"enum\":[\"AND\",\"OR\"],\"type\":\"string\"}},\"required\":[\"op\",\"cond\"],\"type\":\"object\"},\"name\":{\"description\":\"Human-readable name for the action.\",\"maxLength\":255,\"minLength\":1,\"type\":\"string\"}},\"required\":[\"actionId\"],\"type\":\"object\"},\"name\":\"currents-update-action\"}"},{"name":"currents-update-webhook","hash":"0e6e5ce41e1c3862c161112eab5a8d5605f2dc6a68b7e223dac341f1667653ec","canonical_json":"{\"description\":\"Update an existing webhook. You can update the url, headers (as JSON string), hookEvents array, or label. All fields are optional. The hookId is a UUID.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"headers\":{\"anyOf\":[{\"maxLength\":4096,\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Custom headers as a JSON object string (e.g., {\\\"Authorization\\\": \\\"Bearer token\\\"}).\"},\"hookEvents\":{\"description\":\"Events that trigger this webhook. Options: RUN_FINISH (run completed), RUN_START (run started), RUN_TIMEOUT (run timed out), RUN_CANCELED (run was cancelled).\",\"items\":{\"enum\":[\"RUN_FINISH\",\"RUN_START\",\"RUN_TIMEOUT\",\"RUN_CANCELED\"],\"type\":\"string\"},\"type\":\"array\"},\"hookId\":{\"description\":\"The webhook ID (UUID).\",\"type\":\"string\"},\"label\":{\"anyOf\":[{\"maxLength\":255,\"minLength\":1,\"type\":\"string\"},{\"type\":\"null\"}],\"description\":\"Human-readable label for the webhook.\"},\"url\":{\"description\":\"URL to send webhook POST requests to.\",\"maxLength\":2048,\"type\":\"string\"}},\"required\":[\"hookId\"],\"type\":\"object\"},\"name\":\"currents-update-webhook\"}"}],"entry_hash":"ade7d9bf5f0c9c9a5a3108be6a4da2db47c69ead10763be033c7605087387ae8"} {"seq":3,"prev_entry_hash":"ade7d9bf5f0c9c9a5a3108be6a4da2db47c69ead10763be033c7605087387ae8","observed_at":"2026-09-02T07:55:00.375Z","server_id":"b592c5e9a17274c5","server_name":"@bitbonsai/mcpvault","source":"npm","set_hash":"0c4fb48d45153d7666bd13af063243da4623d0f7b37eb3fef0f723acf1811834","tools":[{"name":"delete_note","hash":"dec605ec7bfe0d2de5f4264bdb561e0cfbe079d141c03174a1190db1ab7503b4","canonical_json":"{\"description\":\"Delete a note from the Obsidian vault (requires confirmation). Supports permanent delete, vault trash, or system trash.\",\"inputSchema\":{\"properties\":{\"confirmPath\":{\"description\":\"Confirmation: must exactly match the path parameter to proceed with deletion\",\"type\":\"string\"},\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"trashMode\":{\"default\":\"none\",\"description\":\"Deletion mode: 'none' = permanent delete (default), 'local' = move to .trash inside vault, 'system' = move to OS trash\",\"enum\":[\"none\",\"local\",\"system\"],\"type\":\"string\"}},\"required\":[\"path\",\"confirmPath\"],\"type\":\"object\"},\"name\":\"delete_note\"}"},{"name":"get_frontmatter","hash":"2f580aff87ff18331e1dd0fe2d48e2abe736582213e0c28e0be70cf10f6ae3b0","canonical_json":"{\"description\":\"Extract frontmatter from a note without reading the content\",\"inputSchema\":{\"properties\":{\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"required\":[\"path\"],\"type\":\"object\"},\"name\":\"get_frontmatter\"}"},{"name":"get_note_outline","hash":"fda9591a3d6b042b5cd426123bbc6de2bb009b678bfb318cc7570ac44dbd3f1b","canonical_json":"{\"description\":\"Get the heading structure of a note without reading its full content. Returns headings with level, text, and line number. Use this first to navigate large notes efficiently, then call read_note_lines to read only the section you need.\",\"inputSchema\":{\"properties\":{\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"required\":[\"path\"],\"type\":\"object\"},\"name\":\"get_note_outline\"}"},{"name":"get_notes_info","hash":"fc224413dcf75ab402408b79e6be3087533587f5593a6c7ff37c49cc1c5952cf","canonical_json":"{\"description\":\"Get metadata for notes without reading full content\",\"inputSchema\":{\"properties\":{\"paths\":{\"description\":\"Array of note paths to get info for\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"required\":[\"paths\"],\"type\":\"object\"},\"name\":\"get_notes_info\"}"},{"name":"get_vault_stats","hash":"e4435965938c08ea10cc41a07ef7c225e606fdbdf392cdb0c1755046320cda02","canonical_json":"{\"description\":\"Get vault statistics including total notes, folders, size, and recently modified files. Useful for understanding vault scope before batch operations.\",\"inputSchema\":{\"properties\":{\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"},\"recentCount\":{\"default\":5,\"description\":\"Number of recently modified files to return (default: 5, max: 20)\",\"type\":\"number\"}},\"type\":\"object\"},\"name\":\"get_vault_stats\"}"},{"name":"list_all_tags","hash":"40906a995c401a77b76d4292353184902500020dc845d8543d403d5f3d0600f3","canonical_json":"{\"description\":\"List all tags across the vault with occurrence counts. Returns both frontmatter tags and inline #hashtags, deduplicated and sorted by frequency. Useful for discovering existing tags before creating or organizing notes.\",\"inputSchema\":{\"properties\":{\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"list_all_tags\"}"},{"name":"list_directory","hash":"d7dbe5d72d0792585ad8026cfeba572f552d2ad09ce7266343f29ac993bed531","canonical_json":"{\"description\":\"List files and directories in the vault (includes non-note filenames, while read/write tools remain note-only)\",\"inputSchema\":{\"properties\":{\"path\":{\"default\":\"/\",\"description\":\"Path relative to vault root (default: '/')\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"type\":\"object\"},\"name\":\"list_directory\"}"},{"name":"manage_tags","hash":"143e29c6a0e8674eea1e53bde3616e22355496f5448ab7625e6e95106f231707","canonical_json":"{\"description\":\"Add, remove, or list tags in a note\",\"inputSchema\":{\"properties\":{\"operation\":{\"description\":\"Operation to perform: 'add', 'remove', or 'list'\",\"enum\":[\"add\",\"remove\",\"list\"],\"type\":\"string\"},\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"tags\":{\"description\":\"Array of tags (required for 'add' and 'remove' operations)\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"required\":[\"path\",\"operation\"],\"type\":\"object\"},\"name\":\"manage_tags\"}"},{"name":"move_file","hash":"eec39a6fafef3986f2f237e819fe25f0ace6d17c77b43bf742c66b775085d1e3","canonical_json":"{\"description\":\"Move or rename any file in the vault (binary-safe, file-only, requires confirmation)\",\"inputSchema\":{\"properties\":{\"confirmNewPath\":{\"description\":\"Confirmation: must exactly match newPath\",\"type\":\"string\"},\"confirmOldPath\":{\"description\":\"Confirmation: must exactly match oldPath\",\"type\":\"string\"},\"newPath\":{\"description\":\"New path for the file\",\"type\":\"string\"},\"oldPath\":{\"description\":\"Current path of the file\",\"type\":\"string\"},\"overwrite\":{\"default\":false,\"description\":\"Allow overwriting existing file (default: false)\",\"type\":\"boolean\"}},\"required\":[\"oldPath\",\"newPath\",\"confirmOldPath\",\"confirmNewPath\"],\"type\":\"object\"},\"name\":\"move_file\"}"},{"name":"move_note","hash":"a7e8949b5774865bc00e809cd7e3dede9a602aa2d38bfb36069c0e291f443d27","canonical_json":"{\"description\":\"Move or rename a note in the vault\",\"inputSchema\":{\"properties\":{\"newPath\":{\"description\":\"New path for the note\",\"type\":\"string\"},\"oldPath\":{\"description\":\"Current path of the note\",\"type\":\"string\"},\"overwrite\":{\"default\":false,\"description\":\"Allow overwriting existing file (default: false)\",\"type\":\"boolean\"}},\"required\":[\"oldPath\",\"newPath\"],\"type\":\"object\"},\"name\":\"move_note\"}"},{"name":"patch_note","hash":"8e4a846d88aaed2e27c4061da242740a59daf61744bf5766abb31f291d73710a","canonical_json":"{\"description\":\"Efficiently update part of a note by replacing a specific string. This is more efficient than rewriting the entire note for small changes.\",\"inputSchema\":{\"properties\":{\"newString\":{\"description\":\"The new string to insert in place of oldString\",\"type\":\"string\"},\"oldString\":{\"description\":\"The exact string to replace. Must match exactly including whitespace and line breaks.\",\"type\":\"string\"},\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"replaceAll\":{\"default\":false,\"description\":\"If true, replace all occurrences. If false (default), the operation will fail if multiple matches are found to prevent unintended replacements.\",\"type\":\"boolean\"}},\"required\":[\"path\",\"oldString\",\"newString\"],\"type\":\"object\"},\"name\":\"patch_note\"}"},{"name":"read_multiple_notes","hash":"c0d88d18af4c2a065d1ab150f4a60fe6829ccb95c7f01d992c7bd4b43f71a0c1","canonical_json":"{\"description\":\"Read multiple notes in a batch (max 10 files)\",\"inputSchema\":{\"properties\":{\"includeContent\":{\"default\":true,\"description\":\"Include note content (default: true)\",\"type\":\"boolean\"},\"includeFrontmatter\":{\"default\":true,\"description\":\"Include frontmatter (default: true)\",\"type\":\"boolean\"},\"paths\":{\"description\":\"Array of note paths to read\",\"items\":{\"type\":\"string\"},\"maxItems\":10,\"type\":\"array\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"required\":[\"paths\"],\"type\":\"object\"},\"name\":\"read_multiple_notes\"}"},{"name":"read_note","hash":"041db4d9a01c59d08b0fb27f357efb922c94170ae97e13bfa97519fa1ecfa49f","canonical_json":"{\"description\":\"Read a note from the Obsidian vault\",\"inputSchema\":{\"properties\":{\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"required\":[\"path\"],\"type\":\"object\"},\"name\":\"read_note\"}"},{"name":"read_note_lines","hash":"08af5f5e1c32399e77dd6a7af144ee4e034bfc9b6c7feb3bd62a7e997e9e65b8","canonical_json":"{\"description\":\"Read a specific line range from a note. Use after get_note_outline to read only the section you need instead of the full file.\",\"inputSchema\":{\"properties\":{\"endLine\":{\"description\":\"Last line to read (1-indexed, inclusive)\",\"type\":\"number\"},\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"},\"startLine\":{\"description\":\"First line to read (1-indexed, inclusive)\",\"type\":\"number\"}},\"required\":[\"path\",\"startLine\",\"endLine\"],\"type\":\"object\"},\"name\":\"read_note_lines\"}"},{"name":"search_notes","hash":"fa8f22f202b25e67c89699d6f6ffd8f63decfeb6ca25dec6ba54b4e622b0e4ac","canonical_json":"{\"description\":\"Search for notes in the vault by content or frontmatter\",\"inputSchema\":{\"properties\":{\"caseSensitive\":{\"default\":false,\"description\":\"Case sensitive search (default: false)\",\"type\":\"boolean\"},\"excludePaths\":{\"description\":\"Skip files under these subtrees, e.g. [\\\"Archive\\\", \\\"meta\\\"] (directory prefixes)\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"limit\":{\"default\":5,\"description\":\"Maximum number of results (default: 5, max: 20)\",\"type\":\"number\"},\"pathPrefix\":{\"description\":\"Restrict the search to a vault subtree, e.g. \\\"Projects/2026\\\" (directory prefix)\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"},\"query\":{\"description\":\"Search query text\",\"type\":\"string\"},\"searchContent\":{\"default\":true,\"description\":\"Search in note content (default: true)\",\"type\":\"boolean\"},\"searchFrontmatter\":{\"default\":false,\"description\":\"Search in frontmatter (default: false)\",\"type\":\"boolean\"}},\"required\":[\"query\"],\"type\":\"object\"},\"name\":\"search_notes\"}"},{"name":"update_frontmatter","hash":"d311cb44ed241ef85c8725305820fb9f24265ff71b96b9c39c47ffa86e2945a0","canonical_json":"{\"description\":\"Update frontmatter of a note without changing content\",\"inputSchema\":{\"properties\":{\"frontmatter\":{\"description\":\"Frontmatter object to update\",\"type\":\"object\"},\"merge\":{\"default\":true,\"description\":\"Merge with existing frontmatter (default: true)\",\"type\":\"boolean\"},\"path\":{\"description\":\"Path to the note\",\"type\":\"string\"}},\"required\":[\"path\",\"frontmatter\"],\"type\":\"object\"},\"name\":\"update_frontmatter\"}"},{"name":"wiki_link","hash":"014388936820ba11f63961e1c9d6d8772d43b95f4f38ce9df691af8fa2276390","canonical_json":"{\"description\":\"Read an Obsidian wiki link. Accepts the same syntax as Obsidian: [[Document Name]] or [[Document Name|Display Text]], including table-authored escapes like [[Document Name\\\\|Display]] and path-qualified links like [[folder/Document Name]]. A #fragment suffix in the input is ignored. Searches the vault for an exact basename match (or exact vault-relative path match when the name contains '/') and returns the file's content. When multiple files share the basename, picks the first (vault root first, then alphabetical by path) and lists the other paths in structuredContent.alternatives. Content is returned bare — ready for direct use in context.\",\"inputSchema\":{\"properties\":{\"document\":{\"description\":\"The document name — what goes inside [[ ]]. e.g. 'My-Document'. Brackets and display text (|...) are stripped if present. The .md extension is always appended (never include it).\",\"type\":\"string\"},\"prettyPrint\":{\"default\":false,\"description\":\"Format JSON response with indentation (default: false)\",\"type\":\"boolean\"}},\"required\":[\"document\"],\"type\":\"object\"},\"name\":\"wiki_link\"}"},{"name":"write_note","hash":"b6cc9eb033ced6d5b76ae00e75039bbec685a65ef826b84ba2a157349dec0da8","canonical_json":"{\"description\":\"Write a note to the Obsidian vault\",\"inputSchema\":{\"properties\":{\"content\":{\"description\":\"Content of the note\",\"type\":\"string\"},\"frontmatter\":{\"description\":\"Frontmatter object (optional)\",\"type\":\"object\"},\"mode\":{\"default\":\"overwrite\",\"description\":\"Write mode: 'overwrite' (default), 'append', or 'prepend'\",\"enum\":[\"overwrite\",\"append\",\"prepend\"],\"type\":\"string\"},\"path\":{\"description\":\"Path to the note relative to vault root\",\"type\":\"string\"}},\"required\":[\"path\",\"content\"],\"type\":\"object\"},\"name\":\"write_note\"}"}],"entry_hash":"29e514f960acb3af3682c8a9c64c595301d5439fbf8495394e28c392bafcc975"} {"seq":4,"prev_entry_hash":"29e514f960acb3af3682c8a9c64c595301d5439fbf8495394e28c392bafcc975","observed_at":"2026-09-02T07:55:01.107Z","server_id":"14ae559be20b0def","server_name":"@aashari/mcp-server-atlassian-jira","source":"npm","set_hash":"1d4477fe2e237fe052d260a1c748c4a47b92da5278a993da58e399361d973252","tools":[{"name":"jira_delete","hash":"bf06f3f06ea0a2515df4fb51023e2e47c7b3ac2f28374e0dfb834150f1c019b9","canonical_json":"{\"description\":\"Delete Jira resources. Returns TOON format by default.\\n\\n**Output format:** TOON (default) or JSON (`outputFormat: \\\"json\\\"`)\\n\\n**Common operations:**\\n\\n1. **Delete issue:** `/rest/api/3/issue/{issueIdOrKey}`\\n Query param: `deleteSubtasks=true` to delete subtasks\\n\\n2. **Delete comment:** `/rest/api/3/issue/{issueIdOrKey}/comment/{commentId}`\\n\\n3. **Delete worklog:** `/rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}`\\n\\n4. **Delete attachment:** `/rest/api/3/attachment/{attachmentId}`\\n\\n5. **Remove watcher:** `/rest/api/3/issue/{issueIdOrKey}/watchers`\\n Query param: `accountId={accountId}`\\n\\nNote: Most DELETE endpoints return 204 No Content on success.\\n\\nAPI reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"jq\":{\"description\":\"JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: \\\"issues[*].{key: key, summary: fields.summary}\\\" (extract specific fields), \\\"issues[0]\\\" (first result), \\\"issues[*].key\\\" (keys only). See https://jmespath.org\",\"type\":\"string\"},\"outputFormat\":{\"description\":\"Output format: \\\"toon\\\" (default, 30-60% fewer tokens) or \\\"json\\\". TOON is optimized for LLMs with tabular arrays and minimal syntax.\",\"enum\":[\"toon\",\"json\"],\"type\":\"string\"},\"path\":{\"description\":\"The Jira API endpoint path (without base URL). Must start with \\\"/\\\". Examples: \\\"/rest/api/3/project\\\", \\\"/rest/api/3/search/jql\\\", \\\"/rest/api/3/issue/{issueIdOrKey}\\\"\",\"minLength\":1,\"type\":\"string\"},\"queryParams\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"Optional query parameters as key-value pairs. Examples: {\\\"maxResults\\\": \\\"50\\\", \\\"startAt\\\": \\\"0\\\", \\\"jql\\\": \\\"project=PROJ\\\", \\\"fields\\\": \\\"summary,status\\\"}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"path\"],\"type\":\"object\"},\"name\":\"jira_delete\",\"title\":\"Jira DELETE Request\"}"},{"name":"jira_get","hash":"f746fa5d7354d0849776c5e7a58b529ec438598459cf496fc39830e64e9088ce","canonical_json":"{\"description\":\"Read any Jira data. Returns TOON format by default (30-60% fewer tokens than JSON).\\n\\n**IMPORTANT - Cost Optimization:**\\n- ALWAYS use `jq` param to filter response fields. Unfiltered responses are very expensive!\\n- Use `maxResults` query param to restrict result count (e.g., `maxResults: \\\"5\\\"`)\\n- If unsure about available fields, first fetch ONE item with `maxResults: \\\"1\\\"` and NO jq filter to explore the schema, then use jq in subsequent calls\\n\\n**Schema Discovery Pattern:**\\n1. First call: `path: \\\"/rest/api/3/search/jql\\\", queryParams: {\\\"maxResults\\\": \\\"1\\\", \\\"jql\\\": \\\"project=PROJ\\\"}` (no jq) - explore available fields\\n2. Then use: `jq: \\\"issues[*].{key: key, summary: fields.summary, status: fields.status.name}\\\"` - extract only what you need\\n\\n**Output format:** TOON (default, token-efficient) or JSON (`outputFormat: \\\"json\\\"`)\\n\\n**Common paths:**\\n- `/rest/api/3/project` - list all projects\\n- `/rest/api/3/project/{projectKeyOrId}` - get project details\\n- `/rest/api/3/search/jql` - search issues with JQL (use `jql` query param). NOTE: `/rest/api/3/search` is deprecated!\\n- `/rest/api/3/issue/{issueIdOrKey}` - get issue details\\n- `/rest/api/3/issue/{issueIdOrKey}/comment` - list issue comments\\n- `/rest/api/3/issue/{issueIdOrKey}/worklog` - list issue worklogs\\n- `/rest/api/3/issue/{issueIdOrKey}/transitions` - get available transitions\\n- `/rest/api/3/user/search` - search users (use `query` param)\\n- `/rest/api/3/status` - list all statuses\\n- `/rest/api/3/issuetype` - list issue types\\n- `/rest/api/3/priority` - list priorities\\n\\n**JQ examples:** `issues[*].key`, `issues[0]`, `issues[*].{key: key, summary: fields.summary}`\\n\\n**Example JQL queries:** `project=PROJ`, `assignee=currentUser()`, `status=\\\"In Progress\\\"`, `created >= -7d`\\n\\nAPI reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"jq\":{\"description\":\"JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: \\\"issues[*].{key: key, summary: fields.summary}\\\" (extract specific fields), \\\"issues[0]\\\" (first result), \\\"issues[*].key\\\" (keys only). See https://jmespath.org\",\"type\":\"string\"},\"outputFormat\":{\"description\":\"Output format: \\\"toon\\\" (default, 30-60% fewer tokens) or \\\"json\\\". TOON is optimized for LLMs with tabular arrays and minimal syntax.\",\"enum\":[\"toon\",\"json\"],\"type\":\"string\"},\"path\":{\"description\":\"The Jira API endpoint path (without base URL). Must start with \\\"/\\\". Examples: \\\"/rest/api/3/project\\\", \\\"/rest/api/3/search/jql\\\", \\\"/rest/api/3/issue/{issueIdOrKey}\\\"\",\"minLength\":1,\"type\":\"string\"},\"queryParams\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"Optional query parameters as key-value pairs. Examples: {\\\"maxResults\\\": \\\"50\\\", \\\"startAt\\\": \\\"0\\\", \\\"jql\\\": \\\"project=PROJ\\\", \\\"fields\\\": \\\"summary,status\\\"}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"path\"],\"type\":\"object\"},\"name\":\"jira_get\",\"title\":\"Jira GET Request\"}"},{"name":"jira_patch","hash":"c53e9aa1206aaf29df213772733f78cb5122f32bf60842e2b1b6cc8975ce6170","canonical_json":"{\"description\":\"Partially update Jira resources. Returns TOON format by default.\\n\\n**IMPORTANT - Cost Optimization:** Use `jq` param to filter response fields.\\n\\n**Output format:** TOON (default) or JSON (`outputFormat: \\\"json\\\"`)\\n\\n**Common operations:**\\n\\n1. **Update issue fields:** `/rest/api/3/issue/{issueIdOrKey}`\\n body: `{\\\"fields\\\": {\\\"summary\\\": \\\"Updated title\\\"}}` (only updates specified fields)\\n\\n2. **Update comment:** `/rest/api/3/issue/{issueIdOrKey}/comment/{commentId}`\\n body: `{\\\"body\\\": {\\\"type\\\": \\\"doc\\\", \\\"version\\\": 1, \\\"content\\\": [{\\\"type\\\": \\\"paragraph\\\", \\\"content\\\": [{\\\"type\\\": \\\"text\\\", \\\"text\\\": \\\"Updated comment\\\"}]}]}}`\\n\\n3. **Update worklog:** `/rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}`\\n body: `{\\\"timeSpentSeconds\\\": 7200}`\\n\\nNote: PATCH only updates the fields you specify, leaving others unchanged.\\n\\nAPI reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"body\":{\"additionalProperties\":{},\"description\":\"Request body as a JSON object. Structure depends on the endpoint. Example for issue: {\\\"fields\\\": {\\\"project\\\": {\\\"key\\\": \\\"PROJ\\\"}, \\\"summary\\\": \\\"Issue title\\\", \\\"issuetype\\\": {\\\"name\\\": \\\"Task\\\"}}}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"jq\":{\"description\":\"JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: \\\"issues[*].{key: key, summary: fields.summary}\\\" (extract specific fields), \\\"issues[0]\\\" (first result), \\\"issues[*].key\\\" (keys only). See https://jmespath.org\",\"type\":\"string\"},\"outputFormat\":{\"description\":\"Output format: \\\"toon\\\" (default, 30-60% fewer tokens) or \\\"json\\\". TOON is optimized for LLMs with tabular arrays and minimal syntax.\",\"enum\":[\"toon\",\"json\"],\"type\":\"string\"},\"path\":{\"description\":\"The Jira API endpoint path (without base URL). Must start with \\\"/\\\". Examples: \\\"/rest/api/3/project\\\", \\\"/rest/api/3/search/jql\\\", \\\"/rest/api/3/issue/{issueIdOrKey}\\\"\",\"minLength\":1,\"type\":\"string\"},\"queryParams\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"Optional query parameters as key-value pairs. Examples: {\\\"maxResults\\\": \\\"50\\\", \\\"startAt\\\": \\\"0\\\", \\\"jql\\\": \\\"project=PROJ\\\", \\\"fields\\\": \\\"summary,status\\\"}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"path\",\"body\"],\"type\":\"object\"},\"name\":\"jira_patch\",\"title\":\"Jira PATCH Request\"}"},{"name":"jira_post","hash":"f930c58ef593372d553480f58a6ee67ffcd086cb5fd2fc21da4eed332dc1fa82","canonical_json":"{\"description\":\"Create Jira resources. Returns TOON format by default (token-efficient).\\n\\n**IMPORTANT - Cost Optimization:**\\n- Use `jq` param to extract only needed fields from response (e.g., `jq: \\\"{key: key, id: id}\\\"`)\\n- Unfiltered responses include all metadata and are expensive!\\n\\n**Output format:** TOON (default) or JSON (`outputFormat: \\\"json\\\"`)\\n\\n**Common operations:**\\n\\n1. **Create issue:** `/rest/api/3/issue`\\n body: `{\\\"fields\\\": {\\\"project\\\": {\\\"key\\\": \\\"PROJ\\\"}, \\\"summary\\\": \\\"Issue title\\\", \\\"issuetype\\\": {\\\"name\\\": \\\"Task\\\"}, \\\"description\\\": {\\\"type\\\": \\\"doc\\\", \\\"version\\\": 1, \\\"content\\\": [{\\\"type\\\": \\\"paragraph\\\", \\\"content\\\": [{\\\"type\\\": \\\"text\\\", \\\"text\\\": \\\"Description\\\"}]}]}}}`\\n\\n2. **Add comment:** `/rest/api/3/issue/{issueIdOrKey}/comment`\\n body: `{\\\"body\\\": {\\\"type\\\": \\\"doc\\\", \\\"version\\\": 1, \\\"content\\\": [{\\\"type\\\": \\\"paragraph\\\", \\\"content\\\": [{\\\"type\\\": \\\"text\\\", \\\"text\\\": \\\"Comment text\\\"}]}]}}`\\n\\n3. **Add worklog:** `/rest/api/3/issue/{issueIdOrKey}/worklog`\\n body: `{\\\"timeSpentSeconds\\\": 3600, \\\"comment\\\": {\\\"type\\\": \\\"doc\\\", \\\"version\\\": 1, \\\"content\\\": [{\\\"type\\\": \\\"paragraph\\\", \\\"content\\\": [{\\\"type\\\": \\\"text\\\", \\\"text\\\": \\\"Work done\\\"}]}]}}`\\n\\n4. **Transition issue:** `/rest/api/3/issue/{issueIdOrKey}/transitions`\\n body: `{\\\"transition\\\": {\\\"id\\\": \\\"31\\\"}}`\\n\\n5. **Add attachment:** `/rest/api/3/issue/{issueIdOrKey}/attachments`\\n Note: Requires multipart form data (complex - use Jira UI for attachments)\\n\\nAPI reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"body\":{\"additionalProperties\":{},\"description\":\"Request body as a JSON object. Structure depends on the endpoint. Example for issue: {\\\"fields\\\": {\\\"project\\\": {\\\"key\\\": \\\"PROJ\\\"}, \\\"summary\\\": \\\"Issue title\\\", \\\"issuetype\\\": {\\\"name\\\": \\\"Task\\\"}}}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"jq\":{\"description\":\"JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: \\\"issues[*].{key: key, summary: fields.summary}\\\" (extract specific fields), \\\"issues[0]\\\" (first result), \\\"issues[*].key\\\" (keys only). See https://jmespath.org\",\"type\":\"string\"},\"outputFormat\":{\"description\":\"Output format: \\\"toon\\\" (default, 30-60% fewer tokens) or \\\"json\\\". TOON is optimized for LLMs with tabular arrays and minimal syntax.\",\"enum\":[\"toon\",\"json\"],\"type\":\"string\"},\"path\":{\"description\":\"The Jira API endpoint path (without base URL). Must start with \\\"/\\\". Examples: \\\"/rest/api/3/project\\\", \\\"/rest/api/3/search/jql\\\", \\\"/rest/api/3/issue/{issueIdOrKey}\\\"\",\"minLength\":1,\"type\":\"string\"},\"queryParams\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"Optional query parameters as key-value pairs. Examples: {\\\"maxResults\\\": \\\"50\\\", \\\"startAt\\\": \\\"0\\\", \\\"jql\\\": \\\"project=PROJ\\\", \\\"fields\\\": \\\"summary,status\\\"}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"path\",\"body\"],\"type\":\"object\"},\"name\":\"jira_post\",\"title\":\"Jira POST Request\"}"},{"name":"jira_put","hash":"686002c998f8e6e2730d755b35b9d0961f9696a04ed0c4f11c5efa546954f4ab","canonical_json":"{\"description\":\"Replace Jira resources (full update). Returns TOON format by default.\\n\\n**IMPORTANT - Cost Optimization:** Use `jq` param to extract only needed fields from response\\n\\n**Output format:** TOON (default) or JSON (`outputFormat: \\\"json\\\"`)\\n\\n**Common operations:**\\n\\n1. **Update issue (full):** `/rest/api/3/issue/{issueIdOrKey}`\\n body: `{\\\"fields\\\": {\\\"summary\\\": \\\"New title\\\", \\\"description\\\": {...}, \\\"assignee\\\": {\\\"accountId\\\": \\\"...\\\"}}}`\\n\\n2. **Update project:** `/rest/api/3/project/{projectIdOrKey}`\\n body: `{\\\"name\\\": \\\"New Project Name\\\", \\\"description\\\": \\\"Updated description\\\"}`\\n\\n3. **Set issue property:** `/rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey}`\\n body: `{\\\"value\\\": \\\"property value\\\"}`\\n\\nNote: PUT replaces the entire resource. For partial updates, prefer PATCH.\\n\\nAPI reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"properties\":{\"body\":{\"additionalProperties\":{},\"description\":\"Request body as a JSON object. Structure depends on the endpoint. Example for issue: {\\\"fields\\\": {\\\"project\\\": {\\\"key\\\": \\\"PROJ\\\"}, \\\"summary\\\": \\\"Issue title\\\", \\\"issuetype\\\": {\\\"name\\\": \\\"Task\\\"}}}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"},\"jq\":{\"description\":\"JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: \\\"issues[*].{key: key, summary: fields.summary}\\\" (extract specific fields), \\\"issues[0]\\\" (first result), \\\"issues[*].key\\\" (keys only). See https://jmespath.org\",\"type\":\"string\"},\"outputFormat\":{\"description\":\"Output format: \\\"toon\\\" (default, 30-60% fewer tokens) or \\\"json\\\". TOON is optimized for LLMs with tabular arrays and minimal syntax.\",\"enum\":[\"toon\",\"json\"],\"type\":\"string\"},\"path\":{\"description\":\"The Jira API endpoint path (without base URL). Must start with \\\"/\\\". Examples: \\\"/rest/api/3/project\\\", \\\"/rest/api/3/search/jql\\\", \\\"/rest/api/3/issue/{issueIdOrKey}\\\"\",\"minLength\":1,\"type\":\"string\"},\"queryParams\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"Optional query parameters as key-value pairs. Examples: {\\\"maxResults\\\": \\\"50\\\", \\\"startAt\\\": \\\"0\\\", \\\"jql\\\": \\\"project=PROJ\\\", \\\"fields\\\": \\\"summary,status\\\"}\",\"propertyNames\":{\"type\":\"string\"},\"type\":\"object\"}},\"required\":[\"path\",\"body\"],\"type\":\"object\"},\"name\":\"jira_put\",\"title\":\"Jira PUT Request\"}"}],"entry_hash":"2ad836efd0560f35e8d00428152dbb8b9889101ecb4c235a5605a89e4f5f821a"} {"seq":5,"prev_entry_hash":"2ad836efd0560f35e8d00428152dbb8b9889101ecb4c235a5605a89e4f5f821a","observed_at":"2026-09-02T07:55:06.341Z","server_id":"9bebbec14fb8af60","server_name":"@ironbee-ai/devtools","source":"npm","set_hash":"950f665f888c2ba9c39a75b379018907802b2b8475bdce8ad58f2e5d6fe9f253","tools":[{"name":"a11y_take-aria-snapshot","hash":"9f4c6009c8d893ac2a14de8860d6ead5a52725180c46f33238caa333ae2d0e47","canonical_json":"{\"description\":\"ARIA snapshot of the page or a scoped element. Returns a tree with refs (e1, e2, ...) and a refs map.\\nUse refs in interaction tools: selector \\\"e1\\\" or \\\"@e1\\\" to click/fill that element. Output includes URL, title, and YAML tree.\\nRefs are valid until next snapshot or navigation. interactiveOnly: only interactive elements get refs; omit for content roles (headings, etc.) too.\\ncursorInteractive: true adds refs for clickable elements without ARIA (e.g. div with cursor:pointer/onclick).\\nUse with a11y_take-ax-tree-snapshot for full UI analysis.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"additionalProperties\":false,\"properties\":{\"compact\":{\"description\":\"Omit structural nodes without content.\",\"type\":\"boolean\"},\"cursorInteractive\":{\"default\":false,\"description\":\"Include cursor:pointer / onclick elements.\",\"type\":\"boolean\"},\"interactiveOnly\":{\"description\":\"Only interactive elements get refs.\",\"type\":\"boolean\"},\"maxDepth\":{\"description\":\"Max tree depth; 0 = root only.\",\"minimum\":0,\"type\":\"integer\"},\"selector\":{\"description\":\"Scope to this element; omit for full page. If it matches nothing, the full page is returned with a note.\",\"type\":\"string\"}},\"type\":\"object\"},\"name\":\"a11y_take-aria-snapshot\",\"outputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"additionalProperties\":false,\"properties\":{\"output\":{\"description\":\"Includes the page URL, title, and a YAML-formatted accessibility tree with [ref=e1] etc.\",\"type\":\"string\"},\"refs\":{\"additionalProperties\":{\"additionalProperties\":false,\"properties\":{\"name\":{\"type\":\"string\"},\"nth\":{\"type\":\"number\"},\"role\":{\"type\":\"string\"},\"selector\":{\"type\":\"string\"}},\"required\":[\"role\",\"selector\"],\"type\":\"object\"},\"description\":\"Map of ref id to { role, name?, selector, nth? }. Use selector \\\"e1\\\" or \\\"@e1\\\" in interaction tools.\",\"type\":\"object\"}},\"required\":[\"output\",\"refs\"],\"type\":\"object\"}}"},{"name":"a11y_take-ax-tree-snapshot","hash":"0119448ebf5cbb566849969b2981f5903aab48f64eb0297f61cdc08b4e77b5a0","canonical_json":"{\"description\":\"Combines Chromium AX tree with runtime visual diagnostics (bounding box, visibility, viewport).\\nUse to detect: elements with role/name but hidden or off-screen; layout/geometry issues; overlap/occlusion (enable checkOcclusion).\\nWhen investigating UI/layout or when clicks fail on seemingly visible elements, set checkOcclusion:true—it uses elementFromPoint()\\nat center+corners to find what is actually on top. boundingBox is from getBoundingClientRect() (viewport coords; layout box only).\\nselectorHint is best-effort (data-testid/data-selector/id). Use with a11y_take-aria-snapshot for full UI analysis.\",\"execution\":{\"taskSupport\":\"forbidden\"},\"inputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"additionalProperties\":false,\"properties\":{\"checkOcclusion\":{\"default\":false,\"description\":\"Use elementFromPoint to detect what is on top.\",\"type\":\"boolean\"},\"includeRuntimeVisual\":{\"default\":true,\"description\":\"Include bounding box and visibility.\",\"type\":\"boolean\"},\"includeStyles\":{\"default\":true,\"type\":\"boolean\"},\"onlyInViewport\":{\"default\":false,\"type\":\"boolean\"},\"onlyVisible\":{\"default\":false,\"type\":\"boolean\"},\"roles\":{\"description\":\"ARIA/AX role names to include; omit for default set. Standard roles: ARIA https://w3c.github.io/aria/#role_definitions, Chromium AX https://chromium.googlesource.com/chromium/src/+/main/ui/accessibility/ax_enum_util.cc (e.g. button, heading, staticText, image, main, navigation). Matching is case-insensitive; \\\"text\\\" also matches staticText, \\\"img\\\" matches image.\",\"items\":{\"minLength\":1,\"type\":\"string\"},\"type\":\"array\"},\"styleProperties\":{\"default\":[\"display\",\"visibility\",\"opacity\",\"pointer-events\",\"position\",\"z-index\",\"color\",\"background-color\",\"border-color\",\"border-width\",\"border-style\",\"font-family\",\"font-size\",\"font-weight\",\"line-height\",\"letter-spacing\",\"text-align\",\"text-decoration-line\",\"white-space\",\"overflow\",\"overflow-x\",\"overflow-y\",\"transform\",\"cursor\"],\"description\":\"CSS property names when includeStyles.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"textPreviewMaxLength\":{\"default\":80,\"exclusiveMinimum\":0,\"type\":\"integer\"}},\"type\":\"object\"},\"name\":\"a11y_take-ax-tree-snapshot\",\"outputSchema\":{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"additionalProperties\":false,\"properties\":{\"axNodeCount\":{\"description\":\"Total number of nodes returned by Chromium Accessibility.getFullAXTree before filtering.\",\"minimum\":0,\"type\":\"integer\"},\"candidateCount\":{\"description\":\"Number of DOM-backed AX nodes that passed role filtering before enrichment.\",\"minimum\":0,\"type\":\"integer\"},\"enrichedCount\":{\"description\":\"Number of nodes included in the final enriched snapshot output.\",\"minimum\":0,\"type\":\"integer\"},\"nodes\":{\"description\":\"List of enriched DOM-backed AX nodes combining accessibility metadata with visual diagnostics.\",\"items\":{\"additionalProperties\":false,\"properties\":{\"axNodeId\":{\"description\":\"Unique identifier of the accessibility node within the AX tree.\",\"type\":\"string\"},\"backendDOMNodeId\":{\"description\":\"Chromium backend DOM node identifier used to map AX nodes to DOM elements.\",\"type\":\"integer\"},\"childAxNodeIds\":{\"description\":\"Child AX node ids in the full AX tree (may include nodes not present in the filtered output).\",\"items\":{\"type\":\"string\"},\"type\":\"array\"},\"className\":{\"description\":\"DOM class attribute of the mapped element.\",\"type\":[\"string\",\"null\"]},\"description\":{\"anyOf\":[{},{\"type\":\"null\"}],\"description\":\"Raw AX description payload associated with the node, if present.\"},\"domNodeId\":{\"anyOf\":[{\"type\":\"integer\"},{\"type\":\"null\"}],\"description\":\"Resolved DOM nodeId from CDP if available; may be null because nodeId is not guaranteed to be stable/resolved.\"},\"frameId\":{\"description\":\"Frame identifier if the node belongs to an iframe or subframe.\",\"type\":[\"string\",\"null\"]},\"id\":{\"description\":\"DOM id attribute of the mapped element.\",\"type\":[\"string\",\"null\"]},\"ignored\":{\"description\":\"Whether the accessibility node is marked as ignored.\",\"type\":[\"boolean\",\"null\"]},\"localName\":{\"description\":\"Lowercased DOM tag name of the mapped element (e.g. div, button, input).\",\"type\":[\"string\",\"null\"]},\"name\":{\"description\":\"Accessible name computed by the browser accessibility engine.\",\"type\":[\"string\",\"null\"]},\"parentAxNodeId\":{\"description\":\"Parent AX node id in the full AX tree. Null if this node is a root.\",\"type\":[\"string\",\"null\"]},\"properties\":{\"anyOf\":[{\"type\":\"array\"},{\"type\":\"null\"}],\"description\":\"Additional AX properties exposed by the accessibility tree.\"},\"role\":{\"description\":\"ARIA role of the accessibility node (e.g. button, link, textbox).\",\"type\":[\"string\",\"null\"]},\"runtime\":{\"additionalProperties\":false,\"description\":\"Runtime-derived visual information representing how the element is actually rendered.\",\"properties\":{\"boundingBox\":{\"anyOf\":[{\"additionalProperties\":false,\"properties\":{\"height\":{\"description\":\"Height of the element in CSS pixels.\",\"type\":\"number\"},\"width\":{\"description\":\"Width of the element in CSS pixels.\",\"type\":\"number\"},\"x\":{\"description\":\"X coordinate of the element relative to the viewport.\",\"type\":\"number\"},\"y\":{\"description\":\"Y coordinate of the element relative to the viewport.\",\"type\":\"number\"}},\"required\":[\"x\",\"y\",\"width\",\"height\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"Bounding box computed at runtime using getBoundingClientRect.\"},\"isInViewport\":{\"description\":\"Whether the element intersects the current viewport.\",\"type\":\"boolean\"},\"isVisible\":{\"description\":\"Whether the element is considered visually visible (display, visibility, opacity, and size).\",\"type\":\"boolean\"},\"occlusion\":{\"additionalProperties\":false,\"description\":\"Occlusion detection results. Only present when checkOcclusion=true.\",\"properties\":{\"intersection\":{\"anyOf\":[{\"additionalProperties\":false,\"properties\":{\"area\":{\"description\":\"Intersection rect area in CSS pixels squared.\",\"type\":\"number\"},\"height\":{\"description\":\"Intersection rect height.\",\"type\":\"number\"},\"width\":{\"description\":\"Intersection rect width.\",\"type\":\"number\"},\"x\":{\"description\":\"Intersection rect X.\",\"type\":\"number\"},\"y\":{\"description\":\"Intersection rect Y.\",\"type\":\"number\"}},\"required\":[\"x\",\"y\",\"width\",\"height\",\"area\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"Intersection box between this element and the occluding element. Null if not occluded or cannot compute.\"},\"isOccluded\":{\"description\":\"True if at least one sample point is covered by another element.\",\"type\":\"boolean\"},\"samplePoints\":{\"description\":\"Sample points used for occlusion detection (center + corners).\",\"items\":{\"additionalProperties\":false,\"properties\":{\"hit\":{\"description\":\"True if elementFromPoint at this point returned a different element that is not a descendant.\",\"type\":\"boolean\"},\"x\":{\"description\":\"Sample point X (viewport coordinates) used for occlusion testing.\",\"type\":\"number\"},\"y\":{\"description\":\"Sample point Y (viewport coordinates) used for occlusion testing.\",\"type\":\"number\"}},\"required\":[\"x\",\"y\",\"hit\"],\"type\":\"object\"},\"type\":\"array\"},\"topElement\":{\"anyOf\":[{\"additionalProperties\":false,\"properties\":{\"boundingBox\":{\"anyOf\":[{\"additionalProperties\":false,\"properties\":{\"height\":{\"description\":\"Height of the occluding element bounding box.\",\"type\":\"number\"},\"width\":{\"description\":\"Width of the occluding element bounding box.\",\"type\":\"number\"},\"x\":{\"description\":\"X coordinate of the occluding element bounding box.\",\"type\":\"number\"},\"y\":{\"description\":\"Y coordinate of the occluding element bounding box.\",\"type\":\"number\"}},\"required\":[\"x\",\"y\",\"width\",\"height\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"Bounding box of the occluding element (if available).\"},\"className\":{\"description\":\"DOM class of the occluding element (may be null if none).\",\"type\":[\"string\",\"null\"]},\"id\":{\"description\":\"DOM id of the occluding element (may be null if none).\",\"type\":[\"string\",\"null\"]},\"localName\":{\"description\":\"Tag name of the occluding element.\",\"type\":[\"string\",\"null\"]},\"selectorHint\":{\"description\":\"Best-effort selector hint for the occluding element.\",\"type\":[\"string\",\"null\"]}},\"required\":[\"localName\",\"id\",\"className\",\"selectorHint\",\"boundingBox\"],\"type\":\"object\"},{\"type\":\"null\"}],\"description\":\"Identity and geometry of the occluding element. Null when not occluded.\"}},\"required\":[\"samplePoints\",\"isOccluded\",\"topElement\",\"intersection\"],\"type\":\"object\"}},\"required\":[\"boundingBox\",\"isVisible\",\"isInViewport\"],\"type\":\"object\"},\"selectorHint\":{\"description\":\"Best-effort selector hint for targeting this element (prefers data-testid/data-selector/id).\",\"type\":[\"string\",\"null\"]},\"styles\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"Subset of computed CSS styles for the element as string key-value pairs.\",\"type\":\"object\"},\"textPreview\":{\"description\":\"Short preview of rendered text content or aria-label, truncated to the configured maximum length.\",\"type\":[\"string\",\"null\"]},\"value\":{\"anyOf\":[{},{\"type\":\"null\"}],\"description\":\"Raw AX value payload associated with the node, if present.\"}},\"required\":[\"axNodeId\",\"parentAxNodeId\",\"childAxNodeIds\",\"role\",\"name\",\"ignored\",\"backendDOMNodeId\",\"domNodeId\",\"frameId\",\"localName\",\"id\",\"className\",\"selectorHint\",\"textPreview\",\"properties\"],\"type\":\"object\"},\"type\":\"array\"},\"title\":{\"description\":\"The document title of the page at the time of the snapshot.\",\"type\":\"string\"},\"truncatedBySafetyCap\":{\"description\":\"Indicates whether the result set was truncated by an internal safety cap to prevent excessive output size.\",\"type\":\"boolean\"},\"url\":{\"description\":\"The current page URL at the time the AX snapshot was captured.\",\"type\":\"string\"}},\"required\":[\"url\",\"title\",\"axNodeCount\",\"candidateCount\",\"enrichedCount\",\"truncatedBySafetyCap\",\"nodes\"],\"type\":\"object\"}}"},{"name":"content_get-as-html","hash":"a6c9154eabbfd2c159a9db4ccbb523758608f4c7f96f7a44cebe85d68770eaab","canonical_json":"{\"description\":\"\\nGets the HTML content of the current page. \\nBy default, all