Meta Ads MCP

Instructions

Get detailed information about a specific campaign.

Note: This function requests a specific set of fields ('id,name,objective,status,...'). 
The Meta API offers many other fields for campaigns (e.g., 'effective_status', 'source_campaign_id', etc.) 
that could be added to the 'fields' parameter in the code if needed.

Args:
    campaign_id: Meta Ads campaign ID
    access_token: Meta API access token (optional - will use cached token if not provided)

Implementation Reference

• meta_ads_mcp/core/campaigns.py:87-111 (handler)

  The primary handler function for the 'get_campaign_details' tool. Decorated with @mcp_server.tool() for MCP registration and @meta_api_tool for Meta Ads API integration. Fetches detailed campaign information using the Meta Ads API endpoint.

  @mcp_server.tool()
  @meta_api_tool
  async def get_campaign_details(campaign_id: str, access_token: Optional[str] = None) -> str:
      """
      Get detailed information about a specific campaign.
  
      Note: This function requests a specific set of fields ('id,name,objective,status,...'). 
      The Meta API offers many other fields for campaigns (e.g., 'effective_status', 'source_campaign_id', etc.) 
      that could be added to the 'fields' parameter in the code if needed.
      
      Args:
          campaign_id: Meta Ads campaign ID
          access_token: Meta API access token (optional - will use cached token if not provided)
      """
      if not campaign_id:
          return json.dumps({"error": "No campaign ID provided"}, indent=2)
      
      endpoint = f"{campaign_id}"
      params = {
          "fields": "id,name,objective,status,daily_budget,lifetime_budget,buying_type,start_time,stop_time,created_time,updated_time,bid_strategy,special_ad_categories,special_ad_category_country,budget_remaining,configured_status"
      }
      
      data = await make_api_request(endpoint, access_token, params)
      
      return json.dumps(data, indent=2)

• meta_ads_mcp/core/server.py:342-344 (registration)

  Imports the 'campaigns' module during server startup for Streamable HTTP transport, triggering the @mcp_server.tool() decorators to register the get_campaign_details tool among others.

  logger.info("Ensuring all tools are registered for HTTP transport")
  from . import accounts, campaigns, adsets, ads, insights, authentication
  from . import ads_library, budget_schedules, reports, openai_deep_research

• meta_ads_mcp/core/__init__.py:5-5 (registration)

  Explicit import of the get_campaign_details function from campaigns.py into the core module, exposing it for use and further re-export.

  from .campaigns import get_campaigns, get_campaign_details, create_campaign

• meta_ads_mcp/core/campaigns.py:90-100 (schema)

  Docstring providing input schema (parameters with descriptions) and notes on API fields for the get_campaign_details tool, used by MCP for tool schema generation.

  """
  Get detailed information about a specific campaign.
  
  Note: This function requests a specific set of fields ('id,name,objective,status,...'). 
  The Meta API offers many other fields for campaigns (e.g., 'effective_status', 'source_campaign_id', etc.) 
  that could be added to the 'fields' parameter in the code if needed.
  
  Args:
      campaign_id: Meta Ads campaign ID
      access_token: Meta API access token (optional - will use cached token if not provided)
  """