meta-ads-mcp 0.3.10__py3-none-any.whl → 0.4.1__py3-none-any.whl

meta_ads_mcp/__init__.py

@@ -7,7 +7,7 @@ with the Claude LLM.
 
 from meta_ads_mcp.core.server import main
 
-__version__ = "0.3.10"
+__version__ = "0.4.1"
 
 __all__ = [
     'get_ad_accounts',
@@ -24,7 +24,6 @@ __all__ = [
     'get_ad_image',
     'update_ad',
     'get_insights',
-    'debug_image_download',
     'get_login_link',
     'login_cli',
     'main'
@@ -46,7 +45,6 @@ from .core import (
     get_ad_image,
     update_ad,
     get_insights,
-    debug_image_download,
     get_login_link,
     login_cli,
     main

meta_ads_mcp/core/__init__.py

@@ -5,13 +5,14 @@ from .accounts import get_ad_accounts, get_account_info
 from .campaigns import get_campaigns, get_campaign_details, create_campaign
 from .adsets import get_adsets, get_adset_details, update_adset
 from .ads import get_ads, get_ad_details, get_ad_creatives, get_ad_image, update_ad
-from .insights import get_insights, debug_image_download
+from .insights import get_insights
 from .authentication import get_login_link
 from .server import login_cli, main
 from .auth import login
 from .ads_library import search_ads_archive
 from .budget_schedules import create_budget_schedule
 from . import reports  # Import module to register conditional tools
+from . import duplication  # Import module to register conditional duplication tools
 
 __all__ = [
     'mcp_server',
@@ -29,7 +30,6 @@ __all__ = [
     'get_ad_image',
     'update_ad',
     'get_insights',
-    'debug_image_download',
     'get_login_link',
     'login_cli',
     'login',

meta_ads_mcp/core/adsets.py

@@ -270,12 +270,21 @@ async def update_adset(adset_id: str, frequency_control_specs: List[Dict[str, An
     current_details = json.loads(current_details_json)
     
     # Start the callback server if not already running
-    port = start_callback_server()
-    
-    # Generate confirmation URL with properly encoded parameters
-    changes_json = json.dumps(changes)
-    encoded_changes = urllib.parse.quote(changes_json)
-    confirmation_url = f"http://localhost:{port}/confirm-update?adset_id={adset_id}&token={access_token}&changes={encoded_changes}"
+    try:
+        port = start_callback_server()
+        
+        # Generate confirmation URL with properly encoded parameters
+        changes_json = json.dumps(changes)
+        encoded_changes = urllib.parse.quote(changes_json)
+        confirmation_url = f"http://localhost:{port}/confirm-update?adset_id={adset_id}&token={access_token}&changes={encoded_changes}"
+    except Exception as e:
+        return json.dumps({
+            "error": "Callback server disabled",
+            "message": f"Cannot create confirmation URL: {str(e)}",
+            "suggestion": "Manual update confirmation not available when META_ADS_DISABLE_CALLBACK_SERVER is set",
+            "adset_id": adset_id,
+            "proposed_changes": changes
+        }, indent=2)
     
     # Reset the update confirmation
     update_confirmation.clear()

meta_ads_mcp/core/auth.py

@@ -216,22 +216,27 @@ class AuthManager:
             return self.token_info.access_token
         
         # Start the callback server if not already running
-        port = start_callback_server()
-        
-        # Update redirect URI with the actual port
-        self.redirect_uri = f"http://localhost:{port}/callback"
-        
-        # Generate the auth URL
-        auth_url = self.get_auth_url()
-        
-        # Open browser with auth URL
-        logger.info(f"Opening browser with URL: {auth_url}")
-        webbrowser.open(auth_url)
-        
-        # We don't wait for the token here anymore
-        # The token will be processed by the callback server
-        # Just return None to indicate we've started the flow
-        return None
+        try:
+            port = start_callback_server()
+            
+            # Update redirect URI with the actual port
+            self.redirect_uri = f"http://localhost:{port}/callback"
+            
+            # Generate the auth URL
+            auth_url = self.get_auth_url()
+            
+            # Open browser with auth URL
+            logger.info(f"Opening browser with URL: {auth_url}")
+            webbrowser.open(auth_url)
+            
+            # We don't wait for the token here anymore
+            # The token will be processed by the callback server
+            # Just return None to indicate we've started the flow
+            return None
+        except Exception as e:
+            logger.error(f"Failed to start callback server: {e}")
+            logger.info("Callback server disabled. OAuth authentication flow cannot be used.")
+            return None
     
     def get_access_token(self) -> Optional[str]:
         """
@@ -477,7 +482,14 @@ def login():
     
     try:
         # Start the callback server first
-        port = start_callback_server()
+        try:
+            port = start_callback_server()
+        except Exception as callback_error:
+            print(f"Error: {callback_error}")
+            print("Callback server is disabled. Please use alternative authentication methods:")
+            print("- Set PIPEBOARD_API_TOKEN environment variable for Pipeboard authentication")
+            print("- Or provide a direct META_ACCESS_TOKEN environment variable")
+            return
         
         # Get the auth URL and open the browser
         auth_url = auth_manager.get_auth_url()

meta_ads_mcp/core/authentication.py

@@ -90,14 +90,23 @@ async def get_login_link(access_token: str = None) -> str:
         # IMPORTANT: Start the callback server first by calling our helper function
         # This ensures the server is ready before we provide the URL to the user
         logger.info("Starting callback server for authentication")
-        port = start_callback_server()
-        logger.info(f"Callback server started on port {port}")
-        
-        # Generate direct login URL
-        auth_manager.redirect_uri = f"http://localhost:{port}/callback"  # Ensure port is set correctly
-        logger.info(f"Setting redirect URI to {auth_manager.redirect_uri}")
-        login_url = auth_manager.get_auth_url()
-        logger.info(f"Generated login URL: {login_url}")
+        try:
+            port = start_callback_server()
+            logger.info(f"Callback server started on port {port}")
+            
+            # Generate direct login URL
+            auth_manager.redirect_uri = f"http://localhost:{port}/callback"  # Ensure port is set correctly
+            logger.info(f"Setting redirect URI to {auth_manager.redirect_uri}")
+            login_url = auth_manager.get_auth_url()
+            logger.info(f"Generated login URL: {login_url}")
+        except Exception as e:
+            logger.error(f"Failed to start callback server: {e}")
+            return json.dumps({
+                "error": "Callback server disabled",
+                "message": str(e),
+                "suggestion": "Use Pipeboard authentication (set PIPEBOARD_API_TOKEN) or provide a direct access token",
+                "authentication_method": "meta_oauth_disabled"
+            }, indent=2)
         
         # Check if we can exchange for long-lived tokens
         token_exchange_supported = bool(META_APP_SECRET)

meta_ads_mcp/core/callback_server.py

@@ -917,7 +917,16 @@ def start_callback_server() -> int:
     
     Returns:
         Port number the server is running on
+    
+    Raises:
+        Exception: If callback server is disabled via META_ADS_DISABLE_CALLBACK_SERVER environment variable
     """
+    # Check if callback server is disabled via environment variable
+    if os.environ.get("META_ADS_DISABLE_CALLBACK_SERVER"):
+        logger.info("Callback server disabled via META_ADS_DISABLE_CALLBACK_SERVER environment variable")
+        print("Callback server is disabled. OAuth authentication flow cannot be used.")
+        raise Exception("Callback server disabled via META_ADS_DISABLE_CALLBACK_SERVER environment variable. Use alternative authentication methods.")
+    
     global callback_server_thread, callback_server_running, callback_server_port, callback_server_instance, server_shutdown_timer
     
     with callback_server_lock:

meta_ads_mcp/core/duplication.py

@@ -0,0 +1,411 @@
+"""Duplication functionality for Meta Ads API."""
+
+import json
+import os
+import httpx
+from typing import Optional, Dict, Any, List, Union
+from .server import mcp_server
+from .api import meta_api_tool
+
+
+# Only register the duplication functions if the environment variable is set
+ENABLE_DUPLICATION = bool(os.environ.get("META_ADS_ENABLE_DUPLICATION", ""))
+
+if ENABLE_DUPLICATION:
+    @mcp_server.tool()
+    @meta_api_tool
+    async def duplicate_campaign(
+        campaign_id: str,
+        access_token: str = None,
+        name_suffix: Optional[str] = " - Copy",
+        include_ad_sets: bool = True,
+        include_ads: bool = True,
+        include_creatives: bool = True,
+        copy_schedule: bool = False,
+        new_daily_budget: Optional[float] = None,
+        new_status: Optional[str] = "PAUSED"
+    ) -> str:
+        """
+        Duplicate a Meta Ads campaign with all its ad sets and ads.
+
+        **SUBSCRIPTION REQUIRED**: This feature requires an active subscription.
+        
+        Args:
+            campaign_id: Meta Ads campaign ID to duplicate
+            name_suffix: Suffix to add to the duplicated campaign name
+            include_ad_sets: Whether to duplicate ad sets within the campaign
+            include_ads: Whether to duplicate ads within ad sets
+            include_creatives: Whether to duplicate ad creatives
+            copy_schedule: Whether to copy the campaign schedule
+            new_daily_budget: Override the daily budget for the new campaign
+            new_status: Status for the new campaign (ACTIVE or PAUSED)
+        """
+        return await _forward_duplication_request(
+            "campaign",
+            campaign_id,
+            access_token,
+            {
+                "name_suffix": name_suffix,
+                "include_ad_sets": include_ad_sets,
+                "include_ads": include_ads,
+                "include_creatives": include_creatives,
+                "copy_schedule": copy_schedule,
+                "new_daily_budget": new_daily_budget,
+                "new_status": new_status
+            }
+        )
+
+    @mcp_server.tool()
+    @meta_api_tool
+    async def duplicate_adset(
+        adset_id: str,
+        access_token: str = None,
+        target_campaign_id: Optional[str] = None,
+        name_suffix: Optional[str] = " - Copy",
+        include_ads: bool = True,
+        include_creatives: bool = True,
+        new_daily_budget: Optional[float] = None,
+        new_targeting: Optional[Dict[str, Any]] = None,
+        new_status: Optional[str] = "PAUSED"
+    ) -> str:
+        """
+        Duplicate a Meta Ads ad set with its ads.
+
+        **SUBSCRIPTION REQUIRED**: This feature requires an active subscription.
+        
+        Args:
+            adset_id: Meta Ads ad set ID to duplicate
+            target_campaign_id: Campaign ID to move the duplicated ad set to (optional)
+            name_suffix: Suffix to add to the duplicated ad set name
+            include_ads: Whether to duplicate ads within the ad set
+            include_creatives: Whether to duplicate ad creatives
+            new_daily_budget: Override the daily budget for the new ad set
+            new_targeting: Override targeting settings for the new ad set
+            new_status: Status for the new ad set (ACTIVE or PAUSED)
+        """
+        return await _forward_duplication_request(
+            "adset",
+            adset_id,
+            access_token,
+            {
+                "target_campaign_id": target_campaign_id,
+                "name_suffix": name_suffix,
+                "include_ads": include_ads,
+                "include_creatives": include_creatives,
+                "new_daily_budget": new_daily_budget,
+                "new_targeting": new_targeting,
+                "new_status": new_status
+            }
+        )
+
+    @mcp_server.tool()
+    @meta_api_tool
+    async def duplicate_ad(
+        ad_id: str,
+        access_token: str = None,
+        target_adset_id: Optional[str] = None,
+        name_suffix: Optional[str] = " - Copy",
+        duplicate_creative: bool = True,
+        new_creative_name: Optional[str] = None,
+        new_status: Optional[str] = "PAUSED"
+    ) -> str:
+        """
+        Duplicate a Meta Ads ad.
+
+        **SUBSCRIPTION REQUIRED**: This feature requires an active subscription.
+        
+        Args:
+            ad_id: Meta Ads ad ID to duplicate
+            target_adset_id: Ad set ID to move the duplicated ad to (optional)
+            name_suffix: Suffix to add to the duplicated ad name
+            duplicate_creative: Whether to duplicate the ad creative
+            new_creative_name: Override name for the duplicated creative
+            new_status: Status for the new ad (ACTIVE or PAUSED)
+        """
+        return await _forward_duplication_request(
+            "ad",
+            ad_id,
+            access_token,
+            {
+                "target_adset_id": target_adset_id,
+                "name_suffix": name_suffix,
+                "duplicate_creative": duplicate_creative,
+                "new_creative_name": new_creative_name,
+                "new_status": new_status
+            }
+        )
+
+    @mcp_server.tool()
+    @meta_api_tool
+    async def duplicate_creative(
+        creative_id: str,
+        access_token: str = None,
+        name_suffix: Optional[str] = " - Copy",
+        new_primary_text: Optional[str] = None,
+        new_headline: Optional[str] = None,
+        new_description: Optional[str] = None,
+        new_cta_type: Optional[str] = None,
+        new_destination_url: Optional[str] = None
+    ) -> str:
+        """
+        Duplicate a Meta Ads creative.
+
+        **SUBSCRIPTION REQUIRED**: This feature requires an active subscription.
+        
+        Args:
+            creative_id: Meta Ads creative ID to duplicate
+            name_suffix: Suffix to add to the duplicated creative name
+            new_primary_text: Override the primary text for the new creative
+            new_headline: Override the headline for the new creative
+            new_description: Override the description for the new creative
+            new_cta_type: Override the call-to-action type for the new creative
+            new_destination_url: Override the destination URL for the new creative
+        """
+        return await _forward_duplication_request(
+            "creative",
+            creative_id,
+            access_token,
+            {
+                "name_suffix": name_suffix,
+                "new_primary_text": new_primary_text,
+                "new_headline": new_headline,
+                "new_description": new_description,
+                "new_cta_type": new_cta_type,
+                "new_destination_url": new_destination_url
+            }
+        )
+
+
+async def _forward_duplication_request(resource_type: str, resource_id: str, access_token: str, options: Dict[str, Any]) -> str:
+    """
+    Forward duplication request to the cloud-hosted MCP API.
+    
+    Args:
+        resource_type: Type of resource to duplicate (campaign, adset, ad, creative)
+        resource_id: ID of the resource to duplicate
+        access_token: Meta API access token from the request
+        options: Duplication options
+    """
+    try:
+        if not access_token:
+            return json.dumps({
+                "error": "authentication_required",
+                "message": "Meta Ads access token not found",
+                "details": {
+                    "required": "Valid access token from authenticated session"
+                }
+            }, indent=2)
+
+        # Construct the API endpoint
+        base_url = "https://mcp.pipeboard.co"
+        endpoint = f"{base_url}/api/meta/duplicate/{resource_type}/{resource_id}"
+        
+        # Prepare the request
+        headers = {
+            "Authorization": f"Bearer {access_token}",
+            "Content-Type": "application/json",
+            "User-Agent": "meta-ads-mcp/1.0"
+        }
+        
+        # Remove None values from options
+        clean_options = {k: v for k, v in options.items() if v is not None}
+        
+        # Make the request to the cloud service
+        async with httpx.AsyncClient(timeout=30.0) as client:
+            response = await client.post(
+                endpoint,
+                headers=headers,
+                json=clean_options
+            )
+            
+            if response.status_code == 200:
+                result = response.json()
+                return json.dumps(result, indent=2)
+            elif response.status_code == 400:
+                # Validation failed
+                try:
+                    error_data = response.json()
+                    return json.dumps({
+                        "success": False,
+                        "error": "validation_failed",
+                        "errors": error_data.get("errors", [response.text]),
+                        "warnings": error_data.get("warnings", [])
+                    }, indent=2)
+                except:
+                    return json.dumps({
+                        "success": False,
+                        "error": "validation_failed",
+                        "errors": [response.text],
+                        "warnings": []
+                    }, indent=2)
+            elif response.status_code == 401:
+                return json.dumps({
+                    "success": False,
+                    "error": "authentication_error",
+                    "message": "Invalid or expired API token"
+                }, indent=2)
+            elif response.status_code == 402:
+                try:
+                    error_data = response.json()
+                    return json.dumps({
+                        "success": False,
+                        "error": "subscription_required",
+                        "message": error_data.get("message", "This feature is not available in your current plan"),
+                        "upgrade_url": error_data.get("upgrade_url", "https://pipeboard.co/upgrade"),
+                        "suggestion": error_data.get("suggestion", "Please upgrade your account to access this feature")
+                    }, indent=2)
+                except:
+                    return json.dumps({
+                        "success": False,
+                        "error": "subscription_required",
+                        "message": "This feature is not available in your current plan",
+                        "upgrade_url": "https://pipeboard.co/upgrade",
+                        "suggestion": "Please upgrade your account to access this feature"
+                    }, indent=2)
+            elif response.status_code == 403:
+                try:
+                    error_data = response.json()
+                    # Check if this is a premium feature error
+                    if error_data.get("error") == "premium_feature":
+                        return json.dumps({
+                            "success": False,
+                            "error": "premium_feature_required",
+                            "message": error_data.get("message", "This is a premium feature that requires subscription"),
+                            "details": error_data.get("details", {
+                                "upgrade_url": "https://pipeboard.co/upgrade",
+                                "suggestion": "Please upgrade your account to access this feature"
+                            })
+                        }, indent=2)
+                    else:
+                        # Default to facebook connection required
+                        return json.dumps({
+                            "success": False,
+                            "error": "facebook_connection_required",
+                            "message": error_data.get("message", "You need to connect your Facebook account first"),
+                            "details": error_data.get("details", {
+                                "login_flow_url": "/connections",
+                                "auth_flow_url": "/api/meta/auth"
+                            })
+                        }, indent=2)
+                except:
+                    return json.dumps({
+                        "success": False,
+                        "error": "facebook_connection_required",
+                        "message": "You need to connect your Facebook account first",
+                        "details": {
+                            "login_flow_url": "/connections",
+                            "auth_flow_url": "/api/meta/auth"
+                        }
+                    }, indent=2)
+            elif response.status_code == 404:
+                return json.dumps({
+                    "success": False,
+                    "error": "resource_not_found",
+                    "message": f"{resource_type.title()} not found or access denied",
+                    "suggestion": f"Verify the {resource_type} ID and your Facebook account permissions"
+                }, indent=2)
+            elif response.status_code == 429:
+                return json.dumps({
+                    "error": "rate_limit_exceeded", 
+                    "message": "Meta API rate limit exceeded",
+                    "details": {
+                        "suggestion": "Please wait before retrying",
+                        "retry_after": response.headers.get("Retry-After", "60")
+                    }
+                }, indent=2)
+            elif response.status_code == 502:
+                try:
+                    error_data = response.json()
+                    return json.dumps({
+                        "success": False,
+                        "error": "meta_api_error",
+                        "message": error_data.get("message", "Facebook API error"),
+                        "recoverable": True,
+                        "suggestion": "Please wait 5 minutes before retrying"
+                    }, indent=2)
+                except:
+                    return json.dumps({
+                        "success": False,
+                        "error": "meta_api_error",
+                        "message": "Facebook API error",
+                        "recoverable": True,
+                        "suggestion": "Please wait 5 minutes before retrying"
+                    }, indent=2)
+            else:
+                error_detail = response.text
+                try:
+                    error_json = response.json()
+                    error_detail = error_json.get("message", error_detail)
+                except:
+                    pass
+                
+                return json.dumps({
+                    "error": "duplication_failed",
+                    "message": f"Failed to duplicate {resource_type}",
+                    "details": {
+                        "status_code": response.status_code,
+                        "error_detail": error_detail,
+                        "resource_type": resource_type,
+                        "resource_id": resource_id
+                    }
+                }, indent=2)
+    
+    except httpx.TimeoutException:
+        return json.dumps({
+            "error": "request_timeout",
+            "message": "Request to duplication service timed out",
+            "details": {
+                "suggestion": "Please try again later",
+                "timeout": "30 seconds"
+            }
+        }, indent=2)
+    
+    except httpx.RequestError as e:
+        return json.dumps({
+            "error": "network_error", 
+            "message": "Failed to connect to duplication service",
+            "details": {
+                "error": str(e),
+                "suggestion": "Check your internet connection and try again"
+            }
+        }, indent=2)
+    
+    except Exception as e:
+        return json.dumps({
+            "error": "unexpected_error",
+            "message": f"Unexpected error during {resource_type} duplication",
+            "details": {
+                "error": str(e),
+                "resource_type": resource_type,
+                "resource_id": resource_id
+            }
+        }, indent=2)
+
+
+def _get_estimated_components(resource_type: str, options: Dict[str, Any]) -> Dict[str, Any]:
+    """Get estimated components that would be duplicated."""
+    if resource_type == "campaign":
+        components = {"campaigns": 1}
+        if options.get("include_ad_sets", True):
+            components["ad_sets"] = "3-5 (estimated)"
+        if options.get("include_ads", True):
+            components["ads"] = "5-15 (estimated)"
+        if options.get("include_creatives", True):
+            components["creatives"] = "5-15 (estimated)"
+        return components
+    elif resource_type == "adset":
+        components = {"ad_sets": 1}
+        if options.get("include_ads", True):
+            components["ads"] = "2-5 (estimated)"
+        if options.get("include_creatives", True):
+            components["creatives"] = "2-5 (estimated)"
+        return components
+    elif resource_type == "ad":
+        components = {"ads": 1}
+        if options.get("duplicate_creative", True):
+            components["creatives"] = 1
+        return components
+    elif resource_type == "creative":
+        return {"creatives": 1}
+    
+    return {} 

meta_ads_mcp/core/insights.py

@@ -56,374 +56,7 @@ async def get_insights(access_token: str = None, object_id: str = None,
     return json.dumps(data, indent=2)
 
 
-@mcp_server.tool()
-@meta_api_tool
-async def debug_image_download(access_token: str = None, url: str = "", ad_id: str = "") -> str:
-    """
-    Debug image download issues and report detailed diagnostics.
-    
-    Args:
-        access_token: Meta API access token (optional - will use cached token if not provided)
-        url: Direct image URL to test (optional)
-        ad_id: Meta Ads ad ID (optional, used if url is not provided)
-    """
-    results = {
-        "diagnostics": {
-            "timestamp": str(datetime.datetime.now()),
-            "methods_tried": [],
-            "request_details": [],
-            "network_info": {}
-        }
-    }
-    
-    # If no URL provided but ad_id is, get URL from ad creative
-    if not url and ad_id:
-        print(f"Getting image URL from ad creative for ad {ad_id}")
-        # Get the creative details
-        from .ads import get_ad_creatives
-        creative_json = await get_ad_creatives(ad_id=ad_id, access_token=access_token)
-        creative_data = json.loads(creative_json)
-        results["creative_data"] = creative_data
-        
-        # Look for image URL in the creative
-        if "full_image_url" in creative_data:
-            url = creative_data.get("full_image_url")
-        elif "thumbnail_url" in creative_data:
-            url = creative_data.get("thumbnail_url")
-    
-    if not url:
-        return json.dumps({
-            "error": "No image URL provided or found in ad creative",
-            "results": results
-        }, indent=2)
-    
-    results["image_url"] = url
-    
-    # Try to get network information to help debug
-    try:
-        import socket
-        from urllib.parse import urlparse
-        hostname = urlparse(url).netloc
-        ip_address = socket.gethostbyname(hostname)
-        results["diagnostics"]["network_info"] = {
-            "hostname": hostname,
-            "ip_address": ip_address,
-            "is_facebook_cdn": "fbcdn" in hostname
-        }
-    except Exception as e:
-        results["diagnostics"]["network_info"] = {
-            "error": str(e)
-        }
-    
-    # Method 1: Basic download
-    method_result = {
-        "method": "Basic download with standard headers",
-        "success": False
-    }
-    results["diagnostics"]["methods_tried"].append(method_result)
-    
-    try:
-        headers = {
-            "User-Agent": "curl/8.4.0"
-        }
-        import httpx
-        async with httpx.AsyncClient(follow_redirects=True) as client:
-            response = await client.get(url, headers=headers, timeout=30.0)
-            method_result["status_code"] = response.status_code
-            method_result["headers"] = dict(response.headers)
-            
-            if response.status_code == 200:
-                method_result["success"] = True
-                method_result["content_length"] = len(response.content)
-                method_result["content_type"] = response.headers.get("content-type")
-                
-                # Save this successful result
-                results["image_data"] = {
-                    "length": len(response.content),
-                    "type": response.headers.get("content-type"),
-                    "base64_sample": base64.b64encode(response.content[:100]).decode("utf-8") + "..." if response.content else None
-                }
-    except Exception as e:
-        method_result["error"] = str(e)
-    
-    # Method 2: Browser emulation
-    method_result = {
-        "method": "Browser emulation with cookies",
-        "success": False
-    }
-    results["diagnostics"]["methods_tried"].append(method_result)
-    
-    try:
-        headers = {
-            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
-            "Accept": "image/webp,image/apng,image/*,*/*;q=0.8",
-            "Accept-Language": "en-US,en;q=0.9",
-            "Referer": "https://www.facebook.com/",
-            "Cookie": "presence=EDvF3EtimeF1697900316EuserFA21B00112233445566AA0EstateFDutF0CEchF_7bCC"
-        }
-        
-        import httpx
-        async with httpx.AsyncClient(follow_redirects=True) as client:
-            response = await client.get(url, headers=headers, timeout=30.0)
-            method_result["status_code"] = response.status_code
-            method_result["headers"] = dict(response.headers)
-            
-            if response.status_code == 200:
-                method_result["success"] = True
-                method_result["content_length"] = len(response.content)
-                method_result["content_type"] = response.headers.get("content-type")
-                
-                # If first method didn't succeed, save this successful result
-                if "image_data" not in results:
-                    results["image_data"] = {
-                        "length": len(response.content),
-                        "type": response.headers.get("content-type"),
-                        "base64_sample": base64.b64encode(response.content[:100]).decode("utf-8") + "..." if response.content else None
-                    }
-    except Exception as e:
-        method_result["error"] = str(e)
-    
-    # Method 3: Graph API direct access (if applicable)
-    if "fbcdn" in url or "facebook" in url:
-        method_result = {
-            "method": "Graph API direct access",
-            "success": False
-        }
-        results["diagnostics"]["methods_tried"].append(method_result)
-        
-        try:
-            # Try to reconstruct the attachment ID from URL if possible
-            from urllib.parse import urlparse
-            url_parts = urlparse(url).path.split("/")
-            potential_ids = [part for part in url_parts if part.isdigit() and len(part) > 10]
-            
-            if potential_ids:
-                attachment_id = potential_ids[0]
-                endpoint = f"{attachment_id}?fields=url,width,height"
-                api_result = await make_api_request(endpoint, access_token)
-                
-                method_result["api_response"] = api_result
-                
-                if "url" in api_result:
-                    graph_url = api_result["url"]
-                    method_result["graph_url"] = graph_url
-                    
-                    # Try to download from this Graph API URL
-                    import httpx
-                    async with httpx.AsyncClient() as client:
-                        response = await client.get(graph_url, timeout=30.0)
-                        
-                        method_result["status_code"] = response.status_code
-                        if response.status_code == 200:
-                            method_result["success"] = True
-                            method_result["content_length"] = len(response.content)
-                            
-                            # If previous methods didn't succeed, save this successful result
-                            if "image_data" not in results:
-                                results["image_data"] = {
-                                    "length": len(response.content),
-                                    "type": response.headers.get("content-type"),
-                                    "base64_sample": base64.b64encode(response.content[:100]).decode("utf-8") + "..." if response.content else None
-                                }
-        except Exception as e:
-            method_result["error"] = str(e)
-    
-    # Generate a recommendation based on what we found
-    if "image_data" in results:
-        results["recommendation"] = "At least one download method succeeded. Consider implementing the successful method in the main code."
-    else:
-        # Check if the error appears to be access-related
-        access_errors = False
-        for method in results["diagnostics"]["methods_tried"]:
-            if method.get("status_code") in [401, 403, 503]:
-                access_errors = True
-                
-        if access_errors:
-            results["recommendation"] = "Authentication or authorization errors detected. Images may require direct Facebook authentication not possible via API."
-        else:
-            results["recommendation"] = "Network or other technical errors detected. Check URL expiration or CDN restrictions."
-    
-    return json.dumps(results, indent=2)
 
 
-@mcp_server.tool()
-@meta_api_tool
-async def save_ad_image_via_api(access_token: str = None, ad_id: str = None) -> str:
-    """
-    Try to save an ad image by using the Marketing API's attachment endpoints.
-    This is an alternative approach when direct image download fails.
-    
-    Args:
-        access_token: Meta API access token (optional - will use cached token if not provided)
-        ad_id: Meta Ads ad ID
-    """
-    if not ad_id:
-        return json.dumps({"error": "No ad ID provided"}, indent=2)
-        
-    # First get the ad's creative ID
-    endpoint = f"{ad_id}"
-    params = {
-        "fields": "creative,account_id"
-    }
-    
-    ad_data = await make_api_request(endpoint, access_token, params)
-    
-    if "error" in ad_data:
-        return json.dumps({
-            "error": "Could not get ad data",
-            "details": ad_data
-        }, indent=2)
-    
-    if "creative" not in ad_data or "id" not in ad_data["creative"]:
-        return json.dumps({
-            "error": "No creative ID found for this ad",
-            "ad_data": ad_data
-        }, indent=2)
-    
-    creative_id = ad_data["creative"]["id"]
-    account_id = ad_data.get("account_id", "")
-    
-    # Now get the creative object
-    creative_endpoint = f"{creative_id}"
-    creative_params = {
-        "fields": "id,name,thumbnail_url,image_hash,asset_feed_spec"
-    }
-    
-    creative_data = await make_api_request(creative_endpoint, access_token, creative_params)
-    
-    if "error" in creative_data:
-        return json.dumps({
-            "error": "Could not get creative data",
-            "details": creative_data
-        }, indent=2)
-    
-    # Approach 1: Try to get image through adimages endpoint if we have image_hash
-    image_hash = None
-    if "image_hash" in creative_data:
-        image_hash = creative_data["image_hash"]
-    elif "asset_feed_spec" in creative_data and "images" in creative_data["asset_feed_spec"] and len(creative_data["asset_feed_spec"]["images"]) > 0:
-        image_hash = creative_data["asset_feed_spec"]["images"][0].get("hash")
-    
-    result = {
-        "ad_id": ad_id,
-        "creative_id": creative_id,
-        "attempts": []
-    }
-    
-    if image_hash and account_id:
-        attempt = {
-            "method": "adimages endpoint with hash",
-            "success": False
-        }
-        result["attempts"].append(attempt)
-        
-        try:
-            image_endpoint = f"act_{account_id}/adimages"
-            image_params = {
-                "hashes": [image_hash]
-            }
-            image_data = await make_api_request(image_endpoint, access_token, image_params)
-            attempt["response"] = image_data
-            
-            if "data" in image_data and len(image_data["data"]) > 0 and "url" in image_data["data"][0]:
-                url = image_data["data"][0]["url"]
-                attempt["url"] = url
-                
-                # Try to download the image
-                image_bytes = await download_image(url)
-                if image_bytes:
-                    attempt["success"] = True
-                    attempt["image_size"] = len(image_bytes)
-                    
-                    # Save the image
-                    resource_id = f"ad_creative_{ad_id}_method1"
-                    resource_info = create_resource_from_image(
-                        image_bytes, 
-                        resource_id, 
-                        f"Ad Creative for {ad_id} (Method 1)"
-                    )
-                    
-                    # Return success with resource info
-                    result.update(resource_info)
-                    result["success"] = True
-                    base64_sample = base64.b64encode(image_bytes[:100]).decode("utf-8") + "..."
-                    result["base64_sample"] = base64_sample
-        except Exception as e:
-            attempt["error"] = str(e)
-    
-    # Approach 2: Try directly with the thumbnails endpoint
-    attempt = {
-        "method": "thumbnails endpoint on creative",
-        "success": False
-    }
-    result["attempts"].append(attempt)
-    
-    try:
-        thumbnails_endpoint = f"{creative_id}/thumbnails"
-        thumbnails_params = {}
-        thumbnails_data = await make_api_request(thumbnails_endpoint, access_token, thumbnails_params)
-        attempt["response"] = thumbnails_data
-        
-        if "data" in thumbnails_data and len(thumbnails_data["data"]) > 0:
-            for thumbnail in thumbnails_data["data"]:
-                if "uri" in thumbnail:
-                    url = thumbnail["uri"]
-                    attempt["url"] = url
-                    
-                    # Try to download the image
-                    image_bytes = await download_image(url)
-                    if image_bytes:
-                        attempt["success"] = True
-                        attempt["image_size"] = len(image_bytes)
-                        
-                        # Save the image if method 1 didn't already succeed
-                        if "success" not in result or not result["success"]:
-                            resource_id = f"ad_creative_{ad_id}_method2"
-                            resource_info = create_resource_from_image(
-                                image_bytes, 
-                                resource_id, 
-                                f"Ad Creative for {ad_id} (Method 2)"
-                            )
-                            
-                            # Return success with resource info
-                            result.update(resource_info)
-                            result["success"] = True
-                            base64_sample = base64.b64encode(image_bytes[:100]).decode("utf-8") + "..."
-                            result["base64_sample"] = base64_sample
-                        
-                        # No need to try more thumbnails if we succeeded
-                        break
-    except Exception as e:
-        attempt["error"] = str(e)
-    
-    # Approach 3: Try using the preview shareable link as an alternate source
-    attempt = {
-        "method": "preview_shareable_link",
-        "success": False
-    }
-    result["attempts"].append(attempt)
-    
-    try:
-        # Get ad details with preview link
-        ad_preview_endpoint = f"{ad_id}"
-        ad_preview_params = {
-            "fields": "preview_shareable_link"
-        }
-        ad_preview_data = await make_api_request(ad_preview_endpoint, access_token, ad_preview_params)
-        
-        if "preview_shareable_link" in ad_preview_data:
-            preview_link = ad_preview_data["preview_shareable_link"]
-            attempt["preview_link"] = preview_link
-            
-            # We can't directly download the preview image, but let's note it for manual inspection
-            attempt["note"] = "Preview link available for manual inspection in browser"
-    except Exception as e:
-        attempt["error"] = str(e)
-    
-    # Overall result
-    if "success" in result and result["success"]:
-        result["message"] = "Successfully retrieved ad image through one of the API methods"
-    else:
-        result["message"] = "Failed to retrieve ad image through any API method"
-        
-    return json.dumps(result, indent=2) 
+
+ 

{meta_ads_mcp-0.3.10.dist-info → meta_ads_mcp-0.4.1.dist-info}/METADATA

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.3.10
-Summary: Model Calling Protocol (MCP) plugin for interacting with Meta Ads API
+Version: 0.4.1
+Summary: Model Context Protocol (MCP) plugin for interacting with Meta Ads API
 Project-URL: Homepage, https://github.com/pipeboard-co/meta-ads-mcp
 Project-URL: Bug Tracker, https://github.com/pipeboard-co/meta-ads-mcp/issues
 Author-email: Yves Junqueira <yves.junqueira@gmail.com>
-License: MIT
+License: Apache-2.0
 License-File: LICENSE
 Keywords: ads,api,claude,facebook,mcp,meta
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
@@ -16,6 +16,8 @@ Requires-Dist: httpx>=0.26.0
 Requires-Dist: mcp[cli]>=1.10.1
 Requires-Dist: pathlib>=1.0.1
 Requires-Dist: pillow>=10.0.0
+Requires-Dist: pytest-asyncio>=1.0.0
+Requires-Dist: pytest>=8.4.1
 Requires-Dist: python-dateutil>=2.8.2
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: requests>=2.32.3
@@ -63,17 +65,14 @@ That's it! You can now ask Claude to analyze your Meta ad campaigns, get perform
 
 ### For Cursor Users
 
-Add this to your `~/.cursor/mcp.json`:
+Add the following to your `~/.cursor/mcp.json`. Once you enable the remote MCP, click on "Needs login" to finish the login process.
+
 
 ```json
 {
   "mcpServers": {
     "meta-ads-remote": {
-      "command": "npx",
-      "args": [
-        "mcp-remote",
-        "https://mcp.pipeboard.co/meta-ads-mcp"
-      ]
+      "url": "https://mcp.pipeboard.co/meta-ads-mcp"
     }
   }
 }
@@ -313,21 +312,13 @@ For local installation configuration, authentication options, and advanced techn
       - `level`: Level of aggregation (ad, adset, campaign, account)
     - Returns: Performance metrics for the specified object
 
-20. `mcp_meta_ads_debug_image_download`
-    - Debug image download issues and report detailed diagnostics
-    - Inputs:
-      - `access_token` (optional): Meta API access token (will use cached token if not provided)
-      - `url`: Direct image URL to test (optional)
-      - `ad_id`: Meta Ads ad ID (optional, used if url is not provided)
-    - Returns: Diagnostic information about image download attempts
-
-21. `mcp_meta_ads_get_login_link`
+20. `mcp_meta_ads_get_login_link`
     - Get a clickable login link for Meta Ads authentication
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
     - Returns: A clickable resource link for Meta authentication
 
-22. `mcp_meta-ads_create_budget_schedule`
+21. `mcp_meta-ads_create_budget_schedule`
     - Create a budget schedule for a Meta Ads campaign.
     - Inputs:
       - `campaign_id`: Meta Ads campaign ID.

{meta_ads_mcp-0.3.10.dist-info → meta_ads_mcp-0.4.1.dist-info}/RECORD

@@ -1,25 +1,26 @@
-meta_ads_mcp/__init__.py,sha256=eWjCQD9tlMl8HRDeUmrjlU0YxKfIjzyI00LB6SPO_VI,1237
+meta_ads_mcp/__init__.py,sha256=L28BjkKhMZJU54HlrDum5EOovTvkzo5jSvFDE_g8QJw,1182
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
-meta_ads_mcp/core/__init__.py,sha256=J9vO4rweKb9J-os2maiUy2R4gZGUH4bDSszLDqDCY6w,1174
+meta_ads_mcp/core/__init__.py,sha256=XVJjMOfdgnqxy3k8vCn2PCf7za8fMk4BdgJGiSFCVZY,1209
 meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
 meta_ads_mcp/core/ads.py,sha256=b_81GlGHIM4jISvuDZmHNyc6uW7uD3ovX68ezBci9MM,29747
 meta_ads_mcp/core/ads_library.py,sha256=onStn9UkRqYDC60gOPS-iKDtP1plz6DygUb7hUZ0Jw8,2807
-meta_ads_mcp/core/adsets.py,sha256=WBPNaI7ITnUOnGMus4_0MX15DslOCzfM5q1zF1VWs2s,12408
+meta_ads_mcp/core/adsets.py,sha256=8m8RDsa1CmCb75-YXcMHDYNpa8J12ovtQPp0kgYHDk4,12823
 meta_ads_mcp/core/api.py,sha256=aAzM6Q75VQOFXtr5D-mDmBRhxWK4wsiODsJYnR3mpDI,14994
-meta_ads_mcp/core/auth.py,sha256=pDARBh3NBNqCpxflVrVvR4VsWuIveFxQmb9-P-gLFDM,20730
-meta_ads_mcp/core/authentication.py,sha256=PFqmN7ujtNsJCEDutDzs81peGWFJ8_0YLYI3-o8kmt4,6577
+meta_ads_mcp/core/auth.py,sha256=z8HfLbDNB7IzoIcqt-lBGne6P97FF-dubO_cZNe5S_8,21425
+meta_ads_mcp/core/authentication.py,sha256=4CH2Fe3w7Al7YE2wgoa0DW5qOXTp_5Lsa4T6_Rh55s0,7048
 meta_ads_mcp/core/budget_schedules.py,sha256=UxseExsvKAiPwfDCY9aycT4kys4xqeNytyq-yyDOxrs,2901
-meta_ads_mcp/core/callback_server.py,sha256=AUymElaVwHqFyqB2wgqf6A68KsqwtKoYmY-7JZZt8Ks,43286
+meta_ads_mcp/core/callback_server.py,sha256=wNuxmj7YTFeSdVGi_iJ9vberNy3VdzBIP0uSsqn7g5Q,43888
 meta_ads_mcp/core/campaigns.py,sha256=Fd477GsD1Gx08Ve0uXUCvr4fC-xQCeVHPBwRVaeRQKk,10965
+meta_ads_mcp/core/duplication.py,sha256=o9vYczBCiF7bnRZBUGjI2ib06z44E7e7kvJM44jr83k,17052
 meta_ads_mcp/core/http_auth_integration.py,sha256=ZJHuxK1Kwtr9gvwfC5HZOLH5MW-HnDDKqJc4xuG5yVE,10060
-meta_ads_mcp/core/insights.py,sha256=XAm4uu83gWp84PEGqAJ3GFIqlvg7prh6MdD71JfvBCo,18072
+meta_ads_mcp/core/insights.py,sha256=U7KYdWQpGcdykE1WUtdJdYR3VTwKrXUzIzCREwWbf48,2599
 meta_ads_mcp/core/pipeboard_auth.py,sha256=VvbxEB8ZOhnMccLU7HI1HgaPWHCl5NGrzZCm-zzHze4,22798
 meta_ads_mcp/core/reports.py,sha256=Dv3hfsPOR7IZ9WrYrKd_6SNgZl-USIphg7knva3UYAw,5747
 meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0w,1236
 meta_ads_mcp/core/server.py,sha256=mmhtcyB7h1aO6jK4njLztPdAebPDmc3mhA7DksR1nlY,17583
 meta_ads_mcp/core/utils.py,sha256=DsizDYuJnWUpkbShV1y5Qe8t47Qf59aPZ6O9v0hzdkY,6705
-meta_ads_mcp-0.3.10.dist-info/METADATA,sha256=FVmGFp-HjIv-9Sev49l29O8Uk69aKVh20wCEAZ1uXlQ,17535
-meta_ads_mcp-0.3.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.3.10.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.3.10.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-meta_ads_mcp-0.3.10.dist-info/RECORD,,
+meta_ads_mcp-0.4.1.dist-info/METADATA,sha256=XFm8KEWGs0Ej4GQtppFW5kANqnO6URP2FkCJCUHxIH4,17239
+meta_ads_mcp-0.4.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.4.1.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.4.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+meta_ads_mcp-0.4.1.dist-info/RECORD,,