Updates StoryBrand 7-part framework planning fields for a project. Supports partial updates.
Tool Name
update_sb7_field
Description
The update_sb7_field tool updates one or more StoryBrand planning fields. It supports partial updates — only the provided fields are changed. Data is secured via session-based authentication and organization scoping.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| projectId | string | Yes | Project UUID (valid UUID v4) |
| character | string | No | Target audience / Hero (max 2000 chars) |
| characterNeeds | string | No | Customer needs (max 2000 chars) |
| problem | string | No | Character's problem (max 2000 chars) |
| problemImpact | string | No | Problem impact (max 2000 chars) |
| guide | string | No | Guide / Brand (max 2000 chars) |
| guideCredibility | string | No | Guide credibility (max 2000 chars) |
| plan | string[] | No | Plan steps (max 10 entries, 500 chars each) |
| callToAction | string | No | Call to action (max 500 chars) |
| directCta | string | No | Direct CTA (max 500 chars) |
| transitionalCta | string | No | Transitional CTA (max 500 chars) |
| success | string | No | Success scenario (max 2000 chars) |
| failure | string | No | Failure scenario (max 2000 chars) |
| transformation | string | No | Transformation (max 2000 chars) |
| currentPhase | number | No | Current step (1-3) |
| phase1Completed | boolean | No | Step 1 completed |
| phase2Completed | boolean | No | Step 2 completed |
| phase3Completed | boolean | No | Step 3 completed |
Example Request
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "update_sb7_field",
"arguments": {
"projectId": "cdc9b373-0f96-4ed3-8d4e-50db6019d327",
"character": "Small and medium businesses",
"problem": "Missing online presence and no technical knowledge"
}
},
"id": 1
}Example Response
{
"jsonrpc": "2.0",
"result": {
"content": [
{
"type": "text",
"text": "{\"projectId\":\"cdc9b373-0f96-4ed3-8d4e-50db6019d327\",\"updatedFields\":[\"character\",\"problem\"],\"currentStep\":1,\"message\":\"Successfully updated 2 field(s)\"}"
}
]
},
"id": 1
}Errors
| Code | Meaning |
|---|---|
| -32602 | Invalid parameters (UUID format, field validation) |
| -32000 | No fields provided to update |