ArmaVita Meta Ads MCP

Instructions

Implementation Reference

• src/armavita_meta_ads_mcp/core/adset_tools.py:154-181 (handler)

  The implementation of the `list_ad_sets` tool handler, which fetches ad set data from the Meta Graph API.

  @mcp_server.tool()
  @meta_api_tool
  async def list_ad_sets(
      ad_account_id: str,
      meta_access_token: Optional[str] = None,
      page_size: int = 10,
      campaign_id: str = "",
      page_cursor: str = "",
  ) -> str:
      """List ad sets under an account or campaign."""
      if not ad_account_id:
          return _json({"error": "No account ID specified"})
  
      target = campaign_id or ad_account_id
      endpoint = f"{target}/adsets"
      params: Dict[str, Any] = {
          "fields": (
              "id,name,campaign_id,status,daily_budget,lifetime_budget,targeting,bid_amount,bid_strategy,"
              "bid_constraints,optimization_goal,billing_event,start_time,end_time,created_time,updated_time,"
              "is_dynamic_creative,frequency_control_specs{event,interval_days,max_frequency}"
          ),
          "page_size": int(page_size),
      }
      if page_cursor:
          params["page_cursor"] = page_cursor
  
      payload = await make_api_request(endpoint, meta_access_token, params)
      return _json(payload)