List Meta ad accounts available to the configured access token.

Args: params: Maximum result count and JSON or Markdown response format.

Returns: A rendered {"success": bool, "data": list[object] | null, "error": string | null} envelope containing account identifiers, names, statuses, and currencies.

Use this to discover an account ID before account-scoped reads. Do not use it to inspect campaigns or to create, update, or delete ad accounts.

Get campaigns for an explicit or configured default ad account.

Args: params: Optional account ID, maximum result count, and JSON or Markdown response format.

Returns: A rendered {"success": bool, "data": list[object] | null, "error": string | null} envelope containing campaign identifiers, names, statuses, objectives, and budgets.

Use this for an account-level campaign inventory. Do not use it for performance metrics or for campaign creation, edits, or status changes.

Get ad sets beneath an account or campaign parent.

Args: params: Parent account or campaign ID, maximum result count, and JSON or Markdown response format.

Returns: A rendered {"success": bool, "data": list[object] | null, "error": string | null} envelope containing ad set identifiers, names, statuses, campaign IDs, and daily budgets.

Use this to inspect the ad-set hierarchy for a known parent. Do not use it for performance metrics or to create, edit, pause, or delete ad sets.

Get ads beneath an account, campaign, or ad-set parent.

Args: params: Parent object ID, maximum result count, and JSON or Markdown response format.

Returns: A rendered {"success": bool, "data": list[object] | null, "error": string | null} envelope containing ad identifiers, names, statuses, ad-set IDs, and campaign IDs.

Use this to inspect ads for a known hierarchy parent. Do not use it for performance metrics or to create, edit, pause, or delete ads.

Get raw Meta performance metrics for an object and reporting period.

Args: params: Object ID, aggregation level, either a date preset or custom since/until range, maximum row count, and response format.

Returns: A rendered {"success": bool, "data": list[object] | null, "error": string | null} envelope containing raw Meta insight rows with spend, delivery, click, action, and purchase ROAS fields.

Use this for flexible read-only metric retrieval at account, campaign, ad-set, or ad level. Do not use it to modify delivery or to infer causal lift from platform-attributed results.

Rank campaign performance and flag heuristic symptoms for review.

Args: params: Optional account ID, reporting preset, CTR, ROAS, and frequency thresholds, and JSON or Markdown response format.

Returns: A rendered {"success": bool, "data": {"caveat": string, "truncated": bool, "campaigns": list[object]} | null, "error": string | null} envelope. Campaign records are sorted by spend and include metric values plus zero or more heuristic flag names.

Use this for read-only campaign triage, not as proof of causation or a verified diagnosis. Conversions and ROAS are platform-reported using Meta attribution, not incremental; a holdout or lift test is required to claim incrementality, and periods should be compared at similar spend. Do not use this tool to make delivery changes or assert causal campaign impact.