---
title: "tool si.read.propensity"
description: "a lead, a move or a play, and which faces, actors or content or both (`PropensityInput`): every eligible actor and every fitting content with the chance, its interval, its basis and the policy's odds, and the one the policy would choose (`PropensityAnswer`)."
section: reference
address: /reference/tools/si-read-propensity
contract: 0476e35e6e275db5
---

# tool si.read.propensity

a lead, a move or a play, and which faces, actors or content or both (`PropensityInput`): every eligible actor and every fitting content with the chance, its interval, its basis and the policy's odds, and the one the policy would choose (`PropensityAnswer`).

[figure: Over MCP, si.read.propensity takes PropensityInput and returns a card whose body is PropensityAnswer.]

every eligible actor and every fitting content with the chance, its interval, its basis and the policy's odds, and the one the policy would choose (`PropensityAnswer`). The call needs the read grant at the strategy rung.



| | |
|---|---|
| input | [PropensityInput](/concepts/propensityinput) |
| result | a card whose body is [PropensityAnswer](/concepts/propensityanswer) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/PropensityAnswer` |
| HTTP route | [`/v1/read/propensity`](/reference/read/propensity) |





| field | type | required | note |
|---|---|---|---|
| `lead` | `id` | yes |  |
| `move` | `id` | no |  |
| `play` | `id` | no |  |
| `faces` | `[one of actor \| content]` | yes |  |