bundles
title: Bundles sidebar_label: Bundles (4) sidebar_position: 11 doc_type: reference
Bundles
Overview
Browse and import pre-built configuration packs.
Prerequisites
- API key with the MCP preset and required scopes
- Configured MCP client (see Configuration)
Quick start examples
Browse and import a bundle
- Browse available bundles :
{
"name": "bundle_list",
"arguments": {}
}
- Preview the import :
{
"name": "bundle_preview",
"arguments": {
"bundleId": "uuid-du-bundle"
}
}
- Import the bundle :
{
"name": "bundle_import",
"arguments": {
"bundleId": "uuid-du-bundle"
}
}
bundle_get
Get detailed information about a specific bundle including all modules.
USE WHEN:
- Need to inspect a bundle\
| Scope | mcp.read |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bundleId | string | Yes | Bundle identifier (slug from catalog) |
Related tools :
bundle_list,bundle_preview
bundle_import
Import a use-case bundle into the current workspace.
USE WHEN:
- Want to set up a complete use-case (ontology + workflows + agents)
- Need to bootstrap a workspace with pre-built templates RETURNS: import ID, status, created resources, and any errors. NOTE: Use bundle_preview first to check for conflicts.
| Scope | mcp.write |
| Read-only | No |
| Destructive | No |
| Idempotent | No |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bundleId | string | Yes | Bundle identifier (slug from catalog) |
conflictResolution | choice (skip, update, fail) | No | How to handle conflicts (default: update) |
dryRun | boolean | No | If true, validate without actually importing (default: false) |
espaceId | string (uuid) | No | Target espace (canvas) ID. Uses default espace if not provided |
Response
| Field | Type | Description |
|---|---|---|
importId | string | |
status | string | |
resources | array | |
errors | array |
Related tools :
bundle_preview,bundle_list
bundle_list
[DISCOVERY] List available use-case bundles from the catalog.
USE WHEN:
- Need to see what pre-built bundles are available
- Searching for a bundle by industry or complexity RETURNS: list of bundles with metadata (name, industry, complexity, resource counts).
| Scope | mcp.read |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
complexity | choice (starter, standard, enterprise) | No | Filter by complexity level |
industry | string | No | Filter by industry (e.g., saas, ecommerce, healthcare) |
limit | number | No | Max results to return (default: 50) |
offset | number | No | Offset for pagination (default: 0) |
search | string | No | Search term to filter bundles by name or description |
Response
| Field | Type | Description |
|---|---|---|
bundles | array | |
total | number |
Example
{
"name": "bundle_list",
"arguments": {}
}
bundle_preview
Preview what importing a bundle would create, update, or conflict with.
USE WHEN:
- Need to check for conflicts before importing
- Want to see what resources will be created RETURNS: resources to create, conflicts with existing data, required connections.
| Scope | mcp.read |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bundleId | string | Yes | Bundle identifier (slug from catalog) |
conflictResolution | choice (skip, update, fail) | No | How to handle conflicts with existing resources (default: update) |
Related tools :
bundle_get,bundle_import
Need help?
Contact us: Support and contact.