meta-ads-mcp 0.10.2__py3-none-any.whl → 0.10.6__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.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/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/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/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.dist-info → meta_ads_mcp-0.10.6.dist-info}/METADATA

@@ -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.dist-info → meta_ads_mcp-0.10.6.dist-info}/RECORD

@@ -1,13 +1,13 @@
-meta_ads_mcp/__init__.py,sha256=EYdsc6GoKV3a2tDxk_X9rDEokwvdfMK-jAA60i0jgPQ,1501
+meta_ads_mcp/__init__.py,sha256=8og8MsMkiqUF5xVV3Xh0Oo33QyX-hvW82NXkSDOePwk,1525
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
-meta_ads_mcp/core/__init__.py,sha256=v1k95keVnIx_-npUsb7ppSJ0DvdLQgySpf6xBwob_Lc,1717
+meta_ads_mcp/core/__init__.py,sha256=IEJtqpyUo0CZSUWeQPljQ-D2vKorTFwXnpBQWSi1hIM,1819
 meta_ads_mcp/core/accounts.py,sha256=0lfyvRbhBigFKgNq5Mk3fk4Qh6MtIkKScdOnoc_rQkg,4314
-meta_ads_mcp/core/ads.py,sha256=3UpoktML-5hJ_k2u5KOk3-VcFe_goz531jLi6-qJhqU,54929
+meta_ads_mcp/core/ads.py,sha256=i7smFJSOm2DtQts1vXLt5y6q6uZE9paoKx58W4zToFo,57308
 meta_ads_mcp/core/ads_library.py,sha256=BBGVbtjO5eFV42iiY3XPU-wIV8HupzUKpHgPBrydSvU,3232
 meta_ads_mcp/core/adsets.py,sha256=kfggH1F2KD19iPDErE0QdKw2aVX7F409EPLDTM7MKnQ,16024
 meta_ads_mcp/core/api.py,sha256=kWpIafvSsxnesfb5TqndA7ozKoIspby5e_6Jl23L7hY,16447
 meta_ads_mcp/core/auth.py,sha256=2CjFbxpJM3OR3OzCipB8l_-l2xQ1nioGfdI3ZDMnjHM,23629
-meta_ads_mcp/core/authentication.py,sha256=-AJxa3a5ZshRCvmJThBaNwCAJ1D2_qOgUkvu539c_MY,10159
+meta_ads_mcp/core/authentication.py,sha256=o5YMW0xmoTDiXDmpgVPo4mYSxCil6aGMQHbIeHxj_kg,10509
 meta_ads_mcp/core/budget_schedules.py,sha256=UxseExsvKAiPwfDCY9aycT4kys4xqeNytyq-yyDOxrs,2901
 meta_ads_mcp/core/callback_server.py,sha256=LIAJv9DW--83kdZ7VWWZal8xEprYjRZ8iug4rMczYbQ,9372
 meta_ads_mcp/core/campaigns.py,sha256=0yDVgi7rN4eMQk1_w0A2vnoXd8y0t8R77Ji4gna1Gj4,14030
@@ -21,8 +21,8 @@ meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0
 meta_ads_mcp/core/server.py,sha256=9SlgM_qvdlxo24ctnZzLgW1e1nfAspCSx3YyJQkKP64,17856
 meta_ads_mcp/core/targeting.py,sha256=nl_JVXNhCu85ho5ssklZiQYC3iL_oosdlpEuyCOVXcM,13824
 meta_ads_mcp/core/utils.py,sha256=ytj41yC5SqduLrAiZYBSd6OUwlJRaIClTwnnYKpNFds,9387
-meta_ads_mcp-0.10.2.dist-info/METADATA,sha256=xeSFuAjk99sc6cYIS7KVUCGwUZiLxc5lNWKc8vBsCok,22904
-meta_ads_mcp-0.10.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.10.2.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.10.2.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
-meta_ads_mcp-0.10.2.dist-info/RECORD,,
+meta_ads_mcp-0.10.6.dist-info/METADATA,sha256=_uXqJzjafHyiOQSPntzqWhAVOcnp2xQ6hd9xmiNqXoc,22904
+meta_ads_mcp-0.10.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.10.6.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.10.6.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
+meta_ads_mcp-0.10.6.dist-info/RECORD,,