meta-ads-mcp 0.11.1__tar.gz → 0.11.3__tar.gz

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.11.1
+Version: 0.11.3
 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
@@ -13,7 +13,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.26.0
-Requires-Dist: mcp[cli]<=1.12.2,>=1.10.1
+Requires-Dist: mcp[cli]==1.12.2
 Requires-Dist: pathlib>=1.0.1
 Requires-Dist: pillow>=10.0.0
 Requires-Dist: pytest-asyncio>=1.0.0
@@ -371,16 +371,16 @@ For local installation configuration, authentication options, and advanced techn
       - `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`
-    - Create a budget schedule for a Meta Ads campaign.
+22. `mcp_meta_ads_create_budget_schedule`
+    - Create a budget schedule for a Meta Ads campaign
     - Inputs:
-      - `campaign_id`: Meta Ads campaign ID.
-      - `budget_value`: Amount of budget increase.
-      - `budget_value_type`: Type of budget value ("ABSOLUTE" or "MULTIPLIER").
-      - `time_start`: Unix timestamp for when the high demand period should start.
-      - `time_end`: Unix timestamp for when the high demand period should end.
-      - `access_token` (optional): Meta API access token.
-    - Returns: JSON string with the ID of the created budget schedule or an error message.
+      - `campaign_id`: Meta Ads campaign ID
+      - `budget_value`: Amount of budget increase
+      - `budget_value_type`: Type of budget value ("ABSOLUTE" or "MULTIPLIER")
+      - `time_start`: Unix timestamp for when the high demand period should start
+      - `time_end`: Unix timestamp for when the high demand period should end
+      - `access_token` (optional): Meta API access token
+    - Returns: JSON string with the ID of the created budget schedule or an error message
 
 23. `mcp_meta_ads_search_interests`
     - Search for interest targeting options by keyword
@@ -398,7 +398,7 @@ For local installation configuration, authentication options, and advanced techn
       - `limit`: Maximum number of suggestions to return (default: 25)
     - Returns: Suggested interests with id, name, audience_size, and description fields
 
-24. `mcp_meta_ads_validate_interests`
+25. `mcp_meta_ads_validate_interests`
     - Validate interest names or IDs for targeting
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
@@ -406,14 +406,14 @@ For local installation configuration, authentication options, and advanced techn
       - `interest_fbid_list`: List of interest IDs to validate (e.g., ["6003700426513"])
     - Returns: Validation results showing valid status and audience_size for each interest
 
-25. `mcp_meta_ads_search_behaviors`
+26. `mcp_meta_ads_search_behaviors`
     - Get all available behavior targeting options
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
       - `limit`: Maximum number of results to return (default: 50)
     - Returns: Behavior targeting options with id, name, audience_size bounds, path, and description
 
-26. `mcp_meta_ads_search_demographics`
+27. `mcp_meta_ads_search_demographics`
     - Get demographic targeting options
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
@@ -421,7 +421,7 @@ For local installation configuration, authentication options, and advanced techn
       - `limit`: Maximum number of results to return (default: 50)
     - Returns: Demographic targeting options with id, name, audience_size bounds, path, and description
 
-27. `mcp_meta_ads_search_geo_locations`
+28. `mcp_meta_ads_search_geo_locations`
     - Search for geographic targeting locations
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
@@ -430,7 +430,7 @@ For local installation configuration, authentication options, and advanced techn
       - `limit`: Maximum number of results to return (default: 25)
     - Returns: Location data with key, name, type, and geographic hierarchy information
 
-28. `mcp_meta_ads_search` (Enhanced)
+29. `mcp_meta_ads_search` (Enhanced)
     - Generic search across accounts, campaigns, ads, and pages
     - Automatically includes page searching when query mentions "page" or "pages"
     - Inputs:
@@ -479,7 +479,7 @@ The easiest way to avoid any setup issues is to **[🎯 use our Remote MCP inste
 For comprehensive troubleshooting, debugging, and local installation issues, see our **[Local Installation Guide](LOCAL_INSTALLATION.md)** which includes:
 
 - Authentication troubleshooting
-- Installation issues and solutions  
+- Installation issues and solutions
 - API error resolution
 - Debug logs and diagnostic commands
-- Performance optimization tips 
+- Performance optimization tips

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/README.md

@@ -346,16 +346,16 @@ For local installation configuration, authentication options, and advanced techn
       - `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`
-    - Create a budget schedule for a Meta Ads campaign.
+22. `mcp_meta_ads_create_budget_schedule`
+    - Create a budget schedule for a Meta Ads campaign
     - Inputs:
-      - `campaign_id`: Meta Ads campaign ID.
-      - `budget_value`: Amount of budget increase.
-      - `budget_value_type`: Type of budget value ("ABSOLUTE" or "MULTIPLIER").
-      - `time_start`: Unix timestamp for when the high demand period should start.
-      - `time_end`: Unix timestamp for when the high demand period should end.
-      - `access_token` (optional): Meta API access token.
-    - Returns: JSON string with the ID of the created budget schedule or an error message.
+      - `campaign_id`: Meta Ads campaign ID
+      - `budget_value`: Amount of budget increase
+      - `budget_value_type`: Type of budget value ("ABSOLUTE" or "MULTIPLIER")
+      - `time_start`: Unix timestamp for when the high demand period should start
+      - `time_end`: Unix timestamp for when the high demand period should end
+      - `access_token` (optional): Meta API access token
+    - Returns: JSON string with the ID of the created budget schedule or an error message
 
 23. `mcp_meta_ads_search_interests`
     - Search for interest targeting options by keyword
@@ -373,7 +373,7 @@ For local installation configuration, authentication options, and advanced techn
       - `limit`: Maximum number of suggestions to return (default: 25)
     - Returns: Suggested interests with id, name, audience_size, and description fields
 
-24. `mcp_meta_ads_validate_interests`
+25. `mcp_meta_ads_validate_interests`
     - Validate interest names or IDs for targeting
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
@@ -381,14 +381,14 @@ For local installation configuration, authentication options, and advanced techn
       - `interest_fbid_list`: List of interest IDs to validate (e.g., ["6003700426513"])
     - Returns: Validation results showing valid status and audience_size for each interest
 
-25. `mcp_meta_ads_search_behaviors`
+26. `mcp_meta_ads_search_behaviors`
     - Get all available behavior targeting options
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
       - `limit`: Maximum number of results to return (default: 50)
     - Returns: Behavior targeting options with id, name, audience_size bounds, path, and description
 
-26. `mcp_meta_ads_search_demographics`
+27. `mcp_meta_ads_search_demographics`
     - Get demographic targeting options
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
@@ -396,7 +396,7 @@ For local installation configuration, authentication options, and advanced techn
       - `limit`: Maximum number of results to return (default: 50)
     - Returns: Demographic targeting options with id, name, audience_size bounds, path, and description
 
-27. `mcp_meta_ads_search_geo_locations`
+28. `mcp_meta_ads_search_geo_locations`
     - Search for geographic targeting locations
     - Inputs:
       - `access_token` (optional): Meta API access token (will use cached token if not provided)
@@ -405,7 +405,7 @@ For local installation configuration, authentication options, and advanced techn
       - `limit`: Maximum number of results to return (default: 25)
     - Returns: Location data with key, name, type, and geographic hierarchy information
 
-28. `mcp_meta_ads_search` (Enhanced)
+29. `mcp_meta_ads_search` (Enhanced)
     - Generic search across accounts, campaigns, ads, and pages
     - Automatically includes page searching when query mentions "page" or "pages"
     - Inputs:
@@ -454,7 +454,7 @@ The easiest way to avoid any setup issues is to **[🎯 use our Remote MCP inste
 For comprehensive troubleshooting, debugging, and local installation issues, see our **[Local Installation Guide](LOCAL_INSTALLATION.md)** which includes:
 
 - Authentication troubleshooting
-- Installation issues and solutions  
+- Installation issues and solutions
 - API error resolution
 - Debug logs and diagnostic commands
-- Performance optimization tips 
+- Performance optimization tips

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/meta_ads_mcp/__init__.py

@@ -6,7 +6,7 @@ This package provides a Meta Ads MCP integration
 
 from meta_ads_mcp.core.server import main
 
-__version__ = "0.11.1"
+__version__ = "0.11.3"
 
 __all__ = [
     'get_ad_accounts',

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/meta_ads_mcp/core/ads.py

@@ -111,6 +111,10 @@ async def create_ad(
         tracking_specs: Optional tracking specifications (e.g., for pixel events).
                       Example: [{"action.type":"offsite_conversion","fb_pixel":["YOUR_PIXEL_ID"]}]
         access_token: Meta API access token (optional - will use cached token if not provided)
+
+    Note:
+        Dynamic Creative creatives require the parent ad set to have `is_dynamic_creative=true`.
+        Otherwise, ad creation will fail with error_subcode 1885998.
     """
     # Check required parameters
     if not account_id:

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/meta_ads_mcp/core/adsets.py

@@ -27,14 +27,14 @@ async def get_adsets(account_id: str, access_token: Optional[str] = None, limit:
     if campaign_id:
         endpoint = f"{campaign_id}/adsets"
         params = {
-            "fields": "id,name,campaign_id,status,daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,frequency_control_specs{event,interval_days,max_frequency}",
+            "fields": "id,name,campaign_id,status,daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,is_dynamic_creative,frequency_control_specs{event,interval_days,max_frequency}",
             "limit": limit
         }
     else:
         # Use account endpoint if no campaign_id is given
         endpoint = f"{account_id}/adsets"
         params = {
-            "fields": "id,name,campaign_id,status,daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,frequency_control_specs{event,interval_days,max_frequency}",
+            "fields": "id,name,campaign_id,status,daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,is_dynamic_creative,frequency_control_specs{event,interval_days,max_frequency}",
             "limit": limit
         }
         # Note: Removed the attempt to add campaign_id to params for the account endpoint case, 
@@ -67,7 +67,7 @@ async def get_adset_details(adset_id: str, access_token: Optional[str] = None) -
     endpoint = f"{adset_id}"
     # Explicitly prioritize frequency_control_specs in the fields request
     params = {
-        "fields": "id,name,campaign_id,status,frequency_control_specs{event,interval_days,max_frequency},daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,attribution_spec,destination_type,promoted_object,pacing_type,budget_remaining,dsa_beneficiary"
+        "fields": "id,name,campaign_id,status,frequency_control_specs{event,interval_days,max_frequency},daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,attribution_spec,destination_type,promoted_object,pacing_type,budget_remaining,dsa_beneficiary,is_dynamic_creative"
     }
     
     data = await make_api_request(endpoint, access_token, params)
@@ -100,6 +100,7 @@ async def create_adset(
     dsa_beneficiary: Optional[str] = None,
     promoted_object: Optional[Dict[str, Any]] = None,
     destination_type: Optional[str] = None,
+    is_dynamic_creative: Optional[bool] = None,
     access_token: Optional[str] = None
 ) -> str:
     """
@@ -125,8 +126,9 @@ async def create_adset(
                         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', '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.
+                          Required for mobile app campaigns and lead generation campaigns.
+                          Use 'ON_AD' for lead generation campaigns where user interaction happens within the ad.
+        is_dynamic_creative: Enable Dynamic Creative for this ad set (required when using dynamic creatives with asset_feed_spec/dynamic_creative_spec).
         access_token: Meta API access token (optional - will use cached token if not provided)
     """
     # Check required parameters
@@ -249,6 +251,10 @@ async def create_adset(
     if destination_type:
         params["destination_type"] = destination_type
     
+    # Enable Dynamic Creative if requested
+    if is_dynamic_creative is not None:
+        params["is_dynamic_creative"] = "true" if bool(is_dynamic_creative) else "false"
+    
     try:
         data = await make_api_request(endpoint, access_token, params, method="POST")
         return json.dumps(data, indent=2)
@@ -290,6 +296,7 @@ async def create_adset(
 async def update_adset(adset_id: str, frequency_control_specs: Optional[List[Dict[str, Any]]] = None, bid_strategy: Optional[str] = None, 
                         bid_amount: Optional[int] = None, status: Optional[str] = None, targeting: Optional[Dict[str, Any]] = None, 
                         optimization_goal: Optional[str] = None, daily_budget: Optional[int] = None, lifetime_budget: Optional[int] = None, 
+                        is_dynamic_creative: Optional[bool] = None,
                         access_token: Optional[str] = None) -> str:
     """
     Update an ad set with new settings including frequency caps and budgets.
@@ -306,6 +313,7 @@ async def update_adset(adset_id: str, frequency_control_specs: Optional[List[Dic
         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
+        is_dynamic_creative: Enable/disable Dynamic Creative for this ad set.
         access_token: Meta API access token (optional - will use cached token if not provided)
     """
     if not adset_id:
@@ -342,6 +350,9 @@ async def update_adset(adset_id: str, frequency_control_specs: Optional[List[Dic
     if lifetime_budget is not None:
         params['lifetime_budget'] = str(lifetime_budget)
     
+    if is_dynamic_creative is not None:
+        params['is_dynamic_creative'] = "true" if bool(is_dynamic_creative) else "false"
+    
     if not params:
         return json.dumps({"error": "No update parameters provided"}, indent=2)
 

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "meta-ads-mcp"
-version = "0.11.1"
+version = "0.11.3"
 description = "Model Context Protocol (MCP) server for interacting with Meta Ads API"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -20,7 +20,7 @@ classifiers = [
 ]
 dependencies = [
     "httpx>=0.26.0",
-    "mcp[cli]>=1.10.1,<=1.12.2",
+    "mcp[cli]==1.12.2",
     "python-dotenv>=1.1.0",
     "requests>=2.32.3",
     "Pillow>=10.0.0",

{meta_ads_mcp-0.11.1 → meta_ads_mcp-0.11.3}/requirements.txt

@@ -1,5 +1,5 @@
 httpx>=0.26.0
-mcp[cli]>=1.10.1
+mcp[cli]==1.12.2
 python-dotenv>=1.1.0
 requests>=2.32.3
 Pillow>=10.0.0

meta_ads_mcp-0.11.3/tests/test_is_dynamic_creative_adset.py

@@ -0,0 +1,77 @@
+import json
+import pytest
+from unittest.mock import AsyncMock, patch
+
+from meta_ads_mcp.core.adsets import create_adset, update_adset, get_adsets, get_adset_details
+
+
+@pytest.mark.asyncio
+async def test_create_adset_includes_is_dynamic_creative_true():
+    sample_response = {"id": "adset_1", "name": "DC Adset"}
+    with patch('meta_ads_mcp.core.adsets.make_api_request', new_callable=AsyncMock) as mock_api:
+        mock_api.return_value = sample_response
+
+        result = await create_adset(
+            account_id="act_123",
+            campaign_id="cmp_1",
+            name="DC Adset",
+            optimization_goal="LINK_CLICKS",
+            billing_event="IMPRESSIONS",
+            targeting={"geo_locations": {"countries": ["US"]}},
+            is_dynamic_creative=True,
+            access_token="test_token",
+        )
+
+        assert json.loads(result)["id"] == "adset_1"
+        # Verify param was sent as string boolean
+        call_args = mock_api.call_args
+        params = call_args[0][2]
+        assert params["is_dynamic_creative"] == "true"
+
+
+@pytest.mark.asyncio
+async def test_update_adset_includes_is_dynamic_creative_false():
+    sample_response = {"success": True}
+    with patch('meta_ads_mcp.core.adsets.make_api_request', new_callable=AsyncMock) as mock_api:
+        mock_api.return_value = sample_response
+
+        result = await update_adset(
+            adset_id="120",
+            is_dynamic_creative=False,
+            access_token="test_token",
+        )
+
+        assert json.loads(result)["success"] is True
+        call_args = mock_api.call_args
+        params = call_args[0][2]
+        assert params["is_dynamic_creative"] == "false"
+
+
+@pytest.mark.asyncio
+async def test_get_adsets_fields_include_is_dynamic_creative():
+    sample_response = {"data": []}
+    with patch('meta_ads_mcp.core.adsets.make_api_request', new_callable=AsyncMock) as mock_api:
+        mock_api.return_value = sample_response
+
+        result = await get_adsets(account_id="act_123", access_token="test_token", limit=1)
+        assert json.loads(result)["data"] == []
+
+        call_args = mock_api.call_args
+        params = call_args[0][2]
+        assert "is_dynamic_creative" in params.get("fields", "")
+
+
+@pytest.mark.asyncio
+async def test_get_adset_details_fields_include_is_dynamic_creative():
+    sample_response = {"id": "120", "name": "Test", "is_dynamic_creative": True}
+    with patch('meta_ads_mcp.core.adsets.make_api_request', new_callable=AsyncMock) as mock_api:
+        mock_api.return_value = sample_response
+
+        result = await get_adset_details(adset_id="120", access_token="test_token")
+        assert json.loads(result)["id"] == "120"
+
+        call_args = mock_api.call_args
+        params = call_args[0][2]
+        assert "is_dynamic_creative" in params.get("fields", "")
+
+