---
title: "tool si.read.lookup"
description: "a key: a namespace with a value, or a name with a place, and with a name a breadth."
section: reference
address: /reference/tools/si-read-lookup
contract: 0476e35e6e275db5
---

# tool si.read.lookup

a key: a namespace with a value, or a name with a place, and with a name a breadth.

[figure: Over MCP, si.read.lookup takes LookupInput and returns a card whose body is LookupAnswer.]

the entity, or the possible matches, or nothing; with a breadth, the record's candidates by the one candidate search. The call needs the read grant at the strategy rung.



| | |
|---|---|
| input | [LookupInput](/concepts/lookupinput) |
| result | a card whose body is [LookupAnswer](/concepts/lookupanswer) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/LookupAnswer` |
| HTTP route | [`/v1/read/lookup`](/reference/read/lookup) |





| field | type | required | note |
|---|---|---|---|
| `namespace` | `text` | no |  |
| `value` | `text` | no |  |
| `name` | `text` | no |  |
| `place` | `text` | no |  |
| `kind` | [KindOfEntity](/concepts/kindofentity) | no |  |
| `breadth` | `one of exact \| similar \| related \| broad` | no | with a name: the one candidate search of the record at that breadth, by exact keys, names and meaning, in place of the substring match |