# Filemail MCP MCP > Filemail MCP handles secure, large-scale file transfers up to terabytes. You initialize deliveries, manage contacts, and track download status—all through natural conversation. It gives your AI client full control over sensitive asset sharing, eliminating manual follow-up emails. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** large-file-transfer, secure-sharing, download-tracking, password-protection, branded-transfers, file-delivery ## Description Managing big files used to mean a lot of clicks in an admin dashboard or worse, chasing down confirmation emails. This MCP lets you handle secure transfers like they're just another chat command. You can programmatically set up massive file drops, track exactly when recipients download what, and even manage who you send things to using your address book. If you need a reliable way to coordinate high-stakes asset delivery—think video proofs or quarterly financials—this is it. Instead of struggling with fragmented emails, your AI client acts as the dedicated logistics coordinator for all your transfers. Connecting Filemail via Vinkius gives your agent immediate access to this powerful workflow management toolset. ## Tools ### complete_transfer Finalizes a file transfer when all steps are done. ### delete_transfer Removes an existing transfer from your account. ### get_configuration Retrieves details about the overall account settings and status. ### get_transfer_details Pulls specific information, like download links or file counts, for one transfer. ### get_user Retrieves your own user profile details. ### initialize_transfer Starts the process of a new file transfer, generating necessary URLs and metadata. ### list_contacts Lists all contacts stored in your address book. ### list_received_transfers Shows a list of files that were sent to you (your inbox). ### list_sent_transfers Retrieves a summary list of all transfers you have initiated. ### login Authenticates your agent to access the Filemail platform. ## Prompt Examples **Prompt:** ``` List all my sent transfers on Filemail. ``` **Response:** ``` I've retrieved your sent transfers. You have 5 active deliveries, including 'Project Alpha Video' (Sent yesterday) and 'Q4 Financials'. Would you like the download status for any of these? ``` **Prompt:** ``` Get the download link for transfer ID 'ABC-123'. ``` **Response:** ``` Link retrieved! You can download the files for transfer ABC-123 here: [download_url]. The transfer contains 3 files and expires in 7 days. ``` **Prompt:** ``` Check my Filemail account storage usage. ``` **Response:** ``` Checking storage... You are currently using 45GB of your 100GB total limit. You have 55GB of space available for new transfers. ``` ## Capabilities ### Setup and Execute Transfers Start a new file transfer or finalize an existing one programmatically. ### Monitor Download Status Get real-time status updates, including who has downloaded the files and when they expire. ### Access Transfer Assets Retrieve specific download links or configuration details for any transfer in your account. ### Manage Recipients View existing contacts and manage the directory of people you frequently share files with. ### Check Account Limits Verify your current storage usage and overall account configuration details. ## Use Cases ### Marketing team needs proof of concept delivered. The marketing manager has finished a massive video project and needs to send it to three stakeholders. Instead of emailing links individually, they ask their agent to run `initialize_transfer` for the files, then use `list_sent_transfers`. The AI returns the secure URLs, allowing the manager to immediately distribute the necessary download links. ### IT team needs to audit account usage. The IT ops lead needs to know if they're close to hitting their storage cap before starting a new client project. They prompt the agent to run `get_configuration`. The AI checks the current usage and reports back available space, preventing an operational failure. ### Support team handles a lost file request. A customer claims they never received the Q2 report. The support specialist tells their agent to run `list_received_transfers` for that customer's ID. The AI verifies if the transfer arrived and uses `get_transfer_details` to retrieve the correct download link, solving the issue instantly. ### Project manager cleans up old assets. After a project wraps, the PM needs to ensure all temporary files are removed. They ask their agent to list recent transfers using `list_sent_transfers` and then tell it to run `delete_transfer` on any marked as 'archived' or incomplete. ## Benefits - Stop manual status checks. Instead of emailing a client to ask if they got the files, use `list_sent_transfers` to instantly check the download status for multiple assets at once. - Manage sensitive data lifecycle without risk. You can programmatically finalize or even delete transfers using `complete_transfer` or `delete_transfer`, ensuring compliance. - Never lose a link again. If you need to provide a client with the direct file path, use `get_transfer_details` instead of digging through dashboards. - Streamline your recipient list. Use `list_contacts` and `get_user` to keep your address book current before setting up a new delivery. - Always know your limits. Run `get_configuration` to check account storage usage so you never get blocked mid-project. ## How It Works The bottom line is: your AI client uses these credentials to talk directly to Filemail's API, bypassing any need for manual website logins or complex web forms. 1. Subscribe to this MCP in Vinkius and retrieve your API Key and Login Token from Filemail settings. 2. Pass those credentials to your AI client. Your agent can then communicate with the service, initiating commands like listing transfers or checking storage limits. 3. The system executes the request using its tools and provides a conversational status update (e.g., 'You have 5 active deliveries') that you can use immediately. ## Frequently Asked Questions **How do I check if a client downloaded my files using the Filemail MCP?** You use `list_sent_transfers` to get a summary of everything you sent. This shows you active deliveries and their current download status. **What is the difference between `list_received_transfers` and `get_transfer_details`?** `list_received_transfers` gives you a list of all files sent to you (the inbox view). Use `get_transfer_details` when you know the specific transfer ID and need details like the download link or file count. **Can I check my storage limits using Filemail MCP?** Yes, running `get_configuration` gives you immediate access to your account's total storage limit and how much space you are currently using. This is great for planning big projects. **How do I start a new transfer programmatically?** You run the `initialize_transfer` tool through your agent. It handles setting up the secure links and metadata needed before you actually send the files out. **What steps should I follow to perform a secure login using the `login` tool?** You initiate access by calling `login`. This action authenticates your agent against Filemail, providing the necessary tokens for all subsequent data calls. Once logged in, you gain full control over tracking and managing files. **If a transfer is no longer needed, how can I use the `delete_transfer` tool to clean up my account?** Calling `delete_transfer` instantly removes the specified delivery from your Filemail account. Always confirm the transfer ID before running this command; deletions are irreversible. **How do I manage recipient details or get a list of my contacts using the `list_contacts` tool?** The `list_contacts` function retrieves your stored address book. This lets you verify recipients and organize directories before setting up any new file sharing operations. **What is the purpose of the `complete_transfer` tool when managing a delivery?** Using `complete_transfer` officially finalizes a file delivery. This moves the record from a pending or active status to fully completed within your account's management log. **How do I get my Filemail API credentials?** Log in to your Filemail account, go to account settings, and locate your API Key and Login Token in the developer or security section. **How do I upload files after initialization?** This connector handles metadata. Use the 'uploadurl' returned by `initialize_transfer` to upload your file data via your preferred HTTP client. **Can I check my account storage limits?** Yes! Use the `get_configuration` tool to retrieve current storage usage, total limits, and account configuration details.