asset_get

Fetch one Asset with its Registrations — where it has been placed, and how each placement went. Also how you poll a running registration.

Fetches a single Asset together with all its Registrations and their states. This is also how you poll a registration you started with asset_register: a running Registration is still in progress.

Input

Field	Type	Required	Description
`asset_id`	`ast_*`	yes	The Asset to fetch.

Output

{ asset: { …, registrations: [...] } } — the Asset metadata (see asset_list) plus a registrations array. Each Registration carries:

Field	Type	Description
`id`	`reg_*`	The Registration id.
`advertiserId`	`acc_*`	The advertiser whose library it was placed in.
`provider`	`string`	e.g. `meta`.
`status`	`'running' \| 'ready' \| 'failed'`	`running` = still processing; `ready` = live; `failed` = retryable.
`providerIdentifier`	`string`	The provider’s own id for the file, once `ready`.
`failureReason`	`string`	Present when `status` is `failed`.

Example

“Is that image ready in the Acme account yet?”

Claude calls asset_get({ asset_id: 'ast_…' }), finds the Registration for that advertiser, and reports its status.

Errors

Only ready (finalized) Assets are returned — an Asset still pending reads as not found.
Unknown ids and Assets owned by another organization both come back the same way, so an id can’t be probed for existence.
401 or 403 — see Errors, which every tool shares. This one needs asset:read.

Reference

Fetch one Asset together with its Registrations — where it has been placed, and how each placement went.

This is also how you poll a registration you started: a running Registration is still in progress. Video can stay running for several minutes while the provider processes it, which is normal.

Input

Argument	Type	Required	Description
`asset_id`	string	yes	The Asset id (ast_…).

Failure codes

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

not_found
forbidden
invalid_request
internal_error

Scope

The token must hold asset: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.