mcpHosted AI, explicit consent

Send agent chat message

tools/call

Attach bounded page IDs with surfaceContext for contextual work. Context is validated at acceptance and inherited by delegated work. Send a message to an exact private Agent Teams chat from list-agent-chats. Defaults to external_agent: claim the returned turn, reason with your current coding-agent model, use Pipeline tools for real work, then complete-agent-chat-turn to save the reply in the UI. No workspace model key or hosted inference is required. Explicit pipeline_hosted mode uses chat model settings and requires hosted-AI consent. Reuse the idempotencyKey only for retries of the same message. Read get-agent-chat for progress and results.

Parameters

workspaceId
string
No description.
action
string
No description.
send
conversationIdrequired
string
No description.
textrequired
string
No description.
idempotencyKeyrequired
string
No description.
executionMode
string
No description.
external_agent | pipeline_hosted
references
object[]
No description.
surfaceContext
unknown
No description.
planIntent
object
No description.
selectedSkill
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": "send-agent-chat-message",
"arguments": {
"conversationId": "00000000-0000-4000-8000-000000000000",
"text": "example",
"idempotencyKey": "example1",
"allowHostedAi": true
}
}
}

Response

Success response schemajson schema
{
"type": "object",
"properties": {
"message": {
"type": "object"
},
"turns": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"message",
"turns"
]
}

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.
Pipeline MCP documentation | Pipeline