Documentation version: 2026-09-24.7
Canonical: https://docs.creator.gg/tools/intelligence_update.md

# intelligence_update

Save incremental business, competitor, objective or insight records. Read intelligence_get first; supply its revision. Competitors deduplicate by hostname. Confirmed records require explicit allowConfirmedChanges. Existing strategy is flagged for review, never silently rewritten. Reuse the same requestId when retrying an uncertain operation.

## Execution

Interface: Creators MCP tool at https://mcp.creator.gg/mcp. Do not construct a REST route from the tool name. The connection selects the workspace.

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

Use returned IDs, inspect the result, and preserve unrelated records/preferences.

## Example arguments

Illustrative placeholders only. Replace IDs with values from this workspace, resolve sender/content/recipients, recalculate dates, and generate a new requestId for a new action.

```json
{
  "revision": 0,
  "entries": [
    {
      "key": "competitor:example.com",
      "kind": "competitor",
      "title": "Example",
      "url": "https://example.com/",
      "summary": "A competitor identified by the customer; public capabilities still need research.",
      "origin": "inferred",
      "sources": [],
      "implications": [],
      "archived": false
    }
  ],
  "requestId": "example-intelligence_update-001"
}
```

## Input schema

Generated from the current executable Creators contract. Runtime rules in Behavior and limits and the linked guide also apply; JSON Schema alone cannot express all cross-field constraints.

```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 Creators 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}$"
    },
    "entries": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9_.:-]{0,199}$"
          },
          "kind": {
            "type": "string",
            "enum": [
              "business",
              "competitor",
              "insight",
              "objective"
            ]
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "summary": {
            "type": "string",
            "maxLength": 4000
          },
          "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
            }
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "implications": {
            "default": [],
            "maxItems": 10,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 1000
            }
          },
          "archived": {
            "default": false,
            "type": "boolean"
          }
        },
        "required": [
          "key",
          "kind",
          "title",
          "summary",
          "origin",
          "sources"
        ],
        "additionalProperties": false
      }
    },
    "allowConfirmedChanges": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "revision",
    "entries"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Results use status and message, with operation-specific data and optional link, code, nextAction, and operationId. Data may retain different list/record envelopes. A completed read or accepted send is not proof of delivery/publication. An unknown result must be reconciled. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

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