List Hugging Face files
hugging_face_repos_files_listList files and folders in any Hugging Face model, dataset, or space repository to inspect structure, paginate results, and optionally include last commit info.
Instructions
List the files and folders of a Hugging Face repository. Requires repoType, owner and name. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"repoType": "<repoType>",
"owner": "<owner>",
"name": "<name>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "hugging_face_repos_files_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Required. Repository name, without the owner. | |
| path | No | Folder to list. Default: the repository root. | |
| limit | No | Items per page, 1-1000. A page can hold fewer. Default: 100. | |
| owner | Yes | Required. Owner of the repository: a user or organization name. | |
| cursor | No | Pass `page.nextCursor` from the previous response to get the next page. Keep every other parameter the same. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| repoType | Yes | Required. Repository type: `models`, `datasets` or `spaces`. | |
| revision | No | Branch, tag or commit. Default: the default branch (`main`). | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| recursive | No | `true` to list every file below the folder. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. | |
| includeLastCommit | No | `true` to add the last commit that touched each file. Pages are then at most 100 entries. |