---
title: "tool si.files.list"
description: "a path inside the workspace, or nothing: the files with their sizes, kinds and when they were written."
section: reference
address: /reference/tools/si-files-list
contract: 0476e35e6e275db5
---

# tool si.files.list

a path inside the workspace, or nothing: the files with their sizes, kinds and when they were written.

[figure: Over MCP, si.files.list takes Nothing and returns a card whose body is FileList.]

the files with their sizes, kinds and when they were written. The call needs the files grant at the user rung.



| | |
|---|---|
| input | [Nothing](/concepts/nothing) |
| result | a card whose body is [FileList](/concepts/filelist) |
| read-only | no |
| destructive | no |
| card address | `ui://scale-intelligence/cards/FileList` |
| HTTP route | [`/v1/files/list`](/reference/files/list) |