# Files.com MCP > Files.com MCP gives your AI client complete control over secure enterprise file storage. Use it to coordinate complex folder structures, manage user permissions, and monitor detailed audit logs across your company's most sensitive data. It lets you move beyond clicking through web interfaces by enabling conversational commands for everything from creating new directories to checking who has access to a specific document. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** file-transfer, secure-storage, audit-logs, cloud-sync, file-metadata, collaboration ## Description Managing files in a large organization isn't just about storing them; it's about knowing exactly who can touch what, and when they touched it. This MCP lets you connect your AI agent directly to your Files.com secure storage account. You can talk to your client and perform complex file operations—like listing entire folder hierarchies or retrieving specific metadata for a document—all through natural conversation. Imagine needing to check the full activity history across multiple projects, or ensuring that only members of one group can delete certain asset types. Instead of opening three different dashboards, you ask your agent. It handles the complexity, giving you immediate answers on things like user access controls or where a file was last downloaded. By connecting this MCP via Vinkius, you give any compatible AI client the power to manage your entire digital ecosystem. You keep your data secure and audit-ready without ever needing to remember an API key or navigate complicated web forms. ## Tools ### create_folder Creates a new folder inside your Files.com storage account. ### delete_file Removes an outdated file or entire directory from the system. ### get_file_details Retrieves all specific metadata for a given file path, including download links. ### list_folders Lists the contents and directories at any specified location in Files.com. ### list_user_groups Displays all organizational groups defined within your company's account. ### list_activity_history Retrieves a chronological list of every file action, like downloads or deletions. ### list_permissions Shows detailed access rights for users and groups on specific files or folders. ### list_users Outputs a list of all current user accounts in your Files.com organization. ## Prompt Examples **Prompt:** ``` List all files in the '/Client-Projects' folder. ``` **Response:** ``` I've retrieved the folder contents. Inside '/Client-Projects' you have: 'Contract_v1.pdf', 'Design_Mockup.png', and 'Project_Brief.docx'. Which one would you like more details on? ``` **Prompt:** ``` Show me the activity history for the last 24 hours. ``` **Response:** ``` Fetching audit logs... In the last 24 hours, there were 15 activities: 10 uploads, 3 downloads by Mike Ross, and 2 folder deletions. Would you like a detailed report on the deletions? ``` **Prompt:** ``` Create a new folder called '/Archive-2023'. ``` **Response:** ``` Success! The folder '/Archive-2023' has been created in your Files.com account. You can now start moving your legacy assets into this directory. ``` ## Capabilities ### Map folder structures List all folders and files within a specific path in your cloud storage. ### Get file details Retrieve comprehensive metadata, including download links, for any individual file you point to. ### Audit access controls List users, groups, and specific permissions to verify who can do what in the system. ### Track activity changes Query real-time or historical logs to see every upload, download, or deletion that happened. ### Manage directories and assets Create new folders or delete outdated files programmatically using simple commands. ## Use Cases ### Checking for compliance violations A Compliance Officer needs to know if any employee downloaded a sensitive contract file last month. They ask their agent to check the `list_activity_history` tool, and the AI immediately pulls a filtered log showing every user who interacted with that specific document. ### Reorganizing an old department's data An Operations Manager needs to consolidate all assets from a dissolved team. They ask their agent to run `list_folders` to map the entire directory structure, then use `create_folder` to build the new archive and move everything safely. ### Onboarding a new team member The IT Administrator needs to grant access rights. They ask the agent to run `list_users` to confirm the account exists, then use `list_permissions` to assign group-level read/write access directly, bypassing manual GUI clicks. ### Recovering deleted files An employee realizes they accidentally removed a critical folder. They instruct their agent to check the full file activity history using `list_activity_history` and get details on the deletion event, speeding up recovery efforts. ## Benefits - Gain full visibility into your data by listing folders across the entire structure. Instead of navigating click-by-click to find a department's directory, you simply ask your agent to run `list_folders` and see the whole map instantly. - Never lose track of critical assets again. Use `get_file_details` to pull complete file metadata for any document, giving you direct download links and version information in one go. - Prove who accessed what, when they accessed it, and if it was allowed. By querying the `list_activity_history`, you get a reliable audit trail that tracks uploads, downloads, and deletions instantly. - Keep your data secure by verifying access rights easily. You can run `list_permissions` to check specific user roles against folder rules without opening complex security dashboards. - Maintain clean governance using simple commands. Need a new archive? Use `create_folder`. Found junk assets? Run `delete_file` and keep the system tidy. ## How It Works The bottom line is that you treat your entire corporate file system like a single conversation with your agent. 1. Subscribe to this MCP on Vinkius. 2. Enter your Files.com API Key and Subdomain (like yourcompany.files.com) into the connection settings. 3. Start giving commands in any compatible AI client, and it performs file operations directly against your secure storage. ## Frequently Asked Questions **How does Files.com MCP help with compliance auditing?** It provides immediate access to historical records using `list_activity_history`. You can query specific timeframes or actions (like deletions) to generate an instant, auditable report without manual searching. **What if I need to rename a folder?** This MCP focuses on creation and deletion. While you can use `list_folders` to see the names, renaming usually requires a different tool, but you can programmatically clean up by running `delete_file` and then creating a new one. **Can I check permissions for multiple folders at once using Files.com MCP?** Yes, you can provide the agent with a list of paths, and it runs `list_permissions` against all specified locations, giving you an aggregated view of access rights. **What information do I get from using list_users?** Running this tool lists every user account in your organization. This helps administrators verify which people need to be added or removed from specific project groups before setting up new permissions.