brand_resolve

Given an ad account, find which brands' context applies to it.

Given an ad account, returns the brands whose context applies to it.

This is the tool that closes the loop. You already know which account you’re working on; this tells you who you’re working for — so the copy you write and the judgements you make belong to that brand rather than to nobody in particular.

Input

Output

An array of { brandSlug, brandName, via }. Load the context itself with brand_get.

Why it returns a list

An ad account can be attached to more than one brand — an agency running two lines through one account, say. Rather than guess which one you meant, this returns all of them, and via says how each applies. An account with no brand attached returns an empty list, which is a normal answer rather than an error.

Example

brand_resolve({ advertiser_id: 'acc_123' });
// → [{ brandSlug: 'acme-running', brandName: 'Acme Running', via: 'direct' }]
brand_get({ brand_name: 'acme-running' });

Requires the brand:read scope.

Reference

Given an ad account, find which brands’ context applies to it — call this before writing copy or judging performance for that account, so you know who you are acting for. Returns every applicable brand rather than guessing one: an account can carry more than one. Then load the context with brand_get.

Input

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

• forbidden
• invalid_request
• internal_error

Scope

The token must hold brand:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

• Read-only. The tool changes nothing.
• Closed world. The tool reads and writes the data of AdCrunch only.