Accounts

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

Scope

ads_visualizer:read

Permission

View the module

MCP tool

ads_visualizer_accounts_listOn the full surface; on the compact one, mb_execute_operation with id: "ads_visualizer.accounts.list".

Declared cost: up to 1 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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