Cuentas

List the ad accounts connected to the organization

ads_visualizer.accounts.list

Lists the ad accounts connected to the organization in its data sources, the ones the Ads Visualizer can read: Google Ads, Meta Ads, TikTok Ads and LinkedIn Ads (filter with platform). Each one has platform, account_id (the id every other ads_visualizer operation takes in its path), name, currency (of its costs; null when the connection did not store it), manager_id (Google Ads: the manager account it is reached through, or null) and inherited (true when the account uses its agency workspace's connection). Reads only MB Suite: nothing is fetched from the platforms and it does not count against the external quota. With nothing connected it returns an empty list: accounts are connected in Settings → Integrations, and each Account (client) has its own. Not paginated. Requires view access to the Ads Visualizer. With Google Ads, LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Alcance

ads_visualizer:read

Permiso

Ver el módulo

Tool del MCP

ads_visualizer_accounts_listEn la superficie completa; en la compacta, mb_execute_operation con id: "ads_visualizer.accounts.list".

Costo declarado: hasta 1 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/ads-visualizer/accounts" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/ads-visualizer/accounts" \
  -H "Authorization: Bearer $MB_TEST_KEY"