docs: synchronizing help from snyk/user-docs

Author: team-cli-bot

help/cli-commands/aibom.md

@@ -1,22 +1,43 @@
-# AIBOM
+# AI-BOM
 
-## Prerequisites
+**Note**: AI-BOM is an experimental feature and is subject to breaking changes without notice.
 
-**Feature availability:** This experimental feature is available to customers on request. If you want to use this feature, contact your Snyk representative to get access. Then download the CLI from the preview release channel.
+## Prerequisites
 
-The `snyk aibom` feature requires an internet connection.
+- The `snyk aibom` feature requires an internet connection. 
+- Install the Snyk CLI from the [preview release](../../../snyk-cli/releases-and-channels-for-the-snyk-cli.md#preview) channel.
+- Your Project must be Python and with a [package manager](../../../supported-languages-package-managers-and-frameworks/python/) supported by Snyk.
 
 ## Usage
 
 `$ snyk aibom --experimental [<OPTION>]`
 
 ## Description
 
-The `snyk aibom` command generates an AIBOM for a local software project that is written in Python.
+The `snyk aibom` command generates an AI-BOM for a local software project that is written in Python. You can use the `snyk aibom` command to identify AI models, datasets, and map the AI supply chain, including connections to external tools and services using the Model Context Protocol (MCP).
+
+The supported format is CycloneDX v1.6 (JSON).
+
+In the JSON file, you can see the following AI dependencies and components:
+
+- **Models:** You can see your usage of foundational models (such as GPT-4) and open source models (such as Llama-4). Where possible, the information surfaced also refers to model card, license, and other information.
+- **Agents:** Identified based on popular AI agent libraries.
+- **Tools:** Identified based on popular patterns of tool calling.
+- **MCPs:** Identified based on the official MCP SDK, in addition to other popular ways of building MCPs.
+
+## MCP and your AI-BOM
+
+A key feature of the `snyk aibom` command is its ability to detect and map dependencies established using the MCP.
+
+MCP is an open standard that applications use to connect LLMs with external tools, data sources, and services. These connections create a new layer in your AI supply chain that needs to be monitored for security and compliance.
+
+`snyk aibom` analyzes your source code to identify and categorize MCP components into a clear dependency graph:
 
-Use the `snyk aibom` command to understand what AI models, datasets, tools, and so on are used in that project.
+- **MCP client**: The component in your code that initiates a connection to a server.
+- **MCP server**: The component providing tools or resources. This can be a local script or a remote network service.
+- **Tools and resources**: The specific functions (tool) or data (resource) made available by an MCP server.
 
-The current supported format is CycloneDX v1.6 (JSON).
+When you run `snyk aibom`, the output shows these dependencies clearly. For example, you can see a chain showing that your root application depends on an mcp-client, which depends on an mcp-server, which in turn provides a specific tool. This gives you full visibility into the services your AI application relies on.
 
 ## Options
 
@@ -32,14 +53,14 @@ If you have multiple Organizations, you can set a default from the CLI using:
 
 `$ snyk config set org=<ORG_ID>`
 
-Set a default to ensure all newly tested projects are tested under your default Organization. If you need to override the default, use the `--org=<ORG_ID>` option.
+Set a default to ensure all newly tested Projects are tested under your default Organization. If you need to override the default, use the `--org=<ORG_ID>` option.
 
 Default: `<ORG_ID>` that is the current preferred Organization in your [Account settings](https://app.snyk.io/account)
 
 ### `--html`
 
-Optional. Embed the AIBOM into an HTML visualization of the AIBOM components and their relationships.
+Optional. Embed the AI-BOM into an HTML visualization of the AI-BOM components and their relationships.
 
 ### `[--json-file-output]`
 
-Optional. Save the AIBOM output as a JSON data structure directly to the specified file.
+Optional. Save the AI-BOM output as a JSON data structure directly to the specified file.