files-com-mcp 1.0__tar.gz

files_com_mcp-1.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2019- Action Verb, LLC (https://www.files.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

files_com_mcp-1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: files_com_mcp
+Version: 1.0
+Summary: MCP for the Files.com API
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.2.0
+Requires-Dist: mcp
+Requires-Dist: files-com
+Requires-Dist: requests>=2.31.0
+Requires-Dist: fastapi
+Dynamic: license-file
+
+# Files.com Python MCP Server
+
+Files.com MCP provides tools that are a subset of our APIs offering our most popular operations.
+
+## Important Information
+
+Some LLMs struggle with too many tools in the context. LLM clients often offer a way to disable and enable specific tools for an MCP. If your LLM is having trouble picking the right tools, try disabling the tools you do not need in your LLM client.
+
+## Installing in Claude
+
+To install into Claude you have to add JSON to the `claude_desktop_config.json`
+
+An official tutorial can found here: https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server
+
+To add our MCP, add the following JSON (be sure to change the path and FILESCOM_API_KEY value)
+
+NOTE: This version assumes you are running from source. Once we have PyPi publishing this README will have them version as well.
+
+### uv Required
+
+These examples requires `uv` which is a popular modern environment manager for running isolated python tools. Installation is out of scope of this README.
+
+### Claude Config - STDIO
+
+```
+{
+  "mcpServers": {
+    "files_com_mcp": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/path/to/folder-containing-files_com_mcp",
+        "run",
+        "-m",
+        "files_com_mcp"
+      ],
+      "env": {
+        "FILES_COM_API_KEY": "CHangeME"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+While our MCP works well out-of-the-box, some power users find value in modifying MCP code to suit their unique needs. For those power users, it is recommended to use STDIO mode. Upload and Download tools rely on the file system where the MCP is running.
+
+To test LLM tools we recommend a popular command-line program called `inspector`. This will start a WebUI on a local port, the output of the command will give you the link to the inspector GUI.
+Ex: http://127.0.0.1:6274
+
+## Develoment - STDIO
+
+```
+FILESCOM_API_KEY="dummyKey" npx @modelcontextprotocol/inspector uv run -m files_com_mcp
+```
+
+## Development - SSE
+
+```
+FILESCOM_API_KEY="dummyKey" uv run -m files_com_mcp --mode server --port 12345
+```
+
+Launch the inspector
+
+```
+npx @modelcontextprotocol/inspector
+```

files_com_mcp-1.0/README.md

@@ -0,0 +1,69 @@
+# Files.com Python MCP Server
+
+Files.com MCP provides tools that are a subset of our APIs offering our most popular operations.
+
+## Important Information
+
+Some LLMs struggle with too many tools in the context. LLM clients often offer a way to disable and enable specific tools for an MCP. If your LLM is having trouble picking the right tools, try disabling the tools you do not need in your LLM client.
+
+## Installing in Claude
+
+To install into Claude you have to add JSON to the `claude_desktop_config.json`
+
+An official tutorial can found here: https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server
+
+To add our MCP, add the following JSON (be sure to change the path and FILESCOM_API_KEY value)
+
+NOTE: This version assumes you are running from source. Once we have PyPi publishing this README will have them version as well.
+
+### uv Required
+
+These examples requires `uv` which is a popular modern environment manager for running isolated python tools. Installation is out of scope of this README.
+
+### Claude Config - STDIO
+
+```
+{
+  "mcpServers": {
+    "files_com_mcp": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/path/to/folder-containing-files_com_mcp",
+        "run",
+        "-m",
+        "files_com_mcp"
+      ],
+      "env": {
+        "FILES_COM_API_KEY": "CHangeME"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+While our MCP works well out-of-the-box, some power users find value in modifying MCP code to suit their unique needs. For those power users, it is recommended to use STDIO mode. Upload and Download tools rely on the file system where the MCP is running.
+
+To test LLM tools we recommend a popular command-line program called `inspector`. This will start a WebUI on a local port, the output of the command will give you the link to the inspector GUI.
+Ex: http://127.0.0.1:6274
+
+## Develoment - STDIO
+
+```
+FILESCOM_API_KEY="dummyKey" npx @modelcontextprotocol/inspector uv run -m files_com_mcp
+```
+
+## Development - SSE
+
+```
+FILESCOM_API_KEY="dummyKey" uv run -m files_com_mcp --mode server --port 12345
+```
+
+Launch the inspector
+
+```
+npx @modelcontextprotocol/inspector
+```

files_com_mcp-1.0/files_com_mcp/__init__.py

@@ -0,0 +1,3 @@
+from . import utils # noqa: F401
+
+__version__ = "0.1.0"

files_com_mcp-1.0/files_com_mcp/__main__.py

@@ -0,0 +1,31 @@
+import argparse
+import os
+import files_sdk
+from files_com_mcp.server import run_stdio, run_server
+
+def main():
+    parser = argparse.ArgumentParser(description="Run MCP server")
+
+    parser.add_argument(
+        "--mode", choices=["stdio", "server"], default="stdio",
+        help="Transport mode: stdio or server (HTTP)"
+    )
+
+    parser.add_argument(
+        "--port", type=int, default=8000,
+        help="Port to use in server mode"
+    )
+
+    args = parser.parse_args()
+
+    if args.mode == "stdio":
+        run_stdio()
+    elif args.mode == "server":
+        run_server(port=args.port)
+
+if __name__ == "__main__":
+    # For pointing to mock server for testing
+    if os.getenv("FILES_COM_BASE_URL"):
+      files_sdk.base_url = os.getenv("FILES_COM_BASE_URL")
+
+    main()

files_com_mcp-1.0/files_com_mcp/authored_tools/__init__.py

@@ -0,0 +1,4 @@
+# List of tool modules to be loaded dynamically
+tool_list = ["local_transfer"]
+# Enable these for debugging and testing
+#tool_list = tool_list + ["check_platform_status", "debug"]

files_com_mcp-1.0/files_com_mcp/authored_tools/check_platform_status.py

@@ -0,0 +1,18 @@
+import requests
+
+async def check_platform_status() -> str:
+    """Check Files.com platform status at status.files.com."""
+    url = "https://status.files.com/api/v2/status.json"
+    try:
+        response = requests.get(url)
+        if response.status_code == 200:
+            return response.json().get('status', {}).get('description', 'Error processing the status page')
+        else:
+            return "Error connecting to status page"
+    except requests.exceptions.RequestException:
+        return "Error connecting to status page"
+
+def register_tools(mcp):
+    @mcp.tool()
+    async def check_platform_status_tool() -> str:
+        return await check_platform_status()

files_com_mcp-1.0/files_com_mcp/authored_tools/debug.py

@@ -0,0 +1,8 @@
+async def hello_world() -> str:
+    """Files.com MCP Debugging Hello World function."""
+    return "Hello World"
+
+def register_tools(mcp):
+    @mcp.tool()
+    async def hello_world_tool() -> str:
+        return await hello_world()

files_com_mcp-1.0/files_com_mcp/authored_tools/local_transfer.py

@@ -0,0 +1,59 @@
+import os
+from fastmcp import Context
+import files_sdk
+import files_sdk.error
+
+async def download_file_to_local(context: Context, remote_path: str, local_path: str) -> str:
+    """Download a file from my Files.com site. Specify the remote path of the file to download and a local path to save the file at.
+
+    Args:
+        remote_path: The full path on my Files.com site of the file to be downloaded.
+        local_path: 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 the downloaded file.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+
+        files_sdk.file.download_file(remote_path, local_path, options)
+        return f"File downloaded successfully to: {os.path.abspath(local_path)}"
+
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def upload_file_from_local(context: Context, local_path: str, remote_path: str) -> str:
+    """Upload a file to my Files.com site. Specify the local path of the file to upload and a remote path to save the file at.
+
+    Args:
+        local_path: The full path on my local system of the file to be uploaded.
+        remote_path: The full path on my Files.com site for the file to be uploaded to.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        
+        # Smart Default(s)
+        params["mkdir_parents"] = True
+
+        files_sdk.file.upload_file(local_path, remote_path, options, params)
+        return f"File uploaded successfully from: {os.path.abspath(local_path)}"
+
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+def register_tools(mcp):
+    @mcp.tool()
+    async def download_file_to_local_tool(context: Context, remote_path: str, local_path: str) -> str:
+        return await download_file_to_local(context, remote_path, local_path)
+
+    @mcp.tool()
+    async def upload_file_from_local_tool(context: Context, local_path: str, remote_path: str, ) -> str:
+        return await upload_file_from_local(context, local_path, remote_path)

files_com_mcp-1.0/files_com_mcp/generated_tools/__init__.py

@@ -0,0 +1 @@
+tool_list = ["bundle", "bundle_download", "bundle_notification", "bundle_recipient", "bundle_registration", "file", "folder", "group", "user", "automation", "history", "permission", "remote_server"]

files_com_mcp-1.0/files_com_mcp/generated_tools/automation.py

@@ -0,0 +1,151 @@
+from fastmcp import Context
+from files_com_mcp.utils import object_list_to_markdown_table
+import files_sdk
+import files_sdk.error
+
+async def list_automation(context: Context) -> str:
+    """List Automations"""
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+
+        retval = files_sdk.automation.list(params, options)
+        retval = [item for item in retval.auto_paging_iter()]
+        if not retval:
+            return "No automations found."
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "always_overwrite_size_matching_files", "automation", "deleted", "description", "destination_replace_from", "destination_replace_to", "destinations", "disabled", "exclude_pattern", "import_urls", "flatten_destination_structure", "group_ids", "ignore_locked_folders", "interval", "last_modified_at", "legacy_folder_matching", "name", "overwrite_files", "path", "path_time_zone", "recurring_day", "retry_on_failure_interval_in_minutes", "retry_on_failure_number_of_attempts", "schedule", "human_readable_schedule", "schedule_days_of_week", "schedule_times_of_day", "schedule_time_zone", "source", "sync_ids", "trigger_actions", "trigger", "user_id", "user_ids", "value", "webhook_url"])
+        return f"Automation Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def find_automation(context: Context, id: int | None = None) -> str:
+    """Show Automation
+
+    Args:
+        id: Automation ID.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if id is None:
+            return "Missing required parameter: id"
+        params["id"] = id        
+
+        retval = files_sdk.automation.find(id, params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "always_overwrite_size_matching_files", "automation", "deleted", "description", "destination_replace_from", "destination_replace_to", "destinations", "disabled", "exclude_pattern", "import_urls", "flatten_destination_structure", "group_ids", "ignore_locked_folders", "interval", "last_modified_at", "legacy_folder_matching", "name", "overwrite_files", "path", "path_time_zone", "recurring_day", "retry_on_failure_interval_in_minutes", "retry_on_failure_number_of_attempts", "schedule", "human_readable_schedule", "schedule_days_of_week", "schedule_times_of_day", "schedule_time_zone", "source", "sync_ids", "trigger_actions", "trigger", "user_id", "user_ids", "value", "webhook_url"])
+        return f"Automation Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def create_automation(context: Context, automation: str | None = None) -> str:
+    """Create Automation
+
+    Args:
+        automation: Automation type
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if automation is None:
+            return "Missing required parameter: automation"
+        params["automation"] = automation        
+
+        retval = files_sdk.automation.create(params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "always_overwrite_size_matching_files", "automation", "deleted", "description", "destination_replace_from", "destination_replace_to", "destinations", "disabled", "exclude_pattern", "import_urls", "flatten_destination_structure", "group_ids", "ignore_locked_folders", "interval", "last_modified_at", "legacy_folder_matching", "name", "overwrite_files", "path", "path_time_zone", "recurring_day", "retry_on_failure_interval_in_minutes", "retry_on_failure_number_of_attempts", "schedule", "human_readable_schedule", "schedule_days_of_week", "schedule_times_of_day", "schedule_time_zone", "source", "sync_ids", "trigger_actions", "trigger", "user_id", "user_ids", "value", "webhook_url"])
+        return f"Automation Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def update_automation(context: Context, id: int | None = None) -> str:
+    """Update Automation
+
+    Args:
+        id: Automation ID.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if id is None:
+            return "Missing required parameter: id"
+        params["id"] = id        
+
+        retval = files_sdk.automation.update(id, params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "always_overwrite_size_matching_files", "automation", "deleted", "description", "destination_replace_from", "destination_replace_to", "destinations", "disabled", "exclude_pattern", "import_urls", "flatten_destination_structure", "group_ids", "ignore_locked_folders", "interval", "last_modified_at", "legacy_folder_matching", "name", "overwrite_files", "path", "path_time_zone", "recurring_day", "retry_on_failure_interval_in_minutes", "retry_on_failure_number_of_attempts", "schedule", "human_readable_schedule", "schedule_days_of_week", "schedule_times_of_day", "schedule_time_zone", "source", "sync_ids", "trigger_actions", "trigger", "user_id", "user_ids", "value", "webhook_url"])
+        return f"Automation Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def delete_automation(context: Context, id: int | None = None) -> str:
+    """Delete Automation
+
+    Args:
+        id: Automation ID.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if id is None:
+            return "Missing required parameter: id"
+        params["id"] = id        
+
+        retval = files_sdk.automation.delete(id, params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "always_overwrite_size_matching_files", "automation", "deleted", "description", "destination_replace_from", "destination_replace_to", "destinations", "disabled", "exclude_pattern", "import_urls", "flatten_destination_structure", "group_ids", "ignore_locked_folders", "interval", "last_modified_at", "legacy_folder_matching", "name", "overwrite_files", "path", "path_time_zone", "recurring_day", "retry_on_failure_interval_in_minutes", "retry_on_failure_number_of_attempts", "schedule", "human_readable_schedule", "schedule_days_of_week", "schedule_times_of_day", "schedule_time_zone", "source", "sync_ids", "trigger_actions", "trigger", "user_id", "user_ids", "value", "webhook_url"])
+        return f"Automation Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+def register_tools(mcp):
+    @mcp.tool()
+    async def list_automation_tool(context: Context) -> str:
+        return await list_automation(context)
+
+    @mcp.tool()
+    async def find_automation_tool(context: Context, id: int | None = None) -> str:
+        return await find_automation(context, id)
+
+    @mcp.tool()
+    async def create_automation_tool(context: Context, automation: str | None = None) -> str:
+        return await create_automation(context, automation)
+
+    @mcp.tool()
+    async def update_automation_tool(context: Context, id: int | None = None) -> str:
+        return await update_automation(context, id)
+
+    @mcp.tool()
+    async def delete_automation_tool(context: Context, id: int | None = None) -> str:
+        return await delete_automation(context, id)
+

files_com_mcp-1.0/files_com_mcp/generated_tools/bundle.py

@@ -0,0 +1,175 @@
+from fastmcp import Context
+from files_com_mcp.utils import object_list_to_markdown_table
+import files_sdk
+import files_sdk.error
+
+async def list_bundle(context: Context) -> str:
+    """List Bundles"""
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+
+        retval = files_sdk.bundle.list(params, options)
+        retval = [item for item in retval.auto_paging_iter()]
+        if not retval:
+            return "No bundles found."
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "paths", "password", "expires_at", "max_uses", "description", "note", "require_registration"])
+        return f"Bundle Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def find_bundle(context: Context, id: int | None = None) -> str:
+    """Show Bundle
+
+    Args:
+        id: Bundle ID.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if id is None:
+            return "Missing required parameter: id"
+        params["id"] = id        
+
+        retval = files_sdk.bundle.find(id, params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "paths", "password", "expires_at", "max_uses", "description", "note", "require_registration"])
+        return f"Bundle Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def create_bundle(context: Context, paths: list | None = None, password: str | None = None, expires_at: str | None = None, max_uses: int | None = None, description: str | None = None, note: str | None = None, require_registration: bool | None = None) -> str:
+    """Create Bundle
+
+    Args:
+        paths: A list of paths to include in this bundle.
+        password: Password for this bundle.
+        expires_at: Bundle expiration date/time
+        max_uses: Maximum number of times bundle can be accessed
+        description: Public description
+        note: Bundle internal note
+        require_registration: Show a registration page that captures the downloader's name and email address?
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if paths is None:
+            return "Missing required parameter: paths"
+        params["paths"] = paths        
+        if password is not None:
+          params["password"] = password
+        if expires_at is not None:
+          params["expires_at"] = expires_at
+        if max_uses is not None:
+          params["max_uses"] = max_uses
+        if description is not None:
+          params["description"] = description
+        if note is not None:
+          params["note"] = note
+        if require_registration is not None:
+          params["require_registration"] = require_registration
+        
+        # Smart Default(s)
+        params["permissions"] = "read"
+
+        retval = files_sdk.bundle.create(params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "paths", "password", "expires_at", "max_uses", "description", "note", "require_registration"])
+        return f"Bundle Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def update_bundle(context: Context, id: int | None = None, expires_at: str | None = None) -> str:
+    """Update Bundle
+
+    Args:
+        id: Bundle ID.
+        expires_at: Bundle expiration date/time
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if id is None:
+            return "Missing required parameter: id"
+        params["id"] = id        
+        if expires_at is not None:
+          params["expires_at"] = expires_at
+
+        retval = files_sdk.bundle.update(id, params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "paths", "password", "expires_at", "max_uses", "description", "note", "require_registration"])
+        return f"Bundle Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+async def delete_bundle(context: Context, id: int | None = None) -> str:
+    """Delete Bundle
+
+    Args:
+        id: Bundle ID.
+    """
+
+    try:
+        options = {"api_key": context.request_context.session._files_com_api_key}
+        params = {}
+        if id is None:
+            return "Missing required parameter: id"
+        params["id"] = id        
+
+        retval = files_sdk.bundle.delete(id, params, options)
+        retval = [retval]
+
+        markdown_list = object_list_to_markdown_table(retval, ["id", "paths", "password", "expires_at", "max_uses", "description", "note", "require_registration"])
+        return f"Bundle Response:\n{markdown_list}"
+    except files_sdk.error.NotAuthenticatedError as err:
+        return f"Authentication Error: {err}"
+    except files_sdk.error.Error as err:
+        return f"Files.com Error: {err}"
+    except Exception as ex:
+        return f"General Exception: {ex}"
+
+def register_tools(mcp):
+    @mcp.tool()
+    async def list_bundle_tool(context: Context) -> str:
+        return await list_bundle(context)
+
+    @mcp.tool()
+    async def find_bundle_tool(context: Context, id: int | None = None) -> str:
+        return await find_bundle(context, id)
+
+    @mcp.tool()
+    async def create_bundle_tool(context: Context, paths: list | None = None, password: str | None = None, expires_at: str | None = None, max_uses: int | None = None, description: str | None = None, note: str | None = None, require_registration: bool | None = None) -> str:
+        return await create_bundle(context, paths, password, expires_at, max_uses, description, note, require_registration)
+
+    @mcp.tool()
+    async def update_bundle_tool(context: Context, id: int | None = None, expires_at: str | None = None) -> str:
+        return await update_bundle(context, id, expires_at)
+
+    @mcp.tool()
+    async def delete_bundle_tool(context: Context, id: int | None = None) -> str:
+        return await delete_bundle(context, id)
+