meta-ads-mcp 0.2.4__py3-none-any.whl → 0.2.5__py3-none-any.whl

meta_ads_mcp/core/authentication.py

@@ -5,7 +5,7 @@ import asyncio
 from .api import meta_api_tool
 from .auth import start_callback_server, auth_manager, get_current_access_token
 from .server import mcp_server
-from .utils import logger
+from .utils import logger, META_APP_SECRET
 
 
 @mcp_server.tool()
@@ -46,6 +46,10 @@ async def get_login_link(access_token: str = None) -> str:
     login_url = auth_manager.get_auth_url()
     logger.info(f"Generated login URL: {login_url}")
     
+    # Check if we can exchange for long-lived tokens
+    token_exchange_supported = bool(META_APP_SECRET)
+    token_duration = "60 days" if token_exchange_supported else "1-2 hours"
+    
     # Return a special format that helps the LLM format the response properly
     response = {
         "login_url": login_url,
@@ -54,6 +58,11 @@ async def get_login_link(access_token: str = None) -> str:
         "markdown_link": f"[Click here to authenticate with Meta Ads]({login_url})",
         "message": "IMPORTANT: Please use the Markdown link format in your response to allow the user to click it.",
         "instructions_for_llm": "You must present this link as clickable Markdown to the user using the markdown_link format provided.",
+        "token_exchange": "enabled" if token_exchange_supported else "disabled",
+        "token_duration": token_duration,
+        "token_exchange_message": f"Your authentication token will be valid for approximately {token_duration}." + 
+                                 (" Long-lived token exchange is enabled." if token_exchange_supported else 
+                                  " To enable long-lived tokens (60 days), set the META_APP_SECRET environment variable."),
         "note": "After authenticating, the token will be automatically saved."
     }
     

meta_ads_mcp/core/utils.py

@@ -13,6 +13,16 @@ import logging
 import pathlib
 import platform
 
+# Check for Meta app credentials in environment
+META_APP_ID = os.environ.get("META_APP_ID", "")
+META_APP_SECRET = os.environ.get("META_APP_SECRET", "")
+
+# Print warning if Meta app credentials are not configured
+if not META_APP_ID:
+    print("WARNING: META_APP_ID environment variable is not set. Authentication will not work properly.")
+if not META_APP_SECRET:
+    print("WARNING: META_APP_SECRET environment variable is not set. Long-lived token exchange will not work.")
+
 # Configure logging to file
 def setup_logging():
     """Set up logging to file for troubleshooting."""

{meta_ads_mcp-0.2.4.dist-info → meta_ads_mcp-0.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.2.4
+Version: 0.2.5
 Summary: Model Calling Protocol (MCP) plugin for interacting with Meta Ads API
 Project-URL: Homepage, https://github.com/nictuku/meta-ads-mcp
 Project-URL: Bug Tracker, https://github.com/nictuku/meta-ads-mcp/issues
@@ -21,16 +21,26 @@ Description-Content-Type: text/markdown
 
 # Meta Ads MCP
 
-A [Model Calling Protocol (MCP)](https://github.com/anthropics/anthropic-tools) plugin for interacting with Meta Ads API.
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for interacting with Meta Ads API. This tool enables AI models to access, analyze, and manage Meta advertising campaigns through a standardized interface, allowing LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook, Instagram, and other Meta platforms.
+
+> **DISCLAIMER:** This is an unofficial third-party tool and is not associated with, endorsed by, or affiliated with Meta in any way. This project is maintained independently and uses Meta's public APIs according to their terms of service. Meta, Facebook, Instagram, and other Meta brand names are trademarks of their respective owners.
+
+Screenhot: using an LLM to understand your ad performance.
+
+![Meta Ads MCP in action: Visualize ad performance metrics and creative details directly in Claude or your favorite MCP client, with rich insights about campaign reach, engagement, and costs](./images/meta-ads-example.png)
 
 ## Features
 
-- Seamless authentication with Meta's Graph API for desktop applications
-- Automatic token caching across sessions
-- Cross-platform support (Windows, macOS, Linux)
-- Access to ad accounts, campaigns, ad sets, and ads
-- Image download and analysis capabilities
-- Performance insights
+- **AI-Powered Campaign Analysis**: Let your favorite LLM analyze your campaigns and provide actionable insights on performance
+- **Strategic Recommendations**: Receive data-backed suggestions for optimizing ad spend, targeting, and creative content
+- **Automated Monitoring**: Ask any MCP-compatible LLM to track performance metrics and alert you about significant changes
+- **Budget Optimization**: Get recommendations for reallocating budget to better-performing ad sets
+- **Creative Improvement**: Receive feedback on ad copy, imagery, and calls-to-action
+- **Campaign Management**: Request changes to campaigns, ad sets, and ads (all changes require explicit confirmation)
+- **Cross-Platform Integration**: Works with Facebook, Instagram, and all Meta ad platforms
+- **Universal LLM Support**: Compatible with any MCP client including Claude Desktop, Cursor, Cherry Studio, and more
+- **Simple Authentication**: Easy setup with secure OAuth authentication
+- **Cross-Platform Support**: Works on Windows, macOS, and Linux
 
 ## Installation
 
@@ -39,7 +49,7 @@ A [Model Calling Protocol (MCP)](https://github.com/anthropics/anthropic-tools)
 When using uv no specific installation is needed. We can use uvx to directly run meta-ads-mcp:
 
 ```bash
-uvx meta-ads-mcp
+uvx meta-ads-mcp --app-id YOUR_META_ADS_APP_ID
 ```
 
 If you want to install the package:
@@ -79,7 +89,7 @@ Add this to your `claude_desktop_config.json` to integrate with Claude in Cursor
 "mcpServers": {
   "meta-ads": {
     "command": "uvx",
-    "args": ["meta-ads-mcp"]
+    "args": ["meta-ads-mcp", "--app-id", "YOUR_META_ADS_APP_ID"]
   }
 }
 ```
@@ -350,4 +360,4 @@ You can check the current version of the package:
 ```python
 import meta_ads_mcp
 print(meta_ads_mcp.__version__)
-``` 
+``` 

{meta_ads_mcp-0.2.4.dist-info → meta_ads_mcp-0.2.5.dist-info}/RECORD

@@ -1,19 +1,19 @@
-meta_ads_mcp/__init__.py,sha256=xmCT88Y60ifMx7uGEKOJBAF0JC1buzGdGexT9svhDtU,1204
+meta_ads_mcp/__init__.py,sha256=Mf42uSXVCCipMTMhyIzXP2PLHIlpmqmhj04vB4XDans,1204
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/api.py,sha256=9mmoJIdkC3PexZn3hw8XiKznecsbOSnhHtdEsJiPIyw,77475
 meta_ads_mcp/core/__init__.py,sha256=BA93zC6D8CzKbLo4JqqNqahq2LVgWBsoIXmJCK4AdIc,924
 meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
 meta_ads_mcp/core/ads.py,sha256=TS37bUX8kJeeX4M2jv3StZev7Riq-n8Fm0TOhEL0eIY,14625
-meta_ads_mcp/core/adsets.py,sha256=Wuk5EJywypFNbPgdLGJ13XK7O6v7TyfwdR4f1MObGzE,5739
-meta_ads_mcp/core/api.py,sha256=vmMgX6pb4HkoLw3PXNekqrZCN4k06oZPtMF4128Wzz0,10133
-meta_ads_mcp/core/auth.py,sha256=2F1v3kWfl83NC8X_IyH-JUu0pQYtxplKZ-G5KyWSVAw,37222
-meta_ads_mcp/core/authentication.py,sha256=_lEi5XerkitD96jr6J8H9pUa1z1sp8SLr8iXvyr8fIg,2798
+meta_ads_mcp/core/adsets.py,sha256=oUmvH-odZLrTNkwVlGp1orBFtb8ZsCJ0ZSEC65V3NUg,7348
+meta_ads_mcp/core/api.py,sha256=AurfnoUZoIq9WS4cnsmVqpxc3pdsws8jvNhzQzdzLGg,12209
+meta_ads_mcp/core/auth.py,sha256=tbwAia-pj9OyAmkri3Sv2wFq70qVFD9kN8XpkzI9gTE,89265
+meta_ads_mcp/core/authentication.py,sha256=6zoGorswj5kRbrt_18A8KrZdCORNLGHybvb7XRQ1yJg,3474
 meta_ads_mcp/core/campaigns.py,sha256=u5jNHSxcWlZgzVLNmaeoovA9OcPjSUjTegUMcDLAurs,4381
 meta_ads_mcp/core/insights.py,sha256=f4Rs3kG0oqpKl8zBc_nt_zE0z4zvb9i0g12galrDiw8,17376
 meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0w,1236
 meta_ads_mcp/core/server.py,sha256=-tClGe4rc-8U2ihgpipLstiTPRg3-CnjsTRgncsNa_A,3055
-meta_ads_mcp/core/utils.py,sha256=ByVAoMoTlkAe2xtC2NRm9oqHrHiarsipXeWh0NZB2Xs,5574
-meta_ads_mcp-0.2.4.dist-info/METADATA,sha256=5iT4VVpfdDReyxWKsE8ITIXkZdu4XvBvAq_UJs_z46U,12507
-meta_ads_mcp-0.2.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.2.4.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.2.4.dist-info/RECORD,,
+meta_ads_mcp/core/utils.py,sha256=wxh722z-x0TSJwDEEeDylkv4VJqLmqnkZy-YGRzs4vQ,6049
+meta_ads_mcp-0.2.5.dist-info/METADATA,sha256=YWT1H50cEd2P0QJRjLKxcR6IQim98kpjwGB6gFcgC1Y,14196
+meta_ads_mcp-0.2.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.2.5.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.2.5.dist-info/RECORD,,