# Filemail MCP > Filemail MCP Server lets your AI client handle all secure file transfers. Transfer terabyte-sized assets with password protection and download tracking, all through natural conversation. Manage uploads, check storage limits, and monitor delivery status without leaving your chat window. It's your dedicated file logistics coordinator. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** large-file-transfer, secure-sharing, download-tracking, password-protection, branded-transfers, file-delivery ## Description Filemail lets your AI client handle all your secure file transfers. You'll transfer terabyte-sized assets with password protection and download tracking, all just by talking to your agent. It's your dedicated file logistics coordinator. You'll start a new transfer using `initialize_transfer` and finish it with `complete_transfer`. You can check your storage limits and operational setup using `get_configuration`. You'll also need to log in first; run `login` to authenticate your agent with your Filemail account. You'll get your personal profile info with `get_user` and see who's in your address book by running `list_contacts`. To see what you sent out, run `list_sent_transfers`; to see what came in, run `list_received_transfers`. You can pull up all the details and download links for a specific transfer ID using `get_transfer_details`. If you need to clean house, you can permanently remove old transfers with `delete_transfer`. ## Tools ### complete_transfer Finalizes a file transfer, moving it from pending status to complete. ### delete_transfer Permanently removes a transfer from your account. ### get_configuration Retrieves operational details and storage limits for your Filemail account. ### get_transfer_details Gets specific information and download links for a single transfer ID. ### get_user Retrieves your personal Filemail user profile information. ### initialize_transfer Starts a new file transfer process and returns necessary secure upload URLs. ### list_contacts Shows a list of contacts saved in your Filemail address book. ### list_received_transfers Lists all files that have been sent to your Filemail account. ### list_sent_transfers Lists all files you have sent out, including recent activity and status. ### login Authenticates your AI client with your Filemail account. ## 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 ### Initiate and Manage Transfers The agent starts new transfers using `initialize_transfer` and manages the process lifecycle with `complete_transfer`. ### Monitor Transfer Status and History You check the status of sent items with `list_sent_transfers` or view incoming files using `list_received_transfers`. ### Retrieve Specific Assets and Links The agent gets download links and transfer details for specific IDs using `get_transfer_details`. ### Manage Contacts and Users You list contacts via `list_contacts` and retrieve your profile information using `get_user`. ### Handle Account Setup and Cleanup The agent checks your storage limits with `get_configuration` and can delete old transfers using `delete_transfer`. ## Use Cases ### Client needs to confirm receipt of a large presentation. The client director asks their agent: 'Check if Sarah received the Q4 report.' The agent runs `list_received_transfers` and finds the file. It then uses `get_transfer_details` to verify the status and provide the download link to the director. ### Marketing team needs to send a bulk campaign asset. The marketing manager asks: 'Start a new transfer for the holiday video and set the expiry to 60 days.' The agent calls `initialize_transfer`, gets the secure upload URL, and confirms the process started. They then use `list_sent_transfers` to track the initial status. ### IT team needs to clean up old, sensitive data. The ops engineer types: 'Delete all transfers older than 90 days.' The agent iterates through `list_sent_transfers` (or receives a list) and calls `delete_transfer` for each one, ensuring compliance and freeing up space. ### Support agent needs to verify a user's account status. The agent asks: 'What's the storage usage for this account?' The agent runs `get_configuration` and replies with the exact metrics (e.g., 45GB used of 100GB total), giving the support agent immediate answers. ## Benefits - Monitor delivery status in real-time. Use `list_sent_transfers` to see which files were delivered and if they're still active. - Never manually check storage. `get_configuration` tells you exactly how much space you're using and what your total limit is. - Instantly provide download links. Give your agent the transfer ID, and `get_transfer_details` pulls the direct link and expiration date. - Handle bulk transfers programmatically. Use `initialize_transfer` to start a transfer and get the secure upload URLs immediately. - Keep your records clean. Use `delete_transfer` to permanently remove old, sensitive files and free up storage. - Manage your network contacts. `list_contacts` lets you access your address book so you don't have to manually find recipient emails. ## How It Works The bottom line is, your AI client acts as a file logistics coordinator, managing all file transfers and account details without you touching the Filemail website. 1. First, subscribe to the Filemail server and retrieve your API Key and Login Token from your Filemail account settings. 2. Next, tell your AI client what you need. For example, ask it to 'list all my sent transfers' or 'check my storage usage'. 3. The AI uses the dedicated tools to perform the action, and you get a natural language report detailing the transfer status, links, or account metrics. ## Frequently Asked Questions **How do I use the `list_sent_transfers` tool in Filemail MCP Server?** The agent shows you all files you sent. It lists the transfer name, when it was sent, and its current status. You can then ask for more detail on any specific transfer ID. **Does the `get_configuration` tool show my storage usage?** Yes, it checks your account limits. It tells you exactly how much storage you've used and how much space you have left for new files. **Can I use `get_transfer_details` to get a download link?** Yes. Giving the agent a transfer ID allows it to retrieve the direct download link and details, including file count and expiration date. **What is the purpose of the `initialize_transfer` tool?** This tool starts a new transfer. It gives you the secure upload URLs and metadata needed to begin uploading your large files. **Is the `delete_transfer` tool permanent?** Yes, running `delete_transfer` permanently removes the transfer. The agent confirms this action before executing it. **How do I use the `login` tool to start transferring files?** You use the `login` tool to authenticate your connection to Filemail. This establishes the necessary session so your AI client can perform any other actions, like listing or initializing transfers. **What information does the `list_received_transfers` tool provide?** It lists all files sent to your account (your inbox). This includes transfer metadata, such as the sender's name, the transfer name, and the date it arrived. **Is there a way to programmatically manage contacts using `list_contacts`?** Yes, `list_contacts` allows you to access and manage your address book directly. This means your AI client can pull recipient directories without you having to manually navigate the Filemail interface. **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.