MCP tool reference · #132 of 563 by publishers
list_files
Exposed by 18 servers from 18 publishers, read from the live servers by the Serverdex check; most of them sit in Business & CRM; 33.3% of them take a limit parameter; the most-starred is Computer-Use Agents API (47 stars).
list_files(limit?: integer, …)Parameters
share = % of the 18 servers whose schema has it · required = % of those that mark it required| Parameter | Type | Share | Required | Usual description |
|---|---|---|---|---|
| limit | integer | 33.3% | 0% | Cap on returned files (1-500). Useful with sort_by for "5 largest files" or "10 most recent". Projects come at most 100 per page. |
| path | string | 16.7% | 0% | Directory prefix inside the package, e.g. /dist/. Defaults to /. |
| cursor | string | 11.1% | 0% | Pagination cursor |
| project_id | integer | 11.1% | 100% | Hosting project UUID from create_project or list_projects. |
| search | string | 11.1% | 0% | Filename substring search. Matches with or without extension — "Schleife oben 1_PLA_1h4m" and "Schleife oben 1_PLA_1h4m.3mf" both find the same file. |
| slug | string | 11.1% | 100% | The workspace slug. Accepts either the bare slug or the org-prefixed form ('my-org/my-workspace') as shown in the dashboard URL. |
| agent | string | 5.6% | 0% | Optional: only this agent. |
| api_key | string | 5.6% | 0% | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set head |
| compact | boolean | 5.6% | 0% | Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with li |
| exclude | array | 5.6% | 0% | Optional glob patterns (support **, *, ?). |
| f | integer | 5.6% | 0% | Folder id to list (0 or omitted = root) |
| feature | string | 5.6% | 0% | List this feature's copy of the data instead. |
Source: the input schema each server returns for list_files, aggregated over the 18 index-tier servers; type and description are the values most servers use. Rebuilt every 6 hours.
Servers with list_files
18 of 18 · 18 publishers · 18 answering live · most-starred first, 3 per publisher| # | Server | Publisher | Category | ★ | Live | How it describes list_files |
|---|---|---|---|---|---|---|
| 1 | Computer-Use Agents APIhcompai · AI & Agents | hcompai | AI & Agents | 47 | yes | List files on a session's machine, newest first; by default its environment's own, such as a browser's downloads. ``session_id`` is the id ``run_agent`` returns, or an env-manager session id. When a listing is truncated, page on the last entry's modified_at (ISO-8601) and name, passed as modified_before and name_after. Send both: modification times are not unique, and a timestamp alone skips the |
| 2 | Besidkabesidka · Communication | besidka | Communication | 28 | yes | List the files in your Besidka library, newest first, with your storage usage. Each file has an id, name, media type, size in bytes, source and expiry. Pass nextOffset back as offset to continue. Requires signing in (files:read). |
| 3 | GenHTTP Lambdamda2av · Cloud & DevOps | mda2av | Cloud & DevOps | 4 | yes | The lambda's data: whether its workspace is switched on, and every file in it with size and last write - the same whichever version is online. With feature, that feature's copy of it. The code and resources of a version are in read_lambda. |
| 4 | UNPKGunpkg · Security & Identity | unpkg | Security & Identity | 1 | yes | List the real files inside an exact or resolvable package version via UNPKG ?meta. Use this before choosing a file path; never guess paths. |
| 5 | FynePDFfynepdf · Documents & Knowledge | fynepdf | Documents & Knowledge | 1 | yes | Files on FynePDF from the last 24 hours, newest first: what the person dropped in the upload box, other uploads and imports, and results. Use it to find the file_id of a file the person says they uploaded, by its name. |
| 6 | Novencenovence-ai · Content & Publishing | novence-ai | Content & Publishing | 1 | yes | List staged site files for a project (paths, types, sizes). Use get_file for one path's metadata; use delete_file to remove a path. Read-only; does not deploy. |
| 7 | Ctxvanshulgoyal101 · Developer Tools | vanshulgoyal101 | Developer Tools | 1 | yes | List the text files ctx would include for a repository (after stripping binaries, lockfiles and build dirs), with their byte sizes. Cheap way for an agent to see the layout before packing. |
| 8 | SimplyPrint: 3D Print Farm Managementsimplyprint · Media & Creative | simplyprint | Media & Creative | 1 | yes | List files and folders in the user's SimplyPrint storage. With pid set, only returns files compatible with that printer (full compatibility check). With global_search=true (default), searches recursively across all folders. |
| 9 | Putput MCPputput-io · Files & Storage | putput-io | Files & Storage | 1 | yes | List uploaded files with optional filtering |
| 10 | Archive (Unofficial)pipeworx-io · APIs & Integrations | pipeworx-io | APIs & Integrations | — | yes | List the downloadable files for an archive.org item by identifier: name, format, size, and a constructed download_url. Use search / get_metadata first to find an identifier. (archive.org items, not Wayback snapshots.) Keyless. |
| 11 | workload.zerogetitdone-gmbh · Business & CRM | getitdone-gmbh | Business & CRM | — | yes | List files and folders in a space or in one folder of it (id | name | file/folder | size | updated). |
| 12 | Handoff: Send Files to Users & Agentsjueluddinsf · Files & Storage | jueluddinsf | Files & Storage | — | yes | List this account's files, newest first, up to 1000. Use this to find a file_id before sharing. Returns metadata only, never bytes or download URLs. Requires your API key. |
| 13 | BotSpot: AI Trading, Backtests and Botslumiwealth · Finance | lumiwealth | Finance | — | yes | Lists files in any saved strategy revision owned by the authenticated user. Folders are represented by slash-separated file paths. For the current attached/open strategy, omit strategyId and revisionId so the server uses the latest active revision from conversation state, falling back to the MCP token, instead of making you copy UUIDs. If the user explicitly asks for another owned strategy, resolv |
| 14 | Agent Commonssibi-narendran · Business & CRM | sibi-narendran | Business & CRM | — | yes | Public files uploaded by an agent (or the newest from everyone): id, name, type, size, sha256, url. |
| 15 | Chip MCPzapret-digital · Communication | zapret-digital | Communication | — | yes | Файлы базы знаний проекта: имя, размер, читаемость. Зови перед read_project_file, если точное имя неизвестно. |
| 16 | BorealHostalainsvrd · Cloud & DevOps | alainsvrd | Cloud & DevOps | — | yes | List files and directories in a site's container. Path scoping depends on the plan: - Shared plans: rooted at wp-content/ (WordPress content directory) - VPS/dedicated plans: full filesystem access Requires: API key with read scope. Args: slug: Site identifier path: Relative path to list (empty for root of accessible area) Returns: {"path": "/", "entries": [{"name": "index.php", "t |
| 17 | Roomcommkotinder · Search & Web | kotinder | Search & Web | — | yes | List the Markdown files shared into a room (verified keys only). Use when the user wants to see which documents were shared in a room. Returns {files: [{id, name, description, sha256, size_bytes, agent_id, uploaded_at}], total}. Each id identifies a file for fetch_file. |
| 18 | Docktry-dock-ai · Media & Creative | try-dock-ai | Media & Creative | — | yes | List the folder + file children of a Files surface (kind='files'). Folders sorted first by position then name; files sorted by name. Returns folders[], files[] with cuids agents can pass to `get_file` / `delete_file`. `parent_folder_id` defaults to null (= root of the surface); pass a folder id to descend into a sub-folder. |
Stars from GitHub as stored in the Serverdex index (re-read every 7 days per server); live = answered the last daily check of its hosted endpoint.