# retrieval

> Retrieval as a measured outcome (contract 1.7):

Retrieval as a measured outcome (contract 1.7): searches, passages, tokens sent and held back, zero-result rate, latency, by agent, pack, index, mode or day; grounding beside it; retrieval evals; tokens saved priced at the price card.

**Role:** viewer and above (any person, AAL staff, machine key).

**Acts:** no. It only reads; nothing an AI agent calls through MCP approves, pays, or changes a limit.

## Inputs

| Input      | Type           | Default   |
| ---------- | -------------- | --------- |
| `since`    | string or null | `null`    |
| `until`    | string or null | `null`    |
| `group_by` | string         | `"agent"` |

## Call

The arguments of a `tools/call` request:

```json
{
  "name": "retrieval",
  "arguments": {}
}
```

Source: https://docs.atlanticagenticlabs.com/mcp/tools/retrieval/