Documentation version: 2026-11-16.2
Canonical: https://docs.creator.gg/tools/intelligence_foundations_update.md

# intelligence_foundations_update

Save incremental typed business foundations or product features as current knowledge immediately in the same dashboard records. No proposal or adoption stage; origin remains provenance and later explicit edits are supported. Read intelligence_foundations_get for revision. Upsert only changed full records with stable IDs, sources and availability; optional associations are hints, never a whitelist. Confirmed corrections need allowConfirmedChanges. No plan generation, automatic learning or publication. 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

Explicit incremental full-record upserts, 1..20 per batch, shared revision and receipt history with legacy/dashboard edits. Returns data.{revision,replayed,updatedKeys,planNeedsReview}; identical replay may contain only revision and replayed. Preserve IDs/types and unaffected fields; confirmed corrections/archival require explicit allowConfirmedChanges. Read guides/business-foundations for all record variants, sources and reference validation. No automatic learning or plan generation.

## 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": 0,
  "records": [
    {
      "record": {
        "id": "catalogue-export",
        "type": "feature",
        "name": "Catalogue export",
        "description": "Export the maintained inventory.",
        "contextKeys": [],
        "module": "Knowledge",
        "capabilities": [
          "Download the current inventory"
        ],
        "limitations": [],
        "availability": {
          "state": "unknown",
          "access": "",
          "conditions": []
        },
        "documentation": [],
        "examples": []
      },
      "origin": "inferred",
      "sources": [],
      "archived": false
    }
  ],
  "requestId": "example-intelligence_foundations_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
    },
    "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}$"
    },
    "records": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "record": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "company"
                  },
                  "website": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "vision": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "customerProblem": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "positioning": {
                    "type": "string",
                    "maxLength": 4000
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "vision",
                  "customerProblem",
                  "positioning"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "product"
                  },
                  "offer": {
                    "type": "string",
                    "maxLength": 4000
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "offer"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "audience"
                  },
                  "characteristics": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    }
                  },
                  "needs": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    }
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "characteristics",
                  "needs"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "customer_outcome"
                  },
                  "successSignals": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    }
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "successSignals"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "category"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "mechanism"
                  },
                  "howItWorks": {
                    "type": "string",
                    "maxLength": 4000
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "howItWorks"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "feature"
                  },
                  "productId": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "module": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "capabilities": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    }
                  },
                  "limitations": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    }
                  },
                  "availability": {
                    "type": "object",
                    "properties": {
                      "state": {
                        "type": "string",
                        "enum": [
                          "unknown",
                          "planned",
                          "in_development",
                          "beta",
                          "available",
                          "retired"
                        ]
                      },
                      "access": {
                        "type": "string",
                        "maxLength": 4000
                      },
                      "conditions": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1000
                        }
                      },
                      "verifiedAt": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "required": [
                      "state",
                      "access",
                      "conditions"
                    ],
                    "additionalProperties": false
                  },
                  "documentation": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "url": {
                          "type": "string",
                          "maxLength": 2048
                        }
                      },
                      "required": [
                        "title",
                        "url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "examples": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 4000
                        },
                        "url": {
                          "type": "string",
                          "maxLength": 2048
                        }
                      },
                      "required": [
                        "title",
                        "description"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "module",
                  "capabilities",
                  "limitations",
                  "availability",
                  "documentation",
                  "examples"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "use_case"
                  },
                  "scenario": {
                    "type": "string",
                    "maxLength": 4000
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "scenario"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "contextKeys": {
                    "default": [],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
                    }
                  },
                  "type": {
                    "type": "string",
                    "const": "association"
                  },
                  "fromId": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "toId": {
                    "type": "string",
                    "pattern": "^[a-z0-9][a-z0-9_.-]{0,119}$"
                  },
                  "relation": {
                    "type": "string",
                    "enum": [
                      "related_to",
                      "supports",
                      "serves",
                      "uses",
                      "classified_as"
                    ]
                  }
                },
                "required": [
                  "id",
                  "name",
                  "description",
                  "type",
                  "fromId",
                  "toId",
                  "relation"
                ],
                "additionalProperties": false
              }
            ]
          },
          "origin": {
            "type": "string",
            "enum": [
              "extracted",
              "inferred",
              "confirmed"
            ]
          },
          "sources": {
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "maxLength": 2048
                },
                "title": {
                  "type": "string",
                  "maxLength": 200
                },
                "fetchedAt": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "url",
                "title",
                "fetchedAt"
              ],
              "additionalProperties": false
            }
          },
          "archived": {
            "default": false,
            "type": "boolean"
          }
        },
        "required": [
          "record",
          "origin",
          "sources"
        ],
        "additionalProperties": false
      }
    },
    "allowConfirmedChanges": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "revision",
    "records"
  ],
  "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

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