mcpHosted AI, explicit consent

Preview campaign canary

tools/call

Resolve up to 10 campaign-table rows through the approved brief variable plan. external_agent renders current saved touches only and holds missing or stale copy without hosted inference. pipeline_hosted preserves Writer drafting and is the default when omitted. Returns final sample messages, evidence, fallbacks, held-row reasons, operation provenance, and production review URLs for the brief and table. Creates drafts only and cannot approve or launch.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

briefIdrequired

string

No description.

rowIds

string[]

Optional sample row IDs, maximum 10. Defaults to the first 10 campaign-table rows.

executionMode

string

Use external_agent to render current saved touches without Pipeline hosted AI.

external_agent | pipeline_hosted

allowHostedAi

boolean

Must be true when this operation uses Pipeline hosted inference.

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "preview-campaign-canary",
    "arguments": {
      "briefId": "00000000-0000-4000-8000-000000000000",
      "allowHostedAi": true
    }
  }
}

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "briefId": {
      "type": "string"
    },
    "tableId": {
      "type": "string"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rowId": {
            "type": "string"
          },
          "legacy": {
            "type": "boolean"
          },
          "touches": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "outputRole": {
                  "type": "string"
                },
                "mode": {
                  "type": "string",
                  "enum": [
                    "static",
                    "formula",
                    "ai"
                  ]
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ready",
                    "held",
                    "requires_ai",
                    "blocked"
                  ]
                },
                "body": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "selectedBranch": {
                  "type": "string",
                  "enum": [
                    "static",
                    "formula",
                    "fallback",
                    "ai",
                    "held"
                  ]
                },
                "variables": {
                  "type": "object"
                },
                "evidence": {
                  "type": "object"
                },
                "fallbackReason": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "heldReason": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "error": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "operations": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "outputRole",
                "mode",
                "status",
                "body",
                "selectedBranch",
                "variables",
                "evidence",
                "fallbackReason",
                "heldReason",
                "error",
                "operations"
              ]
            }
          },
          "heldReason": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "rowId",
          "legacy",
          "touches",
          "heldReason"
        ]
      }
    },
    "summary": {
      "type": "object",
      "properties": {
        "totalRows": {
          "type": "number"
        },
        "readyRows": {
          "type": "number"
        },
        "heldRows": {
          "type": "number"
        },
        "fallbackRows": {
          "type": "number"
        },
        "operations": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "totalRows",
        "readyRows",
        "heldRows",
        "fallbackRows",
        "operations"
      ]
    },
    "approvalRequired": {
      "type": "boolean"
    },
    "launchAllowed": {
      "type": "boolean"
    },
    "reviewUrls": {
      "type": "object",
      "properties": {
        "strategyBrief": {
          "type": "string",
          "format": "uri"
        },
        "table": {
          "type": "string",
          "format": "uri"
        },
        "campaign": {
          "type": "string",
          "format": "uri"
        },
        "campaignWorkflow": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "strategyBrief",
        "table"
      ]
    }
  },
  "required": [
    "briefId",
    "tableId",
    "rows",
    "summary",
    "approvalRequired",
    "launchAllowed",
    "reviewUrls"
  ]
}

JSON-RPC errors

-32602: Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001: Authentication or hosted AI consent is required.
-32003: Workspace access is denied.
-32029: The request was rate limited.