meta-ads-mcp 0.10.0__py3-none-any.whl → 0.10.2__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.0"
+__version__ = "0.10.2"
 
 __all__ = [
     'get_ad_accounts',

meta_ads_mcp/core/adsets.py

@@ -130,8 +130,9 @@ async def create_adset(
         promoted_object: Mobile app configuration for APP_INSTALLS campaigns. Required fields: application_id, object_store_url.
                         Optional fields: custom_event_type, pixel_id, page_id.
                         Example: {"application_id": "123456789012345", "object_store_url": "https://apps.apple.com/app/id123456789"}
-        destination_type: Where users are directed after clicking the ad (e.g., 'APP_STORE', 'DEEPLINK', 'APP_INSTALL').
-                         Required for mobile app campaigns.
+        destination_type: Where users are directed after clicking the ad (e.g., 'APP_STORE', 'DEEPLINK', 'APP_INSTALL', 'ON_AD').
+                         Required for mobile app campaigns and lead generation campaigns.
+                         Use 'ON_AD' for lead generation campaigns where user interaction happens within the ad.
         access_token: Meta API access token (optional - will use cached token if not provided)
     """
     # Check required parameters
@@ -196,7 +197,7 @@ async def create_adset(
     
     # Validate destination_type if provided
     if destination_type:
-        valid_destination_types = ["APP_STORE", "DEEPLINK", "APP_INSTALL"]
+        valid_destination_types = ["APP_STORE", "DEEPLINK", "APP_INSTALL", "ON_AD"]
         if destination_type not in valid_destination_types:
             return json.dumps({
                 "error": f"Invalid destination_type: {destination_type}",

meta_ads_mcp/core/targeting.py

@@ -147,27 +147,16 @@ async def estimate_audience_size(
             }
         }, indent=2)
     
-    # Build delivery estimate request
-    endpoint = f"{account_id}/delivery_estimate"
+    # Build reach estimate request (using correct Meta API endpoint)
+    endpoint = f"{account_id}/reachestimate"
     params = {
-        "targeting": targeting,
-        "optimization_goal": optimization_goal
+        "targeting_spec": targeting
     }
     
-    # Add basic campaign parameters for estimation
-    if optimization_goal == "REACH":
-        params["objective"] = "REACH"
-    elif optimization_goal in ["LINK_CLICKS", "LANDING_PAGE_VIEWS"]:
-        params["objective"] = "TRAFFIC"
-    elif optimization_goal == "CONVERSIONS":
-        params["objective"] = "CONVERSIONS"
-    elif optimization_goal == "APP_INSTALLS":
-        params["objective"] = "APP_INSTALLS"
-    else:
-        params["objective"] = "REACH"  # Default fallback
+    # Note: reachestimate endpoint doesn't support optimization_goal or objective parameters
     
     try:
-        data = await make_api_request(endpoint, access_token, params, method="POST")
+        data = await make_api_request(endpoint, access_token, params, method="GET")
         
         # Format the response for easier consumption
         if "data" in data and len(data["data"]) > 0:
@@ -191,14 +180,69 @@ async def estimate_audience_size(
         else:
             return json.dumps({
                 "error": "No estimation data returned from Meta API",
-                "raw_response": data
+                "raw_response": data,
+                "debug_info": {
+                    "response_keys": list(data.keys()) if isinstance(data, dict) else "not_a_dict",
+                    "response_type": str(type(data)),
+                    "endpoint_used": f"{account_id}/reachestimate"
+                }
             }, indent=2)
     
     except Exception as e:
-        return json.dumps({
-            "error": f"Failed to get audience estimation: {str(e)}",
-            "details": "Check targeting parameters and account permissions"
-        }, indent=2)
+        # Check if this is the specific Business Manager system user permission error
+        error_str = str(e)
+        if "100" in error_str and "33" in error_str:
+            # Try to provide fallback estimation using individual interests if available
+            interests_found = []
+            if targeting and "interests" in targeting:
+                interests_found.extend([interest.get("id") for interest in targeting["interests"] if interest.get("id")])
+            elif targeting and "flexible_spec" in targeting:
+                for spec in targeting["flexible_spec"]:
+                    if "interests" in spec:
+                        interests_found.extend([interest.get("id") for interest in spec["interests"] if interest.get("id")])
+            
+            if interests_found:
+                # Attempt to get individual interest data as fallback
+                try:
+                    fallback_result = await estimate_audience_size(
+                        access_token=access_token,
+                        interest_fbid_list=interests_found
+                    )
+                    fallback_data = json.loads(fallback_result)
+                    
+                    return json.dumps({
+                        "comprehensive_targeting_failed": True,
+                        "error_code": "100-33",
+                        "fallback_used": True,
+                        "details": {
+                            "issue": "reachestimate endpoint returned error - possibly due to targeting parameters or account limitations",
+                            "solution": "Individual interest validation used as fallback - comprehensive targeting may have specific requirements",
+                            "endpoint_used": f"{account_id}/reachestimate"
+                        },
+                        "individual_interest_data": fallback_data,
+                        "note": "Individual interest audience sizes provided as fallback. Comprehensive targeting via reachestimate endpoint failed."
+                    }, indent=2)
+                except:
+                    pass
+            
+            return json.dumps({
+                "error": "reachestimate endpoint returned error (previously was incorrectly using delivery_estimate)",
+                "error_code": "100-33", 
+                "details": {
+                    "issue": "The endpoint returned an error, possibly due to targeting parameters or account limitations",
+                    "endpoint_used": f"{account_id}/reachestimate",
+                    "previous_issue": "Code was previously using non-existent delivery_estimate endpoint - now fixed",
+                    "available_alternative": "Use interest_list or interest_fbid_list parameters for individual interest validation"
+                },
+                "raw_error": error_str
+            }, indent=2)
+        else:
+            return json.dumps({
+                "error": f"Failed to get audience estimation from reachestimate endpoint: {str(e)}",
+                "details": "Check targeting parameters and account permissions",
+                "error_type": "general_api_error",
+                "endpoint_used": f"{account_id}/reachestimate"
+            }, indent=2)
 
 
 @mcp_server.tool()

{meta_ads_mcp-0.10.0.dist-info → meta_ads_mcp-0.10.2.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.10.0
-Summary: Model Context Protocol (MCP) plugin for interacting with Meta Ads API
+Version: 0.10.2
+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
 Author-email: Yves Junqueira <yves.junqueira@gmail.com>
@@ -43,6 +43,7 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for in
 - [Features](#features)
 - [Configuration](#configuration)
 - [Available MCP Tools](#available-mcp-tools)
+- [Licensing](#licensing)
 - [Privacy and Security](#privacy-and-security)
 - [Testing](#testing)
 - [Troubleshooting](#troubleshooting)
@@ -407,6 +408,17 @@ For local installation configuration, authentication options, and advanced techn
       - `query`: Search query string (e.g., "Injury Payouts pages", "active campaigns")
     - Returns: List of matching record IDs in ChatGPT-compatible format
 
+## Licensing
+
+Meta Ads MCP is licensed under the [Business Source License 1.1](LICENSE), which means:
+
+- ✅ **Free to use** for individual and business purposes
+- ✅ **Modify and customize** as needed
+- ✅ **Redistribute** to others
+- ✅ **Becomes fully open source** (Apache 2.0) on January 1, 2029
+
+The only restriction is that you cannot offer this as a competing hosted service. For questions about commercial licensing, please contact us.
+
 ## Privacy and Security
 
 Meta Ads MCP follows security best practices with secure token management and automatic authentication handling. 

{meta_ads_mcp-0.10.0.dist-info → meta_ads_mcp-0.10.2.dist-info}/RECORD

@@ -1,10 +1,10 @@
-meta_ads_mcp/__init__.py,sha256=uvrVKnD7HOZFoWkYorYCRee5o1AtfuZVeuInAgfhasY,1501
+meta_ads_mcp/__init__.py,sha256=EYdsc6GoKV3a2tDxk_X9rDEokwvdfMK-jAA60i0jgPQ,1501
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=v1k95keVnIx_-npUsb7ppSJ0DvdLQgySpf6xBwob_Lc,1717
 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_library.py,sha256=BBGVbtjO5eFV42iiY3XPU-wIV8HupzUKpHgPBrydSvU,3232
-meta_ads_mcp/core/adsets.py,sha256=mqB7u-6HY3QHSQo-zStan7IBjksdcvzcyOC_wVXFvJY,15863
+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
@@ -19,10 +19,10 @@ meta_ads_mcp/core/pipeboard_auth.py,sha256=ZwEQy8r0TwobFRQ5gmlSjhIfvlUmMtfWNlpQj
 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=9SlgM_qvdlxo24ctnZzLgW1e1nfAspCSx3YyJQkKP64,17856
-meta_ads_mcp/core/targeting.py,sha256=AHnAG166cfnw52A1llkmEyJiA8XC291m6dRt4_uXxR4,10928
+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.0.dist-info/METADATA,sha256=IyTlSSBcyJf1Pf8u7HN7GyGHKaY6J1VeiTFJyC_7XNc,22429
-meta_ads_mcp-0.10.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.10.0.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.10.0.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
-meta_ads_mcp-0.10.0.dist-info/RECORD,,
+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,,