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

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.1.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.1
+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,27 @@ 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). This means:
+
+### ✅ **What you CAN do:**
+- ✅ **Use for free** - Individual and business use at no cost
+- ✅ **Modify and customize** - Edit the source code for your needs
+- ✅ **Internal commercial use** - Deploy within your organization
+- ✅ **Redistribute** - Share the software with others
+- ✅ **Create derivative works** - Build upon the codebase
+
+### ❌ **What you CANNOT do:**
+- ❌ **Offer as competing SaaS** - Cannot offer this as a hosted service that competes with ARTELL SOLUÇÕES TECNOLÓGICAS LTDA's commercial offerings
+
+### 🔄 **Future Open Source:**
+- **Change Date**: January 1, 2029
+- **After Change Date**: Automatically converts to Apache License 2.0 (fully open source)
+- **No restrictions**: After the change date, you can use it for any purpose, including competing services
+
+This licensing model ensures the software remains accessible while protecting the commercial interests of the original developers. For questions about commercial licensing or use cases, 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.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-meta_ads_mcp/__init__.py,sha256=uvrVKnD7HOZFoWkYorYCRee5o1AtfuZVeuInAgfhasY,1501
+meta_ads_mcp/__init__.py,sha256=NcUILH869PO9ngH3GGyHrneWdfYgIZrNj0mS8xDl2XA,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
@@ -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.1.dist-info/METADATA,sha256=W8LOtQAabMdRFbQ-2Htd3uslAwgxI1cqjbmIwms_b6w,23562
+meta_ads_mcp-0.10.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.10.1.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.10.1.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
+meta_ads_mcp-0.10.1.dist-info/RECORD,,