com.files/python-mcp
PYPI · FILES-COM-MCP
Local-only Python MCP server for the Files.com API.
Available components
−15 this week
64 64 Trust /100
Last scanned (2 hours ago)
Scores higher than 60% of PyPI servers
Category Documents and Files
Trust breakdown (7 categories)
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security40
- Malware scan not yet available for this package.Unverified
- CVE check failed: a known medium-severity CVE affects fastmcp-slim 3.4.7, a direct dependency. A fixed version is available. View diagnostics → Fail
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 4 of 61 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 0 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability61
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 11252 tokens (~167/item across 67 items; 67 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage94
- 90% of tools have a non-trivial description (not blank, and not just the tool's name).Partial
- 99% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 67 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Changelog
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 5 Nov 26 0
- Package version: 2.0.0 → 2.0.2 functional
- Package version: 2.0.0 → 2.0.1 functional
- 4 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- Schema quality: 149 → 167 ▼ functional
- Package version: 1.0.107 → 2.0.0 functional
- 3 Nov 26 0
- Package version: 1.0.106 → 1.0.107 functional
- 2 Nov 26 0
- Package version: 1.0.101 → 1.0.106 functional
- 1 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 31 Oct 26 −15
- Malware scan: pass → unverified ▼ security
- Package version: 1.0.101 → 1.0.105 functional
- 30 Oct 26 0
- Stability: 0.97 → pass security
- 29 Oct 26 +15
- Malware scan: unverified → pass ▲ security
- Stability: pass → 0.97 functional
Diagnostics
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed pypi/files-com-mcp@2.0.2
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
| Reason | No attestation published |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-7xgj-8392-5q4r | medium | CVSS:3.1/AV:N/AC:H/PR:L/UI:N/S:U/C:H/I:H/A:N | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 61 packages
| Packages resolved | 61 |
|---|---|
| Stale | 3 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
MCP tools
· 67 exposed
· ~11,252 tokens
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
Tool
Tokens
Begin_Delete_File Begin Delete File ~61
Delete File/Folder and return its File Action. A pending or processing deletion continues in the background after this returns; check its File Migration for completion. Waiting for the File Migration does not cancel the deletion.
| Name | Type | Req | Description |
|---|---|---|---|
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Copy_File Copy File ~30
Copy File/Folder
| Name | Type | Req | Description |
|---|---|---|---|
| destination | – | – | Copy destination path. |
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_Bundle Create Bundle ~123
Create Share Link
| Name | Type | Req | Description |
|---|---|---|---|
| description | – | – | Public description |
| expires_at | – | – | Explicit Bundle expiration date/time. If not set, the site-wide expiration setting may apply. |
| max_uses | – | – | Maximum number of times bundle can be accessed |
| note | – | – | Bundle internal note |
| password | – | – | Password for this bundle. |
| paths | – | – | A list of paths to include in this bundle. |
| permissions | – | – | Permissions that apply to Folders in this Share Link. |
| require_registration | – | – | Show a registration page that captures the downloader's name and email address? |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_Bundle_Notification Create Bundle Notification ~77
Create Share Link Notification
| Name | Type | Req | Description |
|---|---|---|---|
| bundle_id | – | – | Bundle ID to notify on |
| notify_on_registration | – | – | Triggers bundle notification when a registration action occurs for it. |
| notify_on_upload | – | – | Triggers bundle notification when a upload action occurs for it. |
| notify_user_id | – | – | The id of the user to notify. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_Bundle_Recipient Create Bundle Recipient ~82
Create Share Link Recipient
| Name | Type | Req | Description |
|---|---|---|---|
| bundle_id | – | – | Bundle to share. |
| company | – | – | Company of recipient. |
| name | – | – | Name of recipient. |
| note | – | – | Note to include in email. |
| recipient | – | – | Email addresses to share this bundle with. |
| share_after_create | – | – | Set to true to share the link with the recipient upon creation. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_Folder Create Folder ~21
Create Folder
| Name | Type | Req | Description |
|---|---|---|---|
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_Group Create Group ~73
Create Group
| Name | Type | Req | Description |
|---|---|---|---|
| admin_ids | – | – | A list of group admin user ids. If sent as a string, should be comma-delimited. |
| name | – | – | Group name. |
| notes | – | – | Group notes. |
| user_ids | – | – | A list of user ids. If sent as a string, should be comma-delimited. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_Permission Create Permission ~85
Create Permission
| Name | Type | Req | Description |
|---|---|---|---|
| group_id | – | – | Group ID. Provide `group_name` or `group_id` |
| path | – | – | Folder path |
| permission | – | – | Permission type. Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history` |
| user_id | – | – | User ID. Provide `username` or `user_id` |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Create_User Create User ~385
Create User
| Name | Type | Req | Description |
|---|---|---|---|
| authentication_method | – | – | How is this user authenticated? |
| company | – | – | User's company |
| dav_permission | – | – | Can the user connect with WebDAV? |
| – | – | User's email. | |
| ftp_permission | – | – | Can the user access with FTP/FTPS? |
| group_ids | – | – | A list of group ids to associate this user with. Comma delimited. |
| name | – | – | User's full name |
| notes | – | – | Any internal notes on the user |
| password | – | – | User password. |
| require_password_change | – | – | Is a password change required upon next user login? |
| restapi_permission | – | – | Can this user access the Web app, Desktop app, SDKs, or REST API? (All of these tools use the API internally, so this is one unified permission set.) |
| s3_compatible_endpoint_permission | – | – | Can the user access the S3-compatible endpoint? Defaults to true. |
| sftp_permission | – | – | Can the user access with SFTP? |
| user_home | – | – | Home folder for FTP/SFTP. For users with the partner_root filesystem layout, this path is relative to the Partner root folder. In all other cases, it is an absolute path. Only applies to FTP and SFTP… |
| user_root | – | – | If filesystem layout is user_root, this path is the root path the user is fixed to for all interfaces. If the filesystem layout is site_root or partner_root, this acts as a root folder only for FTP a… |
| username | – | – | User's username |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Delete_Bundle Delete Bundle ~20
Delete Share Link
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Bundle ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Delete_Bundle_Notification Delete Bundle Notification ~24
Delete Share Link Notification
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Bundle Notification ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Delete_File Delete File ~22
Delete File/Folder
| Name | Type | Req | Description |
|---|---|---|---|
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Delete_Group Delete Group ~18
Delete Group
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Group ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Delete_Permission Delete Permission ~19
Delete Permission
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Permission ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Delete_User Delete User ~18
Delete User
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | User ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Download_File_to_Local Download File to Local ~101
Download a file from my Files.com site.
| Name | Type | Req | Description |
|---|---|---|---|
| local_path | string | yes | The full path on my local system to save the downloaded file to. Must be a path that can be written to. When in doubt, use the `$HOME/Downloads` folder, or the `/tmp/` folder, as the destination for… |
| remote_path | string | yes | The full path on my Files.com site of the file to be downloaded. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_Automation Find Automation ~20
Show Automation
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Automation ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_Bundle Find Bundle ~20
Show Share Link
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Bundle ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_Bundle_Notification Find Bundle Notification ~24
Show Share Link Notification
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Bundle Notification ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_File Find File ~24
Find File/Folder by Path
| Name | Type | Req | Description |
|---|---|---|---|
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_Group Find Group ~18
Show Group
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Group ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_Remote_Server Find Remote Server ~22
Show Remote Server
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | Remote Server ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Find_User Find User ~18
Show User
| Name | Type | Req | Description |
|---|---|---|---|
| id | – | – | User ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Gpg_Decrypt_File Gpg Decrypt File ~48
Decrypt a GPG-encrypted file and save it to a destination path.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | – | – | Destination file path for the decrypted file. |
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Gpg_Encrypt_File Gpg Encrypt File ~46
Encrypt a file with GPG and save it to a destination path.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | – | – | Destination file path for the encrypted file. |
| path | – | – | Path to operate on. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Action_Log List Action Log ~376
List Action Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `folder`, `path`, `src`, `destination`, `created_at`, `user_id` or `username`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `folder`, `path`, `src`, `destination` or `username`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Api_Request_Log List Api Request Log ~387
List API Request Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `api_key_id`, `interface`, `request_id`, `request_ip`, `request_method`, `success`, `user_id` or `cre… |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `interface`, `request_id`, `request_ip` or `request_method`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Automation List Automation ~169
List Automations
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Automation_Log List Automation Log ~445
List Automation Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `automation_id`, `automation_run_id`, `correlation_id`, `error_type`, `node_id`, `node_type`, `operat… |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `source_automation_version` and `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `source_automation_version` and `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `source_automation_version` and `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `source_automation_version` and `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `correlation_id`, `error_type`, `node_id`, `node_type`, `output` or `path`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Bundle List Bundle ~168
List Share Links
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Bundle_Download List Bundle Download ~179
List Share Link Downloads
| Name | Type | Req | Description |
|---|---|---|---|
| bundle_id | – | – | Bundle ID |
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Bundle_Notification List Bundle Notification ~171
List Share Link Notifications
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Bundle_Recipient List Bundle Recipient ~186
List Share Link Recipients
| Name | Type | Req | Description |
|---|---|---|---|
| bundle_id | – | – | List recipients for the bundle with this ID. |
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Bundle_Registration List Bundle Registration ~183
List Share Link Registrations
| Name | Type | Req | Description |
|---|---|---|---|
| bundle_id | – | – | ID of the associated Bundle |
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Email_Log List Email Log ~319
List Email Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `status` and `created_at`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Exavault_Api_Request_Log List Exavault Api Request Log ~371
List Exavault API Request Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `request_ip`, `request_method`, `success` or `created_at`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `request_ip` and `request_method`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_External_Event List External Event ~368
List External Events
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `status` or `workspace_id`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| sort_by | – | – | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`, `status`, `event_type` or `workspace_id`. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_File_Migration_Log List File Migration Log ~334
List File Migration Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `file_migration_id`, `operation`, `status`, `type` or `created_at`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_For_File_History List For File History ~268
List history for specific file.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| display | – | – | Display format. Leave blank or set to `full` or `parent`. |
| end_at | – | – | Leave blank or set to a date/time to filter later entries. |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| path | – | – | Path to operate on. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| sort_by | – | – | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`. |
| start_at | – | – | Leave blank or set to a date/time to filter earlier entries. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_For_Folder List For Folder ~146
List Folders by Path
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Send cursor to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header or the X-Files-Cursor-Prev header. |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| path | – | – | Path to operate on. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_For_Folder_History List For Folder History ~269
List history for specific folder.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| display | – | – | Display format. Leave blank or set to `full` or `parent`. |
| end_at | – | – | Leave blank or set to a date/time to filter later entries. |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| path | – | – | Path to operate on. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| sort_by | – | – | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`. |
| start_at | – | – | Leave blank or set to a date/time to filter earlier entries. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_For_User_History List For User History ~267
List history for specific user.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| display | – | – | Display format. Leave blank or set to `full` or `parent`. |
| end_at | – | – | Leave blank or set to a date/time to filter later entries. |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| sort_by | – | – | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`. |
| start_at | – | – | Leave blank or set to a date/time to filter earlier entries. |
| user_id | – | – | User ID. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Ftp_Action_Log List Ftp Action Log ~387
List FTP Action Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `path`, `true_path`, `remote_ip`, `session_uuid`, `success`, `status`, `action_type`, `username` or `… |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`, `true_path`, `action_type` or `username`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Group List Group ~166
List Groups
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_History List History ~319
List site full action history.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| display | – | – | Display format. Leave blank or set to `full` or `parent`. |
| end_at | – | – | Leave blank or set to a date/time to filter later entries. |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `user_id`, `folder` or `path`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| sort_by | – | – | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`. |
| start_at | – | – | Leave blank or set to a date/time to filter earlier entries. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Inbound_S3_Log List Inbound S3 Log ~374
List Inbound S3 Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `operation`, `status`, `path`, `client_ip` or `created_at`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `operation`, `status`, `path` or `client_ip`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Logins_History List Logins History ~258
List site login history.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| display | – | – | Display format. Leave blank or set to `full` or `parent`. |
| end_at | – | – | Leave blank or set to a date/time to filter later entries. |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| sort_by | – | – | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`. |
| start_at | – | – | Leave blank or set to a date/time to filter earlier entries. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Outbound_Connection_Log List Outbound Connection Log ~374
List Outbound Connection Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `operation`, `status`, `src_remote_server_id`, `dest_remote_server_id`, `path`, `client_ip` or `creat… |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Permission List Permission ~202
List Permissions
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| group_id | – | – | – |
| path | – | – | Permission path. If provided, will scope all permissions(including upward) to this path. |
| per_page | – | – | Number of records to show per page. (Max: 10000, 1,000 or less is recommended). |
| user_id | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
List_Public_Hosting_Request_Log List Public Hosting Request Log ~360
List Public Hosting Request Logs
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value her… |
| fields | – | – | Optional list of attribute names to include as columns in the response table. When omitted, a sensible default set is used. Useful for narrowing wide entities or surfacing fields not in the default. |
| filter | – | – | If set, return records where the specified field is equal to the supplied value. Valid fields are `path`, `remote_ip`, `success` or `created_at`. |
| filter_gt | – | – | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| filter_gteq | – | – | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| filter_lt | – | – | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| filter_lteq | – | – | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
| filter_prefix | – | – | If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`. |
| per_page | – | – | Number of records to show per page. (Max: 1000, 1,000 or less is recommended). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
Install
How do I install the com.files/python-mcp server?
com.files/python-mcp runs locally as a PyPI package, launched with uvx files-com-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · files-com-mcp
# add to Claude Code
claude mcp add com-files-python-mcp -- uvx files-com-mcp
Common questions
What is the com.files/python-mcp server?
com.files/python-mcp is listed in the public MCP registry as com.files/python-mcp. Local-only Python MCP server for the Files.com API. This page covers its PyPI package (files-com-mcp).
Is the com.files/python-mcp server safe to use?
com.files/python-mcp scores 64 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 5 November 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the com.files/python-mcp server expose?
com.files/python-mcp exposes 67 tools: Download_File_to_Local, Upload_File_from_Local, List_Bundle, Find_Bundle, Create_Bundle, and 62 more. Their descriptions and schemas cost roughly 11,252 tokens of context every time the server is loaded.
Is the com.files/python-mcp server still maintained?
com.files/python-mcp is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the com.files/python-mcp server under?
com.files/python-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.