get_attachment_content
Retrieve attached files from Kaltura videos to access supplementary materials like PDFs, presentation slides, or documents. Returns file content or download URLs for specific attachment IDs.
Instructions
Download or read ATTACHED FILES from videos. USE WHEN: Accessing supplementary materials, downloading PDFs, getting presentation slides, reading attached documents. RETURNS: File content (if text) or download URL. EXAMPLE: 'Download the PDF slides', 'Read the attached notes'. Use after list_attachment_assets to get specific attachment ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| attachment_asset_id | Yes | Attachment ID from list_attachment_assets (format: '1_xyz789') |
Implementation Reference
- src/kaltura_mcp/tools/assets.py:263-364 (handler)The core handler function implementing get_attachment_content tool. It retrieves attachment asset details using Kaltura API, generates download URL, downloads the content, base64 encodes it, and returns structured JSON with metadata and content.
async def get_attachment_content( manager: KalturaClientManager, attachment_asset_id: str, ) -> str: """Get download URL and details for an attachment asset.""" if not ATTACHMENT_AVAILABLE: return json.dumps( { "error": "Attachment functionality is not available. The Attachment plugin is not installed.", "attachmentAssetId": attachment_asset_id, }, indent=2, ) client = manager.get_client() try: # Get attachment asset details attachment_asset = client.attachment.attachmentAsset.get(attachment_asset_id) # Get the attachment download URL download_url = client.attachment.attachmentAsset.getUrl(attachment_asset_id) # Validate URL before making request if not download_url or not isinstance(download_url, str): return json.dumps( { "error": "Invalid or missing attachment download URL", "attachmentAssetId": attachment_asset_id, }, indent=2, ) elif not download_url.startswith(("http://", "https://")): return json.dumps( { "error": "Attachment URL must use HTTP or HTTPS protocol", "attachmentAssetId": attachment_asset_id, }, indent=2, ) # Download the actual attachment content attachment_content = None download_error = None try: # Create a session for downloading session = requests.Session() # Set headers headers = {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"} # Download the attachment content with timeout response = session.get(download_url, headers=headers, timeout=30) response.raise_for_status() # Encode content as base64 import base64 attachment_content = base64.b64encode(response.content).decode("utf-8") except requests.exceptions.RequestException as e: download_error = f"Failed to download attachment content: {str(e)}" except Exception as e: download_error = f"Error processing attachment content: {str(e)}" result = { "attachmentAssetId": attachment_asset_id, "entryId": attachment_asset.entryId, "filename": attachment_asset.filename, "title": attachment_asset.title, "format": attachment_asset.format.value if hasattr(attachment_asset.format, "value") else str(attachment_asset.format), "downloadUrl": download_url, "size": attachment_asset.size, "description": attachment_asset.description, "tags": attachment_asset.tags, } if download_error: result["downloadError"] = download_error result[ "note" ] = "Failed to download content automatically. You can try the downloadUrl manually." else: result["content"] = attachment_content result["contentEncoding"] = "base64" result["note"] = "Content downloaded and encoded as base64" return json.dumps(result, indent=2) except Exception as e: return json.dumps( { "error": f"Failed to get attachment content: {str(e)}", "attachmentAssetId": attachment_asset_id, }, indent=2, ) - src/kaltura_mcp/server.py:476-490 (registration)Tool registration in MCP server's list_tools() function, defining name, description, and input schema.
types.Tool( name="get_attachment_content", description="Download or read ATTACHED FILES from videos. USE WHEN: Accessing supplementary materials, downloading PDFs, getting presentation slides, reading attached documents. RETURNS: File content (if text) or download URL. EXAMPLE: 'Download the PDF slides', 'Read the attached notes'. Use after list_attachment_assets to get specific attachment ID.", inputSchema={ "type": "object", "properties": { "attachment_asset_id": { "type": "string", "description": "Attachment ID from list_attachment_assets (format: '1_xyz789')", }, }, "required": ["attachment_asset_id"], }, ), ] - src/kaltura_mcp/server.py:479-488 (schema)Input schema definition for the get_attachment_content tool, specifying the required attachment_asset_id parameter.
inputSchema={ "type": "object", "properties": { "attachment_asset_id": { "type": "string", "description": "Attachment ID from list_attachment_assets (format: '1_xyz789')", }, }, "required": ["attachment_asset_id"], }, - src/kaltura_mcp/server.py:527-528 (registration)Dispatch/execution routing in the server's call_tool() method for invoking the get_attachment_content handler.
elif name == "get_attachment_content": result = await get_attachment_content(kaltura_manager, **arguments) - src/kaltura_mcp/tools/__init__.py:14-64 (registration)Import and export of the get_attachment_content function in the tools module __init__.py for easy access.
get_attachment_content, get_caption_content, list_attachment_assets, list_caption_assets, ) # Import by domain for clear organization from .media import ( get_download_url, get_media_entry, get_thumbnail_url, list_media_entries, ) from .search import ( esearch_entries, list_categories, search_entries, search_entries_intelligent, ) from .utils import ( handle_kaltura_error, safe_serialize_kaltura_field, validate_entry_id, ) # Export all tools __all__ = [ # Utilities "handle_kaltura_error", "safe_serialize_kaltura_field", "validate_entry_id", # Media operations "get_download_url", "get_media_entry", "get_thumbnail_url", "list_media_entries", # Analytics operations "get_analytics", "get_analytics_timeseries", "get_video_retention", "get_realtime_metrics", "get_quality_metrics", "get_geographic_breakdown", "list_analytics_capabilities", # Search operations "esearch_entries", "list_categories", "search_entries", "search_entries_intelligent", # Asset operations "get_attachment_content",