io.github.TsvetanG2/cognigy-ai-mcp-management-server
NPM · COGNIGY-AI-MCP-MANAGEMENT-SERVER · SCANNED AUG 3
MCP server for Cognigy.AI - 132 tools to build, configure & operate conversational AI agents
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 6 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability79
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 14859 tokens (~107/item across 138 items; 138 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · cognigy-ai-mcp-management-server
claude mcp add tsvetang2-cognigy-ai-mcp-management-server -- npx -y cognigy-ai-mcp-management-server
codex mcp add tsvetang2-cognigy-ai-mcp-management-server -- npx -y cognigy-ai-mcp-management-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"tsvetang2-cognigy-ai-mcp-management-server": {
"type": "local",
"command": [
"npx",
"-y",
"cognigy-ai-mcp-management-server"
],
"enabled": true
}
}
} openclaw mcp add tsvetang2-cognigy-ai-mcp-management-server --command npx --arg -y --arg cognigy-ai-mcp-management-server
mcp_servers:
tsvetang2-cognigy-ai-mcp-management-server:
command: "npx"
args: ["-y", "cognigy-ai-mcp-management-server"] {
"mcpServers": {
"tsvetang2-cognigy-ai-mcp-management-server": {
"command": "npx",
"args": [
"-y",
"cognigy-ai-mcp-management-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +38
- Known CVEs: unverified → partial ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- 2 Aug 26 −26
- Known CVEs: partial → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Dependency health: partial → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- First check of Schema quality: unverified functional
- 1 Aug 26 +18
- Provenance: unverified → fail ▼ security
- GHSA-frvp-7c67-39w9 no longer affects this package ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
- 31 Jul 26 −5
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 28 Jul 26 −20
- Install scripts: pass → unverified ▼ security
- Known CVEs: fail → unverified ▼ security
- Provenance: fail → unverified ▼ security
- GHSA-frvp-7c67-39w9 no longer affects this package ▲ security
- Maintenance: pass → unverified ▼ functional
- Dependency health: partial → unverified ▼ functional
- License: pass → unverified ▼ functional
- Licence: MIT functional
- 27 Jul 26 61
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
merge_contact_profiles ~118
Merges two Cognigy.AI contact profiles into one. The source profile data is merged into the target, and all contact IDs are combined. Use when the same user has multiple profiles. MUTATING: Set dryRun=false to merge.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without merging. Set to false to actually merge. |
| sourceProfileId | string | yes | The source profile ID (will be merged into target) |
| targetProfileId | string | yes | The target profile ID (will receive the merged data) |
No output schema declared.
No examples provided.
merge_package ~185
Merges a package into a Cognigy.AI project, importing selected resources. Use localeMapping to map package locales to project locales. MUTATING: Set dryRun=false to merge. Async operation.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without merging. Set to false to actually merge. WARNING: This modifies the target project! |
| localeMapping | array | yes | Mapping of package locales to project locales |
| packageId | string | yes | The package ID to merge |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| resourceIds | array | yes | Array of resource IDs from the package to import |
| strategies | array | — | Optional conflict resolution strategies per resource type |
| timeoutMs | integer | — | Maximum time to wait for merge (5-600 seconds, default 180) |
No output schema declared.
No examples provided.
move_node ~180
Moves a node to a new position in a Cognigy.AI flow. MUTATING: This reorganizes the flow structure. Use dryRun=true (default) to validate first. Moving nodes affects execution order.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates the operation without moving. Set to false to actually move the node. |
| flowId | string | yes | The flow ID containing the node |
| mode | string | yes | How to position relative to target: append (as next sibling), prepend (as previous sibling), insertChildAt (as child at position), insertAfter, insertBefore |
| nodeId | string | yes | The ID of the node to move |
| position | integer | — | Position index when using insertChildAt mode |
| targetNodeId | string | yes | The ID of the target node to move relative to |
No output schema declared.
No examples provided.
package_snapshot ~137
Packages a Cognigy.AI snapshot for download or transfer. Creates a downloadable package from the snapshot. Use create_snapshot_download_link after packaging to get the download URL. MUTATING: Set dryRun=false to package. Async operation.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without packaging. Set to false to actually package. |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| snapshotId | string | yes | The snapshot ID to package |
| timeoutMs | integer | — | Maximum time to wait for packaging (5-600 seconds, default 120) |
No output schema declared.
No examples provided.
promote_snapshot ~139
Promotes a Cognigy.AI snapshot for deployment by packaging it and generating a download link. Use this to prepare a snapshot for transfer to another environment. MUTATING: Set dryRun=false to package. Async operation.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without packaging. Set to false to actually package and generate download link. |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| snapshotId | string | yes | The snapshot ID to promote |
| timeoutMs | integer | — | Maximum time to wait for packaging (5-600 seconds, default 180) |
No output schema declared.
No examples provided.
remove_contact_id ~100
Removes a contact ID from a Cognigy.AI contact profile. Use this when a user identifier should no longer be associated with a profile. MUTATING: Set dryRun=false to remove.
| Name | Type | Req | Description |
|---|---|---|---|
| contactId | string | yes | The contact ID to remove from the profile |
| dryRun | boolean | — | If true (default), validates without removing. Set to false to actually remove. |
| profileId | string | yes | The contact profile ID to modify |
No output schema declared.
No examples provided.
reset_context ~97
Resets the context for a Cognigy.AI session, clearing all stored state. Use this to start a fresh conversation or clear user data during testing.
| Name | Type | Req | Description |
|---|---|---|---|
| entrypoint | string | yes | The entrypoint (project or snapshot ID) |
| flowReferenceId | string | yes | The flow reference ID |
| sessionId | string | yes | The session ID to reset context for |
| userId | string | yes | The user ID for the session |
No output schema declared.
No examples provided.
restore_snapshot ~147
Restores a snapshot to its Cognigy.AI project, replacing the current configuration. DESTRUCTIVE: Current project state will be overwritten with the snapshot's state. Use dryRun=true (default) to validate first. Async operation.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without restoring. Set to false to actually restore. WARNING: This replaces the current project configuration! |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| snapshotId | string | yes | The snapshot ID to restore |
| timeoutMs | integer | — | Maximum time to wait for restore (5-600 seconds, default 180) |
No output schema declared.
No examples provided.
run_knowledge_connector ~100
Triggers a Cognigy.AI knowledge connector to run immediately. Pulls content from the external source and creates/updates knowledge chunks. MUTATING: Set dryRun=false to run.
| Name | Type | Req | Description |
|---|---|---|---|
| connectorId | string | yes | The knowledge connector ID to run |
| dryRun | boolean | — | If true (default), validates without running. Set to false to actually run. |
| knowledgeStoreId | string | yes | The knowledge store ID containing the connector |
No output schema declared.
No examples provided.
run_playbook ~187
Runs a Cognigy.AI playbook test scenario against a flow. MUTATING: This executes test assertions. Use dryRun=true (default) to validate first. Returns pass/fail results with assertion details.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without running. Set to false to actually run the playbook. |
| entrypoint | string | yes | The snapshot or project ID to run against |
| flowId | string | yes | The reference ID of the flow to test |
| localeId | string | yes | The reference ID of the locale |
| playbookId | string | yes | The playbook ID to run |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| timeoutMs | integer | — | Maximum time to wait for playbook completion (5-300 seconds, default 120) |
No output schema declared.
No examples provided.
run_regression ~169
Runs all Cognigy.AI playbooks in a project as a regression test suite. MUTATING: This executes tests. Use dryRun=true (default) to preview. Returns pass/fail summary with failing playbooks highlighted.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), lists playbooks without running. Set to false to actually run. |
| entrypoint | string | — | Optional snapshot ID. If not provided, uses the project as entrypoint. |
| flowId | string | yes | The flow reference ID to test against |
| localeId | string | yes | The locale reference ID |
| projectId | string | yes | The project ID to run regression tests for |
| timeoutPerPlaybook | integer | — | Timeout per playbook in ms (10-300 seconds, default 60) |
No output schema declared.
No examples provided.
score_utterance ~144
Scores a test utterance against a Cognigy.AI flow's trained NLU intents. Returns the best matching intent with confidence score. Use this to quickly test if an utterance would be recognized correctly.
| Name | Type | Req | Description |
|---|---|---|---|
| flowId | string | yes | The flow ID to score against (will be converted to reference ID) |
| localeId | string | — | Optional locale ID (will use flow's default if not provided) |
| projectId | string | yes | The project ID containing the flow |
| threshold | number | — | Minimum score threshold to include in results (0-1, default 0.4) |
| utterance | string | yes | The test utterance to score |
No output schema declared.
No examples provided.
search_nodes ~93
Searches for nodes in a Cognigy.AI flow by text content. Finds nodes containing the search term in their configuration (messages, conditions, code, etc.). Use this to locate specific content within large flows.
| Name | Type | Req | Description |
|---|---|---|---|
| flowId | string | yes | The flow ID to search within |
| localeId | string | yes | The locale ID to search in |
| query | string | yes | The search text to find in node content |
No output schema declared.
No examples provided.
search_resources ~124
Searches across all Cognigy.AI resources in the organization. Finds flows, intents, endpoints, functions, playbooks, and more by name or content. Powerful for discovering resources across projects.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum number of results to return (default: 25, max: 100) |
| projectId | string | — | Filter results to a specific project |
| query | string | yes | Search query string |
| resourceTypes | array | — | Filter by resource types (defaults to all types) |
| skip | number | — | Number of items to skip for pagination |
No output schema declared.
No examples provided.
set_contact_profile_schema ~96
Sets the contact profile schema for a Cognigy.AI project. Defines what custom fields can be stored in contact profiles. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| projectId | string | yes | The project ID to set the profile schema for |
| schema | array | yes | Array of schema field definitions |
No output schema declared.
No examples provided.
stop_function_instance ~89
Stops a running Cognigy.AI Function instance. Use this to cancel a long-running or stuck function. MUTATING: Set dryRun=false to stop.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without stopping. Set to false to actually stop. |
| functionId | string | yes | The function ID |
| functionInstanceId | string | yes | The function instance ID to stop |
No output schema declared.
No examples provided.
test_llm_connection ~66
Tests the connection to a Cognigy.AI large language model provider. Validates that the credentials are correct and the provider is reachable. Use this to verify LLM setup before using it in flows.
| Name | Type | Req | Description |
|---|---|---|---|
| largeLanguageModelId | string | yes | The LLM ID to test |
No output schema declared.
No examples provided.
train_intents ~184
Trains the NLU model for a Cognigy.AI flow. MUTATING: This triggers model training. Use dryRun=true (default) to validate first. Training is async - this tool polls until completion or timeout.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without training. Set to false to actually train. |
| flowId | string | yes | The flow ID to train intents for |
| localeId | string | — | Specific locale to train. If omitted, trains all locales. |
| mode | string | — | Training mode: 'full' for complete retraining, 'quick' for incremental updates |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 2) |
| timeoutMs | integer | — | Maximum time to wait for training to complete (5-300 seconds, default 60) |
No output schema declared.
No examples provided.
trigger_function ~89
Triggers a Cognigy.AI Function to run immediately. Creates a new function instance that executes the function code. MUTATING: Set dryRun=false to trigger.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without triggering. Set to false to actually trigger. |
| functionId | string | yes | The function ID to trigger |
| input | object | — | Input parameters for the function |
No output schema declared.
No examples provided.
unmerge_contact_profiles ~100
Splits a merged Cognigy.AI contact profile back into separate profiles. Use when profiles were incorrectly merged. MUTATING: Set dryRun=false to unmerge.
| Name | Type | Req | Description |
|---|---|---|---|
| contactId | string | yes | The contact ID to extract into a separate profile |
| dryRun | boolean | — | If true (default), validates without unmerging. Set to false to actually unmerge. |
| profileId | string | yes | The merged profile ID to split |
No output schema declared.
No examples provided.
update_analytics_record ~103
Updates Cognigy.AI analytics records for a session. Use this to add custom tracking properties to conversation analytics. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| projectId | string | yes | The project ID |
| properties | object | yes | Custom analytics properties to set |
| sessionId | string | yes | The session ID to update analytics for |
No output schema declared.
No examples provided.
update_connection ~102
Updates an existing Cognigy.AI connection. Use this to change connection name or update credential values. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| connectionId | string | yes | The connection ID to update |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| fields | object | — | Connection field values to update as key-value pairs |
| name | string | — | New name for the connection |
No output schema declared.
No examples provided.
update_contact_profile ~106
Updates an existing Cognigy.AI contact profile. Use this to modify stored user data or GDPR consent. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| acceptedGDPR | boolean | — | Update GDPR consent status |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| profile | object | — | Profile data to update (merges with existing) |
| profileId | string | yes | The contact profile ID to update |
No output schema declared.
No examples provided.
update_extension ~97
Updates Cognigy.AI Extension settings like trusted code flag. Use this to enable/disable full Node.js API access. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| extensionId | string | yes | The extension ID to update |
| trustedCode | boolean | — | Enable trusted code execution (allows full Node.js API access) |
No output schema declared.
No examples provided.
update_extension_package ~98
Updates a Cognigy.AI Extension with a new package version from a URL. Use this to upgrade an extension to a new version. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| extensionId | string | yes | The extension ID to update |
| url | string | yes | URL to the new extension package (.tar.gz) |
No output schema declared.
No examples provided.
update_function ~115
Updates an existing Cognigy.AI Function. Use this to change code, name, or parameters. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | — | Updated function code |
| description | string | — | New description |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| functionId | string | yes | The function ID to update |
| name | string | — | New name for the function |
| parameters | object | — | Updated parameters schema |
No output schema declared.
No examples provided.
update_handover_provider ~116
Updates an existing Cognigy.AI handover provider. Use this to change settings or enable/disable the provider. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| enabled | boolean | — | Enable or disable the provider |
| name | string | — | New name for the provider |
| providerId | string | yes | The handover provider ID to update |
| settings | object | — | Updated provider settings |
No output schema declared.
No examples provided.
update_intent ~227
Updates an existing intent in a Cognigy.AI flow. MUTATING: This modifies the intent. Use dryRun=true (default) to validate first. After updating, call train_intents to retrain the NLU model.
| Name | Type | Req | Description |
|---|---|---|---|
| condition | string | — | New CognigyScript condition |
| confirmationSentences | array | — | New confirmation sentences (replaces existing) |
| description | string | — | New description |
| disambiguationSentence | string | — | Sentence shown when disambiguating between intents |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| flowId | string | yes | The flow ID containing the intent |
| intentId | string | yes | The ID of the intent to update |
| isDisabled | boolean | — | Whether the intent is disabled |
| localeId | string | — | Locale ID for locale-specific updates |
| name | string | — | New intent name |
| rules | array | — | New rule patterns (replaces existing) |
| tags | array | — | New tags array (replaces existing) |
No output schema declared.
No examples provided.
update_knowledge_chunk ~124
Updates an existing Cognigy.AI knowledge chunk. If text is changed, the chunk will be re-embedded. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| chunkId | string | yes | The knowledge chunk ID to update |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| knowledgeStoreId | string | yes | The knowledge store ID |
| sourceId | string | yes | The knowledge source ID containing the chunk |
| text | string | — | New text content (will be re-embedded) |
No output schema declared.
No examples provided.
update_knowledge_connector ~103
Updates an existing Cognigy.AI knowledge connector. Use this to change settings or name. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| connectorId | string | yes | The knowledge connector ID to update |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| knowledgeStoreId | string | yes | The knowledge store ID containing the connector |
| name | string | — | New name for the connector |
No output schema declared.
No examples provided.
update_knowledge_source ~112
Updates an existing Cognigy.AI knowledge source. Use this to change name or description. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | — | New description |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| knowledgeStoreId | string | yes | The knowledge store ID containing the source |
| name | string | — | New name for the source |
| sourceId | string | yes | The knowledge source ID to update |
No output schema declared.
No examples provided.
update_knowledge_store ~98
Updates an existing Cognigy.AI knowledge store. Use this to change name or description. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | — | New description |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| knowledgeStoreId | string | yes | The knowledge store ID to update |
| name | string | — | New name for the knowledge store |
No output schema declared.
No examples provided.
update_llm ~145
Updates an existing Cognigy.AI large language model configuration. Use this to change name, description, credentials, or provider settings. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| connectionId | string | — | New connection ID for credentials |
| description | string | — | New description |
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| isDefault | boolean | — | Set as the default LLM |
| largeLanguageModelId | string | yes | The LLM ID to update |
| name | string | — | New name for the LLM |
| providerConfig | object | — | Provider-specific configuration updates |
No output schema declared.
No examples provided.
update_nlu_connector ~108
Updates an existing Cognigy.AI NLU connector. Use this to change name or update type-specific settings. MUTATING: Set dryRun=false to update.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without updating. Set to false to actually update. |
| name | string | — | New name for the NLU connector |
| nluConnectorId | string | yes | The NLU connector ID to update |
| settings | object | — | Type-specific settings to update |
No output schema declared.
No examples provided.
update_node ~198
Updates an existing node in a Cognigy.AI flow. MUTATING: This modifies the node. Use dryRun=true (default) to validate first. Only provided fields are updated; others remain unchanged.
| Name | Type | Req | Description |
|---|---|---|---|
| analyticsLabel | string | — | Label used in analytics reporting |
| comment | string | — | New developer comment/note |
| config | object | — | Node-specific configuration to update. Structure depends on node type. Only provided fields are updated. |
| dryRun | boolean | — | If true (default), validates the operation without updating. Set to false to actually update. |
| flowId | string | yes | The flow ID containing the node |
| isDisabled | boolean | — | Whether the node is disabled (skipped during execution) |
| label | string | — | New display label for the node |
| localeId | string | — | Locale ID if updating locale-specific content |
| nodeId | string | yes | The ID of the node to update |
No output schema declared.
No examples provided.
upload_extension ~106
Uploads a new Cognigy.AI Extension from a URL. The extension package must be a .tar.gz file. This is an async operation that polls until complete. MUTATING: Set dryRun=false to upload.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates without uploading. Set to false to actually upload. |
| projectId | string | yes | The project ID to upload the extension to |
| url | string | yes | URL to the extension package (.tar.gz) |
No output schema declared.
No examples provided.
upload_package ~155
Uploads a package file to a Cognigy.AI project. Use this to import a previously downloaded package or transfer resources between environments. MUTATING: Set dryRun=false to upload. Async operation.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates the file exists without uploading. Set to false to actually upload. |
| filePath | string | yes | Local file path to the package file |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| projectId | string | yes | The target project ID to upload the package to |
| timeoutMs | integer | — | Maximum time to wait for upload and processing (5-600 seconds, default 180) |
No output schema declared.
No examples provided.
upload_snapshot_package ~179
Uploads a snapshot package file to a Cognigy.AI project. Use this to restore a previously downloaded snapshot or transfer a snapshot between environments. MUTATING: Set dryRun=false to upload. Async operation.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | — | If true (default), validates the file exists without uploading. Set to false to actually upload. |
| filePath | string | yes | Local file path to the snapshot package file (e.g., './snapshot.csnap' or 'C:/snapshots/backup.csnap') |
| pollIntervalMs | integer | — | How often to check task status (1-10 seconds, default 3) |
| projectId | string | yes | The target project ID to upload the snapshot package to |
| timeoutMs | integer | — | Maximum time to wait for upload and processing (5-600 seconds, default 180) |
No output schema declared.
No examples provided.