meta-ads-mcp 0.11.2__tar.gz → 0.11.4__tar.gz

{meta_ads_mcp-0.11.2 → meta_ads_mcp-0.11.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.11.2
+Version: 0.11.4
 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.2 → meta_ads_mcp-0.11.4}/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.2 → meta_ads_mcp-0.11.4}/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.2"
+__version__ = "0.11.4"
 
 __all__ = [
     'get_ad_accounts',

{meta_ads_mcp-0.11.2 → meta_ads_mcp-0.11.4}/meta_ads_mcp/core/ads.py

@@ -635,15 +635,27 @@ async def upload_ad_image(
                 image_bytes = await try_multiple_download_methods(image_url)
             except Exception as download_error:
                 return json.dumps({
-                    "error": "Failed to download image from URL",
-                    "details": str(download_error),
+                    "error": "We couldn’t download the image from the link provided.",
+                    "reason": "The server returned an error while trying to fetch the image.",
                     "image_url": image_url,
+                    "details": str(download_error),
+                    "suggestions": [
+                        "Make sure the link is publicly reachable (no login, VPN, or IP restrictions).",
+                        "If the image is hosted on a private app or server, move it to a public URL or a CDN and try again.",
+                        "Verify the URL is correct and serves the actual image file."
+                    ]
                 }, indent=2)
 
             if not image_bytes:
                 return json.dumps({
-                    "error": "No data returned when downloading image from URL",
+                    "error": "We couldn’t access the image at the link you provided.",
+                    "reason": "The image link doesn’t appear to be publicly accessible or didn’t return any data.",
                     "image_url": image_url,
+                    "suggestions": [
+                        "Double‑check that the link is public and does not require login, VPN, or IP allow‑listing.",
+                        "If the image is stored in a private app (for example, a self‑hosted gallery), upload it to a public URL or a CDN and try again.",
+                        "Confirm the URL is correct and points directly to an image file (e.g., .jpg, .png)."
+                    ]
                 }, indent=2)
 
             import base64  # Local import

{meta_ads_mcp-0.11.2 → meta_ads_mcp-0.11.4}/meta_ads_mcp/core/openai_deep_research.py

@@ -315,8 +315,6 @@ async def search(
 ) -> str:
     """
     Search through Meta Ads data and return matching record IDs.
-    
-    This tool is required for OpenAI ChatGPT Deep Research integration.
     It searches across ad accounts, campaigns, ads, pages, and businesses to find relevant records
     based on the provided query.
     
@@ -371,8 +369,6 @@ async def fetch(
 ) -> str:
     """
     Fetch complete record data by ID.
-    
-    This tool is required for OpenAI ChatGPT Deep Research integration.
     It retrieves the full data for a specific record identified by its ID.
     
     Args:

{meta_ads_mcp-0.11.2 → meta_ads_mcp-0.11.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "meta-ads-mcp"
-version = "0.11.2"
+version = "0.11.4"
 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.2 → meta_ads_mcp-0.11.4}/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