meta-ads-mcp 0.3.10__tar.gz → 0.4.1__tar.gz

{meta_ads_mcp-0.3.10 → meta_ads_mcp-0.4.1}/PKG-INFO

@@ -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 → meta_ads_mcp-0.4.1}/README.md

@@ -40,17 +40,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"
     }
   }
 }
@@ -290,21 +287,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 → meta_ads_mcp-0.4.1}/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-0.3.10 → meta_ads_mcp-0.4.1}/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-0.3.10 → meta_ads_mcp-0.4.1}/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-0.3.10 → meta_ads_mcp-0.4.1}/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-0.3.10 → meta_ads_mcp-0.4.1}/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-0.3.10 → meta_ads_mcp-0.4.1}/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: