Create brief
create_briefA Brief is the brand guidance and files Rainbrand selects for the work you're doing. Use one Brief for closely related work that shares the same goal, audience, creative direction, and source material. Request a new Brief when any of those change meaningfully. Use get_brand for a general overview of the brand. Returns the brief_id and status immediately. Then call get_brief with the returned brief_id and wait: true, and inspect the completed guidance and assets before using them.
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>",
"task": "<task>"
},
"name": "create_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | What you are about to make, in plain language. Include any context or instructions that would help select the right brand guidance and files. | |
| 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. | |
| idempotency_key | No | Retry key for recovering the original Brief request. Reuse the same key with identical input. | |
| brand_session_id | Yes | Brand session ID from list_brands for the brand to prepare the brief from. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Current brief status. | |
| brief_id | Yes | Brief ID. Pass it as brief_id to get_brief. | |
| 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. |