document_get

Fetch one brand document — images come back as an image the assistant can actually look at.

Fetches one document. The difference from document_list is what you get back for an image: the picture itself, not just a link to it.

That’s the point of this tool. An assistant that can see your logo can tell you whether a headline sits well beside it; one holding a URL can only take your word for it.

Input

Output

Always the metadata — { id, name, filename, mimeType, sizeBytes, url }.

Images under 1 MB additionally come back as an image the assistant can view. Everything else — PDFs, larger images — returns metadata and the URL alone.

Example

“Does this headline work with our logo?”

document_get({ document_id: 'doc_…' });
// → metadata, plus the logo itself for the assistant to look at

Requires the brand:read scope.

Reference

Fetch one brand document. Images come back as an image you can actually look at, so you can judge whether copy or creative suits the brand. Everything else — PDFs, oversized images — comes back as metadata and a URL to fetch.

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.

• not_found
• 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.