---
title: "tool si.act.ground"
description: "exactly one of a capture, an entity, a text or an address, and a breadth (`GroundInput`): the grounding with its hypotheses (`GroundingAnswer`), the channels that ran and the ones not ready with their reason."
section: reference
address: /reference/tools/si-act-ground
contract: 0476e35e6e275db5
---

# tool si.act.ground

exactly one of a capture, an entity, a text or an address, and a breadth (`GroundInput`): the grounding with its hypotheses (`GroundingAnswer`), the channels that ran and the ones not ready with their reason.

[figure: Over MCP, si.act.ground takes GroundInput and returns a card whose body is GroundingAnswer.]

the grounding with its hypotheses (`GroundingAnswer`), the channels that ran and the ones not ready with their reason. The call needs the act grant at the user rung.



| | |
|---|---|
| input | [GroundInput](/concepts/groundinput) |
| result | a card whose body is [GroundingAnswer](/concepts/groundinganswer) |
| read-only | no |
| destructive | yes |
| card address | `ui://scale-intelligence/cards/GroundingAnswer` |
| HTTP route | [`/v1/act/ground`](/reference/act/ground) |





| field | type | required | note |
|---|---|---|---|
| `capture` | `hash` | no | the artefact's hash |
| `entity` | `id` | no | an entity of the record |
| `text` | `text` | no | a text a person or the agent pasted, cut to 4,000 characters |
| `address` | `text` | no | an address of a page the record may hold as a capture |
| `breadth` | `one of exact \| similar \| related \| broad` | no | the person's default when absent |