---
title: "tool si.read.coverage"
description: "a cell, or a scope of entities with a window: what has been read, when and how deep, in the three positions."
section: reference
address: /reference/tools/si-read-coverage
contract: 0476e35e6e275db5
---

# tool si.read.coverage

a cell, or a scope of entities with a window: what has been read, when and how deep, in the three positions.

[figure: Over MCP, si.read.coverage takes CoverageInput and returns a card whose body is Coverage.]

what has been read, when and how deep, in the three positions. The call needs the read grant at the brand rung.



| | |
|---|---|
| input | [CoverageInput](/concepts/coverageinput) |
| result | a card whose body is [Coverage](/concepts/coverage) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/Coverage` |
| HTTP route | [`/v1/read/coverage`](/reference/read/coverage) |





| field | type | required | note |
|---|---|---|---|
| `cell` | `id` | no |  |
| `scope` | [Predicate](/concepts/predicate) | no |  |
| `window` | [Window](/concepts/window) | no |  |