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

meta_ads_mcp/core/adsets.py

@@ -197,9 +197,10 @@ async def create_adset(
 @meta_api_tool
 async def update_adset(adset_id: str, frequency_control_specs: List[Dict[str, Any]] = None, bid_strategy: str = None, 
                         bid_amount: int = None, status: str = None, targeting: Dict[str, Any] = None, 
-                        optimization_goal: str = None, access_token: str = None) -> str:
+                        optimization_goal: str = None, daily_budget = None, lifetime_budget = None, 
+                        access_token: str = None) -> str:
     """
-    Update an ad set with new settings including frequency caps.
+    Update an ad set with new settings including frequency caps and budgets.
     
     Args:
         adset_id: Meta Ads ad set ID
@@ -211,6 +212,8 @@ async def update_adset(adset_id: str, frequency_control_specs: List[Dict[str, An
         targeting: Complete targeting specifications (will replace existing targeting)
                   (e.g. {"targeting_automation":{"advantage_audience":1}, "geo_locations": {"countries": ["US"]}})
         optimization_goal: Conversion optimization goal (e.g., 'LINK_CLICKS', 'CONVERSIONS', 'APP_INSTALLS', etc.)
+        daily_budget: Daily budget in account currency (in cents) as a string
+        lifetime_budget: Lifetime budget in account currency (in cents) as a string
         access_token: Meta API access token (optional - will use cached token if not provided)
     """
     if not adset_id:
@@ -240,6 +243,13 @@ async def update_adset(adset_id: str, frequency_control_specs: List[Dict[str, An
         else:
             params['targeting'] = targeting  # Already a string
     
+    # Add budget parameters if provided
+    if daily_budget is not None:
+        params['daily_budget'] = str(daily_budget)
+    
+    if lifetime_budget is not None:
+        params['lifetime_budget'] = str(lifetime_budget)
+    
     if not params:
         return json.dumps({"error": "No update parameters provided"}, indent=2)
 

meta_ads_mcp/core/campaigns.py

@@ -99,7 +99,8 @@ async def create_campaign(
     bid_cap = None,
     spend_cap = None,
     campaign_budget_optimization: bool = None,
-    ab_test_control_setups: Optional[List[Dict[str, Any]]] = None
+    ab_test_control_setups: Optional[List[Dict[str, Any]]] = None,
+    use_adset_level_budgets: bool = False
 ) -> str:
     """
     Create a new campaign in a Meta Ads account.
@@ -111,14 +112,15 @@ async def create_campaign(
         objective: Campaign objective. Validates ad objectives. enum{BRAND_AWARENESS, LEAD_GENERATION, LINK_CLICKS, CONVERSIONS, OUTCOME_TRAFFIC, etc.}.
         status: Initial campaign status (default: PAUSED)
         special_ad_categories: List of special ad categories if applicable
-        daily_budget: Daily budget in account currency (in cents) as a string
-        lifetime_budget: Lifetime budget in account currency (in cents) as a string
+        daily_budget: Daily budget in account currency (in cents) as a string (only used if use_adset_level_budgets=False)
+        lifetime_budget: Lifetime budget in account currency (in cents) as a string (only used if use_adset_level_budgets=False)
         buying_type: Buying type (e.g., 'AUCTION')
         bid_strategy: Bid strategy (e.g., 'LOWEST_COST', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP')
         bid_cap: Bid cap in account currency (in cents) as a string
         spend_cap: Spending limit for the campaign in account currency (in cents) as a string
-        campaign_budget_optimization: Whether to enable campaign budget optimization
+        campaign_budget_optimization: Whether to enable campaign budget optimization (only used if use_adset_level_budgets=False)
         ab_test_control_setups: Settings for A/B testing (e.g., [{"name":"Creative A", "ad_format":"SINGLE_IMAGE"}])
+        use_adset_level_budgets: If True, budgets will be set at the ad set level instead of campaign level (default: False)
     """
     # Check required parameters
     if not account_id:
@@ -134,8 +136,8 @@ async def create_campaign(
     if special_ad_categories is None:
         special_ad_categories = []
     
-    # For this example, we'll add a fixed daily budget if none is provided
-    if not daily_budget and not lifetime_budget:
+    # For this example, we'll add a fixed daily budget if none is provided and we're not using ad set level budgets
+    if not daily_budget and not lifetime_budget and not use_adset_level_budgets:
         daily_budget = "1000"  # Default to $10 USD
     
     endpoint = f"{account_id}/campaigns"
@@ -147,12 +149,17 @@ async def create_campaign(
         "special_ad_categories": json.dumps(special_ad_categories)  # Properly format as JSON string
     }
     
-    # Convert budget values to strings if they aren't already
-    if daily_budget is not None:
-        params["daily_budget"] = str(daily_budget)
-    
-    if lifetime_budget is not None:
-        params["lifetime_budget"] = str(lifetime_budget)
+    # Only set campaign-level budgets if we're not using ad set level budgets
+    if not use_adset_level_budgets:
+        # Convert budget values to strings if they aren't already
+        if daily_budget is not None:
+            params["daily_budget"] = str(daily_budget)
+        
+        if lifetime_budget is not None:
+            params["lifetime_budget"] = str(lifetime_budget)
+        
+        if campaign_budget_optimization is not None:
+            params["campaign_budget_optimization"] = "true" if campaign_budget_optimization else "false"
     
     # Add new parameters
     if buying_type:
@@ -167,14 +174,17 @@ async def create_campaign(
     if spend_cap is not None:
         params["spend_cap"] = str(spend_cap)
     
-    if campaign_budget_optimization is not None:
-        params["campaign_budget_optimization"] = "true" if campaign_budget_optimization else "false"
-    
     if ab_test_control_setups:
         params["ab_test_control_setups"] = json.dumps(ab_test_control_setups)
     
     try:
         data = await make_api_request(endpoint, access_token, params, method="POST")
+        
+        # Add a note about budget strategy if using ad set level budgets
+        if use_adset_level_budgets:
+            data["budget_strategy"] = "ad_set_level"
+            data["note"] = "Campaign created with ad set level budgets. Set budgets when creating ad sets within this campaign."
+        
         return json.dumps(data, indent=2)
     except Exception as e:
         error_msg = str(e)
@@ -200,7 +210,7 @@ async def update_campaign(
     spend_cap = None,
     campaign_budget_optimization: bool = None,
     objective: str = None,  # Add objective if it's updatable
-    # Add other updatable fields as needed based on API docs
+    use_adset_level_budgets: bool = None,  # Add other updatable fields as needed based on API docs
 ) -> str:
     """
     Update an existing campaign in a Meta Ads account.
@@ -211,13 +221,16 @@ async def update_campaign(
         name: New campaign name
         status: New campaign status (e.g., 'ACTIVE', 'PAUSED')
         special_ad_categories: List of special ad categories if applicable
-        daily_budget: New daily budget in account currency (in cents) as a string
-        lifetime_budget: New lifetime budget in account currency (in cents) as a string
+        daily_budget: New daily budget in account currency (in cents) as a string. 
+                     Set to empty string "" to remove the daily budget.
+        lifetime_budget: New lifetime budget in account currency (in cents) as a string.
+                        Set to empty string "" to remove the lifetime budget.
         bid_strategy: New bid strategy
         bid_cap: New bid cap in account currency (in cents) as a string
         spend_cap: New spending limit for the campaign in account currency (in cents) as a string
         campaign_budget_optimization: Enable/disable campaign budget optimization
         objective: New campaign objective (Note: May not always be updatable)
+        use_adset_level_budgets: If True, removes campaign-level budgets to switch to ad set level budgets
     """
     if not campaign_id:
         return json.dumps({"error": "No campaign ID provided"}, indent=2)
@@ -235,18 +248,52 @@ async def update_campaign(
         # Note: Updating special_ad_categories might have specific API rules or might not be allowed after creation.
         # The API might require an empty list `[]` to clear categories. Check Meta Docs.
         params["special_ad_categories"] = json.dumps(special_ad_categories)
-    if daily_budget is not None:
-        params["daily_budget"] = str(daily_budget)
-    if lifetime_budget is not None:
-        params["lifetime_budget"] = str(lifetime_budget)
+    
+    # Handle budget parameters based on use_adset_level_budgets setting
+    if use_adset_level_budgets is not None:
+        if use_adset_level_budgets:
+            # Remove campaign-level budgets when switching to ad set level budgets
+            params["daily_budget"] = ""
+            params["lifetime_budget"] = ""
+            if campaign_budget_optimization is not None:
+                params["campaign_budget_optimization"] = "false"
+        else:
+            # If switching back to campaign-level budgets, use the provided budget values
+            if daily_budget is not None:
+                if daily_budget == "":
+                    params["daily_budget"] = ""
+                else:
+                    params["daily_budget"] = str(daily_budget)
+            if lifetime_budget is not None:
+                if lifetime_budget == "":
+                    params["lifetime_budget"] = ""
+                else:
+                    params["lifetime_budget"] = str(lifetime_budget)
+            if campaign_budget_optimization is not None:
+                params["campaign_budget_optimization"] = "true" if campaign_budget_optimization else "false"
+    else:
+        # Normal budget updates when not changing budget strategy
+        if daily_budget is not None:
+            # To remove budget, set to empty string
+            if daily_budget == "":
+                params["daily_budget"] = ""
+            else:
+                params["daily_budget"] = str(daily_budget)
+        if lifetime_budget is not None:
+            # To remove budget, set to empty string
+            if lifetime_budget == "":
+                params["lifetime_budget"] = ""
+            else:
+                params["lifetime_budget"] = str(lifetime_budget)
+        if campaign_budget_optimization is not None:
+            params["campaign_budget_optimization"] = "true" if campaign_budget_optimization else "false"
+    
     if bid_strategy is not None:
         params["bid_strategy"] = bid_strategy
     if bid_cap is not None:
         params["bid_cap"] = str(bid_cap)
     if spend_cap is not None:
         params["spend_cap"] = str(spend_cap)
-    if campaign_budget_optimization is not None:
-        params["campaign_budget_optimization"] = "true" if campaign_budget_optimization else "false"
     if objective is not None:
         params["objective"] = objective # Caution: Objective changes might reset learning or be restricted
 
@@ -256,6 +303,12 @@ async def update_campaign(
     try:
         # Use POST method for updates as per Meta API documentation
         data = await make_api_request(endpoint, access_token, params, method="POST")
+        
+        # Add a note about budget strategy if switching to ad set level budgets
+        if use_adset_level_budgets is not None and use_adset_level_budgets:
+            data["budget_strategy"] = "ad_set_level"
+            data["note"] = "Campaign updated to use ad set level budgets. Set budgets when creating ad sets within this campaign."
+        
         return json.dumps(data, indent=2)
     except Exception as e:
         error_msg = str(e)

{meta_ads_mcp-0.7.4.dist-info → meta_ads_mcp-0.7.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.7.4
+Version: 0.7.5
 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.4.dist-info → meta_ads_mcp-0.7.5.dist-info}/RECORD

@@ -1,16 +1,16 @@
-meta_ads_mcp/__init__.py,sha256=XkpYmz9AJW4fNUpFbmjA5x8uc6GMNViW00QLu8V8Szg,1492
+meta_ads_mcp/__init__.py,sha256=6q-iZb-0TjRTI3Pz2mdCt8mGubBzhZbdVUCT601s5KY,1492
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=6nYdue6yRepkt6JTAoPGhGbS51qfDSvmczRrDwYOG6A,1709
 meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
 meta_ads_mcp/core/ads.py,sha256=aaK70mgfhBJRXr4cdkKag5mjYzvHuHpRttJvTMzPk4Y,36156
 meta_ads_mcp/core/ads_library.py,sha256=BBGVbtjO5eFV42iiY3XPU-wIV8HupzUKpHgPBrydSvU,3232
-meta_ads_mcp/core/adsets.py,sha256=k76rm3rkhEebUzvBnM_QaVktrzGTKvTJOtWbBd6s3i8,10399
+meta_ads_mcp/core/adsets.py,sha256=yyOS5k_DPlwZERJmzUf3UBVwvE9KsA9E9gdMyHP2ZBY,10870
 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=-AJxa3a5ZshRCvmJThBaNwCAJ1D2_qOgUkvu539c_MY,10159
 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
+meta_ads_mcp/core/campaigns.py,sha256=0yDVgi7rN4eMQk1_w0A2vnoXd8y0t8R77Ji4gna1Gj4,14030
 meta_ads_mcp/core/duplication.py,sha256=UUmTDFx9o5ZsPQG2Rb9c4ZyuKUVN3FfTjebfTIHHdo4,18984
 meta_ads_mcp/core/http_auth_integration.py,sha256=lGpKhfzJcyWugBcYEvypY-qnlt-3UDBLqh7xAUH0DGw,12473
 meta_ads_mcp/core/insights.py,sha256=U7KYdWQpGcdykE1WUtdJdYR3VTwKrXUzIzCREwWbf48,2599
@@ -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.4.dist-info/METADATA,sha256=75EtK9cnzHONG6EdNPmxplIc2nML8lp_Yxh4AGn7n7I,20409
-meta_ads_mcp-0.7.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.7.4.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.7.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-meta_ads_mcp-0.7.4.dist-info/RECORD,,
+meta_ads_mcp-0.7.5.dist-info/METADATA,sha256=42uw2yEhgxLqqHEOhAqgiPqfwNYvLjR6qL7rzGYTaAk,20409
+meta_ads_mcp-0.7.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.7.5.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.7.5.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+meta_ads_mcp-0.7.5.dist-info/RECORD,,