---
title: "tool si.read.value_chain"
description: "Reads the value chain of one vertical, with the brand whose participants are placed on it: The answer gives the chain's stocks and handovers with their counts, the participants on each stock, and the loops the templates name over it."
section: reference
address: /reference/tools/si-read-value_chain
contract: 0476e35e6e275db5
---

# tool si.read.value_chain

Reads the value chain of one vertical, with the brand whose participants are placed on it: The answer gives the chain's stocks and handovers with their counts, the participants on each stock, and the loops the templates name over it.

[figure: Over MCP, si.read.value_chain takes ValueChainInput and returns a card whose body is ValueChain.]

The answer gives the chain's stocks and handovers with their counts, the participants on each stock, and the loops the templates name over it. The call needs the read grant at the brand rung.



| | |
|---|---|
| input | [ValueChainInput](/concepts/valuechaininput) |
| result | a card whose body is [ValueChain](/concepts/valuechain) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/ValueChain` |
| HTTP route | [`/v1/read/value_chain`](/reference/read/value_chain) |





| field | type | required | note |
|---|---|---|---|
| `vertical` | `id` | yes |  |
| `brand` | `id` | no |  |
| `segment` | `id` | no |  |