mcpHosted AI, explicit consent

Create segment

tools/call

Generate GTM buyer segments from company context using the workspace's BYOK LLM and persist them as draft segments. Set regenerate=true to replace existing drafts instead of appending.

Parameters

workspaceIdrequired

string

No description.

count

number

Segments to generate, clamped 3-8. Defaults to 5.

regenerate

boolean

Replace existing draft segments instead of appending.

context

object

No description.

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": "create-segment",
    "arguments": {
      "workspaceId": "00000000-0000-4000-8000-000000000000",
      "allowHostedAi": true
    }
  }
}

Response

The operation is available, but its typed response schema has not been published yet.

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.