Contas

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).

Escopo

ads_visualizer:read

Permissão

Ver o módulo

Tool do MCP

ads_visualizer_accounts_listNa superfície completa; na compacta, mb_execute_operation com id: "ads_visualizer.accounts.list".

Custo declarado: até 1 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

Resposta

Erros

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

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