meta-ads-mcp 0.7.0__py3-none-any.whl → 0.7.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.7.0"
+__version__ = "0.7.1"
 
 __all__ = [
     'get_ad_accounts',

meta_ads_mcp/core/authentication.py

@@ -1,4 +1,27 @@
-"""Authentication-specific functionality for Meta Ads API."""
+"""Authentication-specific functionality for Meta Ads API.
+
+The Meta Ads MCP server supports three authentication modes:
+
+1. **Development/Local Mode** (default)
+   - Uses local callback server on localhost:8080+ for OAuth redirect
+   - Requires META_ADS_DISABLE_CALLBACK_SERVER to NOT be set
+   - Best for local development and testing
+
+2. **Production with API Token** 
+   - Uses PIPEBOARD_API_TOKEN for server-to-server authentication
+   - Bypasses OAuth flow entirely
+   - Best for server deployments with pre-configured tokens
+
+3. **Production OAuth Flow** (NEW)
+   - Uses Pipeboard OAuth endpoints for dynamic client registration
+   - Triggered when META_ADS_DISABLE_CALLBACK_SERVER is set but no PIPEBOARD_API_TOKEN
+   - Supports MCP clients that implement OAuth 2.0 discovery
+
+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)
+"""
 
 import json
 import asyncio
@@ -27,41 +50,49 @@ async def get_login_link(access_token: str = None) -> str:
     """
     # Check if we're using pipeboard authentication
     using_pipeboard = bool(os.environ.get("PIPEBOARD_API_TOKEN", ""))
+    callback_server_disabled = bool(os.environ.get("META_ADS_DISABLE_CALLBACK_SERVER", ""))
     
     if using_pipeboard:
-        # Handle Pipeboard authentication
-        # Check if we have a cached token
-        cached_token = pipeboard_auth_manager.get_access_token()
-        token_status = "No token" if not cached_token else "Valid token"
-        
-        # If we already have a valid token and none was provided, just return success
-        if cached_token and not access_token:
-            logger.info("get_login_link called with existing valid Pipeboard token")
-            return json.dumps({
-                "message": "Already authenticated with Pipeboard",
-                "token_status": token_status,
-                "token_preview": cached_token[:10] + "..." if cached_token else None,
-                "authentication_method": "pipeboard"
-            }, indent=2)
-        
-        # Initiate the auth flow via Pipeboard
+        # Pipeboard token-based authentication
         try:
-            auth_data = pipeboard_auth_manager.initiate_auth_flow()
-            login_url = auth_data.get("loginUrl")
+            logger.info("Using Pipeboard token-based authentication")
             
-            # Return a special format that helps the LLM format the response properly
-            response = {
-                "login_url": login_url,
-                "token_status": token_status,
-                "markdown_link": f"[Click here to authenticate with Meta Ads via Pipeboard]({login_url})",
-                "message": "IMPORTANT: Please use the Markdown link format in your response to allow the user to click it.",
-                "instructions_for_llm": "You must present this link as clickable Markdown to the user using the markdown_link format provided.",
-                "authentication_method": "pipeboard",
-                "token_duration": "Approximately 60 days",
-                "note": "After authenticating, the token will be automatically saved."
-            }
+            # If an access token was provided, this is likely a test - return success
+            if access_token:
+                return json.dumps({
+                    "message": "Manual token provided",
+                    "token_status": "Provided token",
+                    "authentication_method": "manual_token"
+                }, indent=2)
+            
+            # Check if Pipeboard token is working
+            token = pipeboard_auth_manager.get_access_token()
+            if token:
+                return json.dumps({
+                    "message": "Already authenticated via Pipeboard",
+                    "token_status": "Valid Pipeboard token",
+                    "authentication_method": "pipeboard_token"
+                }, indent=2)
             
-            return json.dumps(response, indent=2)
+            # Start Pipeboard auth flow
+            auth_data = pipeboard_auth_manager.initiate_auth_flow()
+            login_url = auth_data.get('loginUrl')
+            
+            if login_url:
+                return json.dumps({
+                    "login_url": login_url,
+                    "markdown_link": f"[Click here to authenticate with Meta Ads via Pipeboard]({login_url})",
+                    "message": "IMPORTANT: Please use the Markdown link format in your response to allow the user to click it.",
+                    "instructions_for_llm": "You must present this link as clickable Markdown to the user using the markdown_link format provided.",
+                    "authentication_method": "pipeboard_oauth",
+                    "note": "After authenticating, the token will be automatically retrieved from Pipeboard."
+                }, indent=2)
+            else:
+                return json.dumps({
+                    "error": "No login URL received from Pipeboard",
+                    "authentication_method": "pipeboard_oauth_failed"
+                }, indent=2)
+                
         except Exception as e:
             logger.error(f"Error initiating Pipeboard auth flow: {e}")
             return json.dumps({
@@ -69,8 +100,22 @@ async def get_login_link(access_token: str = None) -> str:
                 "message": "Please check your PIPEBOARD_API_TOKEN environment variable.",
                 "authentication_method": "pipeboard"
             }, indent=2)
+    elif callback_server_disabled:
+        # Production OAuth flow - use Pipeboard OAuth endpoints directly
+        logger.info("Production OAuth flow - using Pipeboard OAuth endpoints")
+        
+        return json.dumps({
+            "authorization_endpoint": "https://pipeboard.co/oauth/authorize", 
+            "token_endpoint": "https://pipeboard.co/oauth/token",
+            "registration_endpoint": "https://pipeboard.co/oauth/register",
+            "discovery_endpoint": "/.well-known/oauth-authorization-server",
+            "message": "Production OAuth flow - use dynamic client registration",
+            "instructions": "MCP clients should use the OAuth discovery endpoint to get authorization URLs",
+            "authentication_method": "production_oauth",
+            "note": "For manual authentication, clients need to register with Pipeboard OAuth service first"
+        }, indent=2)
     else:
-        # Original Meta authentication flow
+        # Original Meta authentication flow (development/local)
         # Check if we have a cached token
         cached_token = auth_manager.get_access_token()
         token_status = "No token" if not cached_token else "Valid token"

{meta_ads_mcp-0.7.0.dist-info → meta_ads_mcp-0.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.7.0
+Version: 0.7.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

{meta_ads_mcp-0.7.0.dist-info → meta_ads_mcp-0.7.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-meta_ads_mcp/__init__.py,sha256=UDuLAO7mGVeZrzSJhTr3UAJKug3oHb6IK6OjooX6fk8,1492
+meta_ads_mcp/__init__.py,sha256=NX5qdfpot2sNJBbh373KM5xNYIYBL3Wq_rNQz9Dop1M,1492
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=IHBUfLTQW44VLbH_gZDT83nqzGrVWZ0l7FG4P3bp_bU,1706
 meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
@@ -7,7 +7,7 @@ meta_ads_mcp/core/ads_library.py,sha256=onStn9UkRqYDC60gOPS-iKDtP1plz6DygUb7hUZ0
 meta_ads_mcp/core/adsets.py,sha256=k76rm3rkhEebUzvBnM_QaVktrzGTKvTJOtWbBd6s3i8,10399
 meta_ads_mcp/core/api.py,sha256=aAzM6Q75VQOFXtr5D-mDmBRhxWK4wsiODsJYnR3mpDI,14994
 meta_ads_mcp/core/auth.py,sha256=H-0s0O2fLo14rmi81Hh5S64pyRl1HS7dm9Q_8UCa3Jg,21622
-meta_ads_mcp/core/authentication.py,sha256=4CH2Fe3w7Al7YE2wgoa0DW5qOXTp_5Lsa4T6_Rh55s0,7048
+meta_ads_mcp/core/authentication.py,sha256=K_LqL1NHtgVlO4aHsnXqHc9zrH9jMmuPpREZBO4KVss,9205
 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=Fd477GsD1Gx08Ve0uXUCvr4fC-xQCeVHPBwRVaeRQKk,10965
@@ -21,8 +21,8 @@ meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0
 meta_ads_mcp/core/server.py,sha256=WhbAag7xdhbGcp7rnU4sKhqXJ8Slapa_ba3T23Yp_2U,17889
 meta_ads_mcp/core/targeting.py,sha256=3HW1qirEdwaQurlBZGenbIwawcb5J06ghJKRfgu9ZEs,6318
 meta_ads_mcp/core/utils.py,sha256=ofKUhyo-5SZoJVuBeTVFPPQCffk0UKpwmDMrd8qQxNc,8715
-meta_ads_mcp-0.7.0.dist-info/METADATA,sha256=ADo7W0ulgt6gIZzJjOkyxM-PDqE0inab-THLjsStoGo,20409
-meta_ads_mcp-0.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.7.0.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.7.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-meta_ads_mcp-0.7.0.dist-info/RECORD,,
+meta_ads_mcp-0.7.1.dist-info/METADATA,sha256=6H5Wclw8Xg2KH3UYh4VphwFDQGgZVq2pDdXClqannjg,20409
+meta_ads_mcp-0.7.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.7.1.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.7.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+meta_ads_mcp-0.7.1.dist-info/RECORD,,