> Source: https://rikuy.si/docs/tools/ . Updated 2026-10-20. Rikuy, rikuy.si

/docs/tools.md

## Tools

Verb and object, in snake\_case. IDs carry a prefix (loc\_, cam\_, look\_, conn\_) and match the app. Every look tool is read only and requires purpose, which goes to the activity log.

| Group | Tool | Input | Returns |
| --- | --- | --- | --- |
| Sign-up | check\_cameras | brand, model | Whether the recorder is compatible and how Rikuy connects to it. No account needed. |
| Sign-up | start\_membership | business, locations, recorder | A pending approval: link, 8 character code, expires in 15 minutes. |
| Sign-up | get\_membership\_status | none | pending, active, past\_due or canceled. |
| Look | list\_cameras | none | Cameras with id, name, zone, what it sees, whether it can be seen now, days back, time zone, clock offset. |
| Look | get\_frame | camera\_id, at, purpose | One JPEG up to 1280 px, recorder time, corrected time, look\_id. at is "now" or a date and time. |
| Look | get\_frames | camera\_id, start, end, count, purpose | Up to 24 frames sampled across the range, with their times and a look\_id. |
| Look | get\_clip | camera\_id, start, end, purpose | Signed link to an MP4 without audio, up to 120 s, expires in 24 h, look\_id. |
| Activity | get\_activity\_log | since, until | The looks this agent made in that range. |
| Activity | record\_answer | look\_ids, summary, flagged | Confirmation. The conclusion is saved next to the look. Writes only to the log. |

### Sign-up, no account needed

```
{ "tool": "check_cameras", "arguments": { "brand": "Hikvision", "model": "DS-7608NI" } }
→ { "compatible": true, "method": "ISAPI + RTSP" }
```

### Look

```
{
  "tool": "get_frames",
  "arguments": {
    "camera_id": "cam_01",
    "start": "2026-10-18T22:00:00-04:00",
    "end": "2026-10-19T06:00:00-04:00",
    "count": 12,
    "purpose": "Compare scratch-offs handed out with the lottery terminal report"
  }
}
→ 12 images (JPEG, 1280 px), each with recorder time and corrected time
  "look_id": "look_8f2a", "note": "Review the clip before acting on it."
```

### Activity

```
{
  "tool": "record_answer",
  "arguments": {
    "look_ids": ["look_8f2a"],
    "summary": "14 tickets handed out after 2 AM with no matching sale.",
    "flagged": true
  }
}
→ { "ok": true }   // the owner gets "Your agent flagged a look"
```

### Limits

- get\_frames: up to 24 frames per look. Long ranges run as an MCP task.
- get\_clip: up to 120 seconds, MP4 without audio, signed link that expires in 24 hours.
- Each location has a fixed usage limit. Past it, tools answer RATE\_LIMITED.

## Stuck in setup? We do it with you.

During the private demo, every store gets a guided install on a video call, in English or Spanish.

[Start free](https://rikuy.si/start/)