meta-ads-mcp 1.0.18__py3-none-any.whl → 1.0.19__py3-none-any.whl

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__ = "1.0.18"
+__version__ = "1.0.19"
 
 __all__ = [
     'get_ad_accounts',

meta_ads_mcp/core/insights.py

@@ -1,7 +1,7 @@
 """Insights and Reporting functionality for Meta Ads API."""
 
 import json
-from typing import Optional, Union, Dict
+from typing import Optional, Union, Dict, List
 from .api import meta_api_tool, make_api_request
 from .utils import download_image, try_multiple_download_methods, ad_creative_images, create_resource_from_image
 from .server import mcp_server
@@ -11,9 +11,10 @@ import datetime
 
 @mcp_server.tool()
 @meta_api_tool
-async def get_insights(object_id: str, access_token: Optional[str] = None, 
-                      time_range: Union[str, Dict[str, str]] = "maximum", breakdown: str = "", 
-                      level: str = "ad", limit: int = 25, after: str = "") -> str:
+async def get_insights(object_id: str, access_token: Optional[str] = None,
+                      time_range: Union[str, Dict[str, str]] = "maximum", breakdown: str = "",
+                      level: str = "ad", limit: int = 25, after: str = "",
+                      action_attribution_windows: Optional[List[str]] = None) -> str:
     """
     Get performance insights for a campaign, ad set, ad or account.
     
@@ -51,6 +52,8 @@ async def get_insights(object_id: str, access_token: Optional[str] = None,
         level: Level of aggregation (ad, adset, campaign, account)
         limit: Maximum number of results to return per page (default: 25, Meta API allows much higher values)
         after: Pagination cursor to get the next set of results. Use the 'after' cursor from previous response's paging.next field.
+        action_attribution_windows: Optional list of attribution windows (e.g., ["1d_click", "7d_click", "1d_view"]).
+                   When specified, actions include additional fields for each window. The 'value' field always shows 7d_click.
     """
     if not object_id:
         return json.dumps({"error": "No object ID provided"}, indent=2)
@@ -78,7 +81,11 @@ async def get_insights(object_id: str, access_token: Optional[str] = None,
     
     if after:
         params["after"] = after
-    
+
+    if action_attribution_windows:
+        # Meta API expects single-quote format: ['1d_click','7d_click']
+        params["action_attribution_windows"] = "[" + ",".join(f"'{w}'" for w in action_attribution_windows) + "]"
+
     data = await make_api_request(endpoint, access_token, params)
     
     return json.dumps(data, indent=2)

{meta_ads_mcp-1.0.18.dist-info → meta_ads_mcp-1.0.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 1.0.18
+Version: 1.0.19
 Summary: Model Context Protocol (MCP) server for Meta Ads - Use Remote MCP at pipeboard.co for easiest setup
 Project-URL: Homepage, https://github.com/pipeboard-co/meta-ads-mcp
 Project-URL: Bug Tracker, https://github.com/pipeboard-co/meta-ads-mcp/issues
@@ -389,6 +389,7 @@ For advanced users who need to self-host, the package can be installed from sour
       - `time_range`: Time range for insights (default: maximum)
       - `breakdown`: Optional breakdown dimension (e.g., age, gender, country)
       - `level`: Level of aggregation (ad, adset, campaign, account)
+      - `action_attribution_windows` (optional): List of attribution windows for conversion data (e.g., ["1d_click", "1d_view", "7d_click", "7d_view"]). When specified, actions and cost_per_action_type include additional fields for each window. The 'value' field always shows 7d_click attribution.
     - Returns: Performance metrics for the specified object
 
 21. `mcp_meta_ads_get_login_link`

{meta_ads_mcp-1.0.18.dist-info → meta_ads_mcp-1.0.19.dist-info}/RECORD

@@ -1,4 +1,4 @@
-meta_ads_mcp/__init__.py,sha256=qVIccqA3rZtJUEMjPcFLKFUhyRlnAJyTyP4l29VklAU,1477
+meta_ads_mcp/__init__.py,sha256=QKpjlX8Hak6GzWWCCr6SgEhYodi7KO13fY2MwjG4Fiw,1477
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=IEJtqpyUo0CZSUWeQPljQ-D2vKorTFwXnpBQWSi1hIM,1819
 meta_ads_mcp/core/accounts.py,sha256=7Zoqq0zMIJi_Xsxe9-_b3EYx-UTeieJJvO7HxVRuUS0,4327
@@ -13,7 +13,7 @@ meta_ads_mcp/core/callback_server.py,sha256=LIAJv9DW--83kdZ7VWWZal8xEprYjRZ8iug4
 meta_ads_mcp/core/campaigns.py,sha256=LKo5B8hNUUmfVQ1iu88o8HoU9ixOlGS9lwmPu6x9keA,15604
 meta_ads_mcp/core/duplication.py,sha256=pJ41pI9bIxNf21TSy6KkpcUsc3aSr4KIiO__sunNoq0,18909
 meta_ads_mcp/core/http_auth_integration.py,sha256=lGpKhfzJcyWugBcYEvypY-qnlt-3UDBLqh7xAUH0DGw,12473
-meta_ads_mcp/core/insights.py,sha256=ogSGlC0ddh8RFzWydilfDc7GYnjtInFiEQS7cSoyTmw,5061
+meta_ads_mcp/core/insights.py,sha256=eN9jVMyoA0CaJ76x8GZZfwJOdMvs25U4RjJUrzznFPU,5606
 meta_ads_mcp/core/openai_deep_research.py,sha256=68ayGopnBSPEYhN9R1sFvTXtyWtM0lji9aWS3uSXnLY,18649
 meta_ads_mcp/core/pipeboard_auth.py,sha256=vv0yc4RBcGOm7VOovud-QNV1JmvBF-njOKICzAOlyf0,24602
 meta_ads_mcp/core/reports.py,sha256=2pXYCCjYc3MZ8GlrbSHND436W62WlbfbtMll1dfJdqE,5750
@@ -21,8 +21,8 @@ meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0
 meta_ads_mcp/core/server.py,sha256=9SlgM_qvdlxo24ctnZzLgW1e1nfAspCSx3YyJQkKP64,17856
 meta_ads_mcp/core/targeting.py,sha256=d2uLWbIEtucRuTgwZEdtVKLDZJgaxQ1lDtZ0ZgkBJC4,25150
 meta_ads_mcp/core/utils.py,sha256=ytj41yC5SqduLrAiZYBSd6OUwlJRaIClTwnnYKpNFds,9387
-meta_ads_mcp-1.0.18.dist-info/METADATA,sha256=9Dyns9X9nMyMP-ZCMWpFuk6lckX7ApqIAJIfIiYY_vs,24903
-meta_ads_mcp-1.0.18.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-meta_ads_mcp-1.0.18.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-1.0.18.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
-meta_ads_mcp-1.0.18.dist-info/RECORD,,
+meta_ads_mcp-1.0.19.dist-info/METADATA,sha256=-mvAWil32XHGK0c-3j0vSv4RZQ85x9nmfxK_5SHhLnY,25201
+meta_ads_mcp-1.0.19.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+meta_ads_mcp-1.0.19.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-1.0.19.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
+meta_ads_mcp-1.0.19.dist-info/RECORD,,