Get Brand
get_brandGet a brand's status, profile, guidance, and files. Read any file with view_files. Set wait to true to wait for current brand initialization. A version_id read returns that exact immutable version immediately, even if it is currently the latest. If the result is still analyzing, repeat the same read with wait: true. Use profile.logo_catalog to select among supported logos for the selected version. Follow exact caller selection and relevant Brand Skill guidance before contrasts_best_on visibility hints; use the primary logo as a general fallback. Null means no catalog was published, while an empty items array records no supported logos. Pass the same version_id when refreshing temporary asset URLs to retain the selected version.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"brand_session_id": "<brand_session_id>"
},
"name": "get_brand"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait for current brand initialization to finish or the timeout to expire. Defaults to false. Ignored when version_id is provided. | |
| timeout | No | How long this read may wait for Brand initialization, in seconds, including setup and polling. Applies when wait is true and version_id is omitted. Defaults to and is capped at 45 seconds. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| version_id | No | Version ID from list_brand_versions identifying the exact saved snapshot to read. Omit to read the latest version. | |
| brand_session_id | Yes | Brand session ID from `list_brands`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | Complete file list for the returned version. Use exact paths with view_files; description previews help choose which files to read. | |
| status | Yes | Brand readiness for this read. An analyzing result may require another read with wait enabled. | |
| failure | Yes | Failure details, or null when the Brand has not failed. | |
| profile | No | Structured identity for the returned Brand version, when available. | |
| brand_url | Yes | Page for opening this Brand in the app. | |
| created_at | Yes | Time the Brand was created. | |
| version_id | No | Immutable Brand version returned by this read. Pass it as version_id to view_files to read files from the same version. Omitted when no canonical version is available. | |
| file_catalog | No | Path completeness and the maximum number of exact paths per view_files call. | |
| workspace_id | Yes | Workspace ID, or null for a personal workspace that has no ID. | |
| root_guidance | No | Contents of SKILL.md for the returned Brand version, when available. | |
| workspace_name | Yes | Name of the workspace that owns this Brand. | |
| brand_session_id | Yes | Brand session ID to reuse in subsequent Brand tool calls. | |
| navigation_guide | No | Task-specific file selections parsed from the Brand Skill. Omitted when no navigation guidance is available. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |