meta-ads-mcp 0.10.2__tar.gz → 0.10.6__tar.gz

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/LOCAL_INSTALLATION.md

@@ -480,7 +480,7 @@ If you're still experiencing issues:
 
 1. **Check the logs** for detailed error messages
 2. **Search existing issues** on GitHub
-3. **Join our Discord** at [discord.gg/hNxpJcqM52](https://discord.gg/hNxpJcqM52)
+3. **Join our Discord** at [discord.gg/YNjF7gUb5h](https://discord.gg/YNjF7gUb5h)
 4. **Email support** at info@pipeboard.co
 5. **Consider Remote MCP** at [pipeboard.co](https://pipeboard.co) as an alternative
 

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.10.2
+Version: 0.10.6
 Summary: Model Context Protocol (MCP) server 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
@@ -33,7 +33,7 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for in
 
 ## Community & Support
 
-- [Discord](https://discord.gg/hNxpJcqM52). Join the community.
+- [Discord](https://discord.gg/YNjF7gUb5h). Join the community.
 - [Email Support](info@pipeboard.co). Email us for support.
 
 ## Table of Contents

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/README.md

@@ -8,7 +8,7 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for in
 
 ## Community & Support
 
-- [Discord](https://discord.gg/hNxpJcqM52). Join the community.
+- [Discord](https://discord.gg/YNjF7gUb5h). Join the community.
 - [Email Support](info@pipeboard.co). Email us for support.
 
 ## Table of Contents

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/meta_ads_mcp/__init__.py

@@ -7,7 +7,7 @@ with the Claude LLM.
 
 from meta_ads_mcp.core.server import main
 
-__version__ = "0.10.2"
+__version__ = "0.10.6"
 
 __all__ = [
     'get_ad_accounts',
@@ -24,7 +24,7 @@ __all__ = [
     'get_ad_image',
     'update_ad',
     'get_insights',
-    'get_login_link',
+    # 'get_login_link' is conditionally exported via core.__all__
     'login_cli',
     'main',
     'search_interests',
@@ -51,7 +51,6 @@ from .core import (
     get_ad_image,
     update_ad,
     get_insights,
-    get_login_link,
     login_cli,
     main,
     search_interests,

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/meta_ads_mcp/core/__init__.py

@@ -6,7 +6,7 @@ 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
-from .authentication import get_login_link
+from . import authentication  # Import module to register conditional auth tools
 from .server import login_cli, main
 from .auth import login
 from . import ads_library  # Import module to register conditional tools
@@ -32,7 +32,7 @@ __all__ = [
     'get_ad_image',
     'update_ad',
     'get_insights',
-    'get_login_link',
+    # Note: 'get_login_link' is registered conditionally by the authentication module
     'login_cli',
     'login',
     'main',

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/meta_ads_mcp/core/ads.py

@@ -564,7 +564,8 @@ async def update_ad(
 async def upload_ad_image(
     access_token: str = None,
     account_id: str = None,
-    image_path: str = None,
+    file: str = None,
+    image_url: str = None,
     name: str = None
 ) -> str:
     """
@@ -573,7 +574,8 @@ async def upload_ad_image(
     Args:
         access_token: Meta API access token (optional - will use cached token if not provided)
         account_id: Meta Ads account ID (format: act_XXXXXXXXX)
-        image_path: Path to the image file to upload
+        file: Data URL or raw base64 string of the image (e.g., "data:image/png;base64,iVBORw0KG...")
+        image_url: Direct URL to an image to fetch and upload
         name: Optional name for the image (default: filename)
     
     Returns:
@@ -583,45 +585,94 @@ async def upload_ad_image(
     if not account_id:
         return json.dumps({"error": "No account ID provided"}, indent=2)
     
-    if not image_path:
-        return json.dumps({"error": "No image path provided"}, indent=2)
+    # Ensure we have image data
+    if not file and not image_url:
+        return json.dumps({"error": "Provide either 'file' (data URL or base64) or 'image_url'"}, indent=2)
     
     # Ensure account_id has the 'act_' prefix for API compatibility
     if not account_id.startswith("act_"):
         account_id = f"act_{account_id}"
     
-    # Check if image file exists
-    if not os.path.exists(image_path):
-        return json.dumps({"error": f"Image file not found: {image_path}"}, indent=2)
-    
     try:
-        # Read image file
-        with open(image_path, "rb") as img_file:
-            image_bytes = img_file.read()
-        
-        # Get image filename if name not provided
-        if not name:
-            name = os.path.basename(image_path)
-        
+        # Determine encoded_image (base64 string without data URL prefix) and a sensible name
+        encoded_image: str = ""
+        inferred_name: str = name or ""
+
+        if file:
+            # Support data URL (e.g., data:image/png;base64,...) and raw base64
+            data_url_prefix = "data:"
+            base64_marker = "base64,"
+            if file.startswith(data_url_prefix) and base64_marker in file:
+                header, base64_payload = file.split(base64_marker, 1)
+                encoded_image = base64_payload.strip()
+
+                # Infer file extension from MIME type if name not provided
+                if not inferred_name:
+                    # Example header: data:image/png;...
+                    mime_type = header[len(data_url_prefix):].split(";")[0].strip()
+                    extension_map = {
+                        "image/png": ".png",
+                        "image/jpeg": ".jpg",
+                        "image/jpg": ".jpg",
+                        "image/webp": ".webp",
+                        "image/gif": ".gif",
+                        "image/bmp": ".bmp",
+                        "image/tiff": ".tiff",
+                    }
+                    ext = extension_map.get(mime_type, ".png")
+                    inferred_name = f"upload{ext}"
+            else:
+                # Assume it's already raw base64
+                encoded_image = file.strip()
+                if not inferred_name:
+                    inferred_name = "upload.png"
+        else:
+            # Download image from URL
+            try:
+                image_bytes = await try_multiple_download_methods(image_url)
+            except Exception as download_error:
+                return json.dumps({
+                    "error": "Failed to download image from URL",
+                    "details": str(download_error),
+                    "image_url": image_url,
+                }, indent=2)
+
+            if not image_bytes:
+                return json.dumps({
+                    "error": "No data returned when downloading image from URL",
+                    "image_url": image_url,
+                }, indent=2)
+
+            import base64  # Local import
+            encoded_image = base64.b64encode(image_bytes).decode("utf-8")
+
+            # Infer name from URL if not provided
+            if not inferred_name:
+                try:
+                    path_no_query = image_url.split("?")[0]
+                    filename_from_url = os.path.basename(path_no_query)
+                    inferred_name = filename_from_url if filename_from_url else "upload.jpg"
+                except Exception:
+                    inferred_name = "upload.jpg"
+
+        # Final name resolution
+        final_name = name or inferred_name or "upload.png"
+
         # Prepare the API endpoint for uploading images
         endpoint = f"{account_id}/adimages"
-        
-        # We need to convert the binary data to base64 for API upload
-        import base64
-        encoded_image = base64.b64encode(image_bytes).decode('utf-8')
-        
-        # Prepare POST parameters
+
+        # Prepare POST parameters expected by Meta API
         params = {
             "bytes": encoded_image,
-            "name": name
+            "name": final_name,
         }
-        
+
         # Make API request to upload the image
         print(f"Uploading image to Facebook Ad Account {account_id}")
         data = await make_api_request(endpoint, access_token, params, method="POST")
-        
+
         return json.dumps(data, indent=2)
-    
+
     except Exception as e:
         return json.dumps({
             "error": "Failed to upload image",

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/meta_ads_mcp/core/authentication.py

@@ -21,6 +21,7 @@ Environment Variables:
 - PIPEBOARD_API_TOKEN: Enables mode 2 (token-based auth)  
 - META_ADS_DISABLE_CALLBACK_SERVER: Disables local server, enables mode 3
 - META_ACCESS_TOKEN: Direct Meta token (fallback)
+- META_ADS_DISABLE_LOGIN_LINK: Hard-disables the get_login_link tool; returns a disabled message
 """
 
 import json
@@ -32,8 +33,10 @@ from .server import mcp_server
 from .utils import logger, META_APP_SECRET
 from .pipeboard_auth import pipeboard_auth_manager
 
+# Only register the login link tool if not explicitly disabled
+ENABLE_LOGIN_LINK = not bool(os.environ.get("META_ADS_DISABLE_LOGIN_LINK", ""))
+
 
-@mcp_server.tool()
 async def get_login_link(access_token: str = None) -> str:
     """
     Get a clickable login link for Meta Ads authentication.
@@ -195,4 +198,8 @@ async def get_login_link(access_token: str = None) -> str:
         # Wait a moment to ensure the server is fully started
         await asyncio.sleep(1)
         
-        return json.dumps(response, indent=2) 
+    return json.dumps(response, indent=2)
+
+# Conditionally register as MCP tool only when enabled
+if ENABLE_LOGIN_LINK:
+    get_login_link = mcp_server.tool()(get_login_link)

{meta_ads_mcp-0.10.2 → meta_ads_mcp-0.10.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "meta-ads-mcp"
-version = "0.10.2"
+version = "0.10.6"
 description = "Model Context Protocol (MCP) server for interacting with Meta Ads API"
 readme = "README.md"
 requires-python = ">=3.10"