---
title: "tool si.ask.neighbours"
description: "an entity, one kind of connection, and the two dates: the members, one hop away, and whether the cap was reached."
section: reference
address: /reference/tools/si-ask-neighbours
contract: 0476e35e6e275db5
---

# tool si.ask.neighbours

an entity, one kind of connection, and the two dates: the members, one hop away, and whether the cap was reached.

[figure: Over MCP, si.ask.neighbours takes NeighboursInput and returns a card whose body is NeighboursAnswer.]

the members, one hop away, and whether the cap was reached. The call needs the ask grant at the strategy rung.



| | |
|---|---|
| input | [NeighboursInput](/concepts/neighboursinput) |
| result | a card whose body is [NeighboursAnswer](/concepts/neighboursanswer) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/NeighboursAnswer` |
| HTTP route | [`/v1/ask/neighbours`](/reference/ask/neighbours) |





| field | type | required | note |
|---|---|---|---|
| `entity` | `id` | yes |  |
| `kind` | [KindOfConnection](/concepts/kindofconnection) | yes |  |
| `role` | `text` | no |  |