Documentation version: 2026-10-23.6
Canonical: https://docs.creator.gg/tools/growth_plan_update.md

# growth_plan_update

Save an authorized revised growth plan directly to the shared dashboard. Read growth_context_get and intelligence_get first; supply the profile revision and reviewed intelligenceRevision. Clears needs-review only on a successful save. Full plan replacement; preserve useful work. No sending, publication, routine or schedule change. Reuse the same requestId when retrying an uncertain operation.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: changes workspace data. requestId is required by the service (8–128 characters); reuse it only for the same action and arguments.

## Behavior and limits

Available to verified free-profile agents and native connections with an explicitly linked growth profile. Read growth_context_get and intelligence_get first: revision is data.context.revision, intelligenceRevision is the reviewed current intelligence revision. Supply the full plan, preserving useful decisions and completed work. The plan goal must match the saved objective. Optional catalog compositions use current idea IDs/revisions; evidence is attached server-side. Saves atomically, records before/after history, clears needs-review and does not consume hosted generation attempts. Identical requestId retries replay the original receipt without overwriting later work; read back current state. Revision, goal, dependency or catalog conflicts preserve the existing plan. It does not send, publish, enable a routine or change schedules. See guides/growth.

## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "revision": 3,
  "intelligenceRevision": 5,
  "plan": {
    "title": "Test a useful first customer action",
    "goal": "acquire",
    "summary": "Prepare a small, measurable test using the current business context.",
    "audience": "The priority audience confirmed by the owner.",
    "positioning": "The saved, supported offer.",
    "successMeasure": "Relevant visits and completed first customer actions.",
    "steps": [
      {
        "title": "Prepare the test",
        "rationale": "Learn whether the offer resolves the stated customer problem.",
        "action": "Prepare one useful demonstration and agree its audience.",
        "channel": "The agreed channel",
        "timing": "This week",
        "assetsNeeded": [
          "A current product demonstration"
        ],
        "execution": {
          "owner": "You and your agent",
          "dependsOn": [],
          "doneWhen": "The demonstration and audience are ready.",
          "requirements": []
        }
      }
    ],
    "questions": []
  },
  "requestId": "example-growth_plan_update-001"
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "data.context.revision from growth_context_get; not the intelligence revision."
    },
    "intelligenceRevision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The current intelligence revision reviewed for this plan."
    },
    "plan": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "goal": {
          "type": "string",
          "enum": [
            "acquire",
            "awareness",
            "winback"
          ]
        },
        "summary": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4000
        },
        "audience": {
          "type": "string",
          "maxLength": 4000
        },
        "positioning": {
          "type": "string",
          "maxLength": 4000
        },
        "successMeasure": {
          "type": "string",
          "maxLength": 4000
        },
        "strategy": {
          "type": "object",
          "properties": {
            "approach": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "composition": {
              "type": "object",
              "properties": {
                "catalogRevision": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "catalogSource": {
                  "type": "string",
                  "enum": [
                    "database",
                    "bundled"
                  ]
                },
                "focus": {
                  "minItems": 1,
                  "maxItems": 6,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "stage": {
                        "type": "string",
                        "enum": [
                          "awareness",
                          "acquisition",
                          "activation",
                          "retention",
                          "referral",
                          "revenue"
                        ]
                      },
                      "reason": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "successMeasure": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      }
                    },
                    "required": [
                      "stage",
                      "reason",
                      "successMeasure"
                    ],
                    "additionalProperties": false
                  }
                },
                "ideas": {
                  "minItems": 1,
                  "maxItems": 8,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "pattern": "^[a-z][a-z0-9-]{1,79}$"
                      },
                      "revision": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 9007199254740991
                      },
                      "reason": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      }
                    },
                    "required": [
                      "id",
                      "revision",
                      "reason"
                    ],
                    "additionalProperties": false
                  }
                },
                "deferred": {
                  "maxItems": 6,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "stage": {
                        "type": "string",
                        "enum": [
                          "awareness",
                          "acquisition",
                          "activation",
                          "retention",
                          "referral",
                          "revenue"
                        ]
                      },
                      "reason": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      }
                    },
                    "required": [
                      "stage",
                      "reason"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "catalogRevision",
                "catalogSource",
                "focus",
                "ideas",
                "deferred"
              ],
              "additionalProperties": false
            },
            "libraryEvidence": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "idea": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "pattern": "^[a-z][a-z0-9-]{1,79}$"
                      },
                      "title": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 160
                      },
                      "stages": {
                        "minItems": 1,
                        "maxItems": 6,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "enum": [
                            "awareness",
                            "acquisition",
                            "activation",
                            "retention",
                            "referral",
                            "revenue"
                          ]
                        }
                      },
                      "goals": {
                        "minItems": 1,
                        "maxItems": 3,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "enum": [
                            "acquire",
                            "awareness",
                            "winback"
                          ]
                        }
                      },
                      "tags": {
                        "maxItems": 16,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        }
                      },
                      "useWhen": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "avoidWhen": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "mechanism": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "prerequisites": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "actions": {
                        "minItems": 1,
                        "maxItems": 6,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        }
                      },
                      "assets": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "effort": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "measure": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1200
                      },
                      "evidence": {
                        "maxItems": 8,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "url": {
                              "type": "string",
                              "maxLength": 2048,
                              "format": "uri"
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "practitioner-report",
                                "observed-example",
                                "operating-guidance",
                                "measured-case"
                              ]
                            },
                            "finding": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200
                            },
                            "limitations": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1200
                            },
                            "observedAt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "checkedAt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "title",
                            "url",
                            "kind",
                            "finding",
                            "limitations",
                            "observedAt",
                            "checkedAt"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "confidence": {
                        "type": "string",
                        "enum": [
                          "hypothesis",
                          "practice-supported",
                          "case-supported"
                        ]
                      },
                      "reviewAfter": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "id",
                      "title",
                      "stages",
                      "goals",
                      "tags",
                      "useWhen",
                      "avoidWhen",
                      "mechanism",
                      "prerequisites",
                      "actions",
                      "assets",
                      "effort",
                      "measure",
                      "evidence",
                      "confidence",
                      "reviewAfter"
                    ],
                    "additionalProperties": false
                  },
                  "revision": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "candidate",
                      "active",
                      "archived"
                    ]
                  },
                  "updatedAt": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "idea",
                  "revision",
                  "status",
                  "updatedAt"
                ],
                "additionalProperties": false
              }
            },
            "version": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "playbookId": {
              "type": "string",
              "enum": [
                "coordinated-launch",
                "founder-conversations",
                "partner-distribution",
                "useful-resource",
                "search-intent",
                "customer-referrals",
                "customer-reactivation"
              ]
            },
            "whyThisFits": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1200
            },
            "mechanism": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1200
            },
            "assumptions": {
              "maxItems": 4,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500
              }
            },
            "alternatives": {
              "maxItems": 2,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "playbookId": {
                    "type": "string",
                    "enum": [
                      "coordinated-launch",
                      "founder-conversations",
                      "partner-distribution",
                      "useful-resource",
                      "search-intent",
                      "customer-referrals",
                      "customer-reactivation"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1200
                  }
                },
                "required": [
                  "playbookId",
                  "reason"
                ],
                "additionalProperties": false
              }
            },
            "readiness": {
              "maxItems": 3,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "Ready",
                      "Check",
                      "Prepare"
                    ]
                  },
                  "action": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1200
                  }
                },
                "required": [
                  "status",
                  "action"
                ],
                "additionalProperties": false
              }
            },
            "loop": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "Acquisition",
                        "Retention",
                        "Not yet"
                      ]
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "measure": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    }
                  },
                  "required": [
                    "kind",
                    "description",
                    "measure"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "measurement": {
              "type": "object",
              "properties": {
                "firstValue": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "reviewAfter": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "changeCourseWhen": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                }
              },
              "required": [
                "firstValue",
                "reviewAfter",
                "changeCourseWhen"
              ],
              "additionalProperties": false
            },
            "estimate": {
              "type": "object",
              "properties": {
                "mode": {
                  "type": "string",
                  "enum": [
                    "none",
                    "illustrative"
                  ]
                },
                "basis": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "timeWindow": {
                  "type": "string",
                  "maxLength": 200
                },
                "scenarios": {
                  "maxItems": 3,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "uniqueVisits": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100000000
                      },
                      "signupRate": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "activationRate": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    },
                    "required": [
                      "label",
                      "uniqueVisits",
                      "signupRate",
                      "activationRate"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "mode",
                "basis",
                "timeWindow",
                "scenarios"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "version",
            "whyThisFits",
            "mechanism",
            "assumptions",
            "readiness",
            "loop",
            "measurement",
            "estimate"
          ],
          "additionalProperties": false
        },
        "steps": {
          "minItems": 1,
          "maxItems": 6,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "rationale": {
                "type": "string",
                "maxLength": 4000
              },
              "action": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2000
              },
              "channel": {
                "type": "string",
                "maxLength": 200
              },
              "timing": {
                "type": "string",
                "maxLength": 500
              },
              "assetsNeeded": {
                "maxItems": 8,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 500
                }
              },
              "execution": {
                "type": "object",
                "properties": {
                  "ideaIds": {
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9-]{1,79}$"
                    }
                  },
                  "owner": {
                    "type": "string",
                    "enum": [
                      "You",
                      "Your agent",
                      "You and your agent",
                      "Partner"
                    ]
                  },
                  "dependsOn": {
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 6
                    }
                  },
                  "doneWhen": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1200
                  },
                  "requirements": {
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "owner",
                  "dependsOn",
                  "doneWhen",
                  "requirements"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "title",
              "rationale",
              "action",
              "channel",
              "timing",
              "assetsNeeded"
            ],
            "additionalProperties": false
          }
        },
        "questions": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 500
          }
        }
      },
      "required": [
        "title",
        "goal",
        "summary",
        "audience",
        "positioning",
        "successMeasure",
        "steps",
        "questions"
      ],
      "additionalProperties": false,
      "description": "The full revised plan. Preserve useful decisions and completed work."
    },
    "requestId": {
      "description": "Required by the Creator Platform service for mutations: a stable 8–128 character identifier. Reuse on retries; change for a new action.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
    }
  },
  "required": [
    "revision",
    "intelligenceRevision",
    "plan"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [growth](https://docs.creator.gg/guides/growth.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)