Tool tree
gradeNot graded
get_live_relay_contextAnswer
Read the current signed-in Live Relay board context, eligible exact accounts, constraints, credits, and unavailable destinations. Returns no credentials or provider tokens.
View tool JSON
{
"name": "get_live_relay_context",
"kind": "answer",
"impl": "imperative",
"description": "Read the current signed-in Live Relay board context, eligible exact accounts, constraints, credits, and unavailable destinations. Returns no credentials or provider tokens.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}find_active_liveAnswer
Read verified active broadcasts across every connected YouTube channel (all candidates are returned), or accept the creator's explicit live link on YouTube, Twitch, Kick, TikTok, Instagram, Facebook, X or LinkedIn. Never invents a live event.
View tool JSON
{
"name": "find_active_live",
"kind": "answer",
"impl": "imperative",
"description": "Read verified active broadcasts across every connected YouTube channel (all candidates are returned), or accept the creator's explicit live link on YouTube, Twitch, Kick, TikTok, Instagram, Facebook, X or LinkedIn. Never invents a live event.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"discover",
"discover_youtube",
"use_declared"
],
"description": "discover (alias discover_youtube) reads active broadcasts on every connected YouTube channel; use_declared accepts the creator's own live link on a supported platform."
},
"declaration": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"youtube",
"twitch",
"kick",
"tiktok",
"instagram",
"facebook",
"x",
"linkedin"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"url": {
"type": "string",
"format": "uri",
"minLength": 1,
"maxLength": 2048
},
"accountId": {
"type": "string",
"description": "The connected account the live is running on, when known.",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"platform",
"title",
"url"
],
"additionalProperties": false
}
},
"required": [
"mode"
],
"additionalProperties": false,
"oneOf": [
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"discover",
"discover_youtube"
]
}
},
"required": [
"mode"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"mode": {
"const": "use_declared"
},
"declaration": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"youtube",
"twitch",
"kick",
"tiktok",
"instagram",
"facebook",
"x",
"linkedin"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"url": {
"type": "string",
"format": "uri",
"minLength": 1,
"maxLength": 2048
},
"accountId": {
"type": "string",
"description": "The connected account the live is running on, when known.",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"platform",
"title",
"url"
],
"additionalProperties": false
}
},
"required": [
"mode",
"declaration"
],
"additionalProperties": false
}
]
},
"page": "/en/webmcp-live-relay"
}draft_live_relayAction
Create a versioned relay draft: per-destination announcement copy and, when any clip destination is chosen, a 12-second 9:16 render that consumes render credits. Retries with the same idempotencyKey never charge twice. Never publishes externally.
View tool JSON
{
"name": "draft_live_relay",
"kind": "act",
"impl": "imperative",
"description": "Create a versioned relay draft: per-destination announcement copy and, when any clip destination is chosen, a 12-second 9:16 render that consumes render credits. Retries with the same idempotencyKey never charge twice. Never publishes externally.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"liveEventId": {
"type": "string",
"description": "The verified or creator-declared event identifier.",
"minLength": 1,
"maxLength": 128
},
"destinationIds": {
"type": "array",
"description": "Exact connected destination/account identifiers shown on the current board.",
"items": {
"type": "string",
"description": "A destination identifier returned by get_live_relay_context.",
"minLength": 1,
"maxLength": 128
},
"minItems": 1,
"maxItems": 24,
"uniqueItems": true
},
"brief": {
"type": "object",
"properties": {
"tone": {
"type": "string",
"enum": [
"high_energy",
"warm",
"urgent",
"informative"
]
},
"cta": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"durationSeconds": {
"type": "integer",
"const": 12
},
"aspectRatio": {
"type": "string",
"const": "9:16"
},
"hook": {
"type": "string",
"minLength": 1,
"maxLength": 160
}
},
"required": [
"tone",
"cta",
"durationSeconds",
"aspectRatio"
],
"additionalProperties": false
},
"idempotencyKey": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"description": "Stable key for this draft attempt. A retry with the same key and input returns the same relay and never charges twice."
},
"brandId": {
"type": "string",
"description": "A Brand id from get_live_relay_context.brands. Defaults to context.brand.",
"minLength": 1,
"maxLength": 128
},
"projectId": {
"type": "string",
"description": "A project id from get_live_relay_context.projects. Defaults to context.project.",
"minLength": 1,
"maxLength": 128
},
"captions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"destinationId": {
"type": "string",
"description": "The exact destination whose caption is changing.",
"minLength": 1,
"maxLength": 128
},
"caption": {
"type": "string",
"minLength": 1,
"maxLength": 2200
}
},
"required": [
"destinationId",
"caption"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 24
}
},
"required": [
"liveEventId",
"destinationIds",
"brief",
"idempotencyKey"
],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}get_live_relayAnswer
Read the current relay revision, honest generation progress, usable media readiness, previews, fit checks, queue state, and revision-bound approval.
View tool JSON
{
"name": "get_live_relay",
"kind": "answer",
"impl": "imperative",
"description": "Read the current relay revision, honest generation progress, usable media readiness, previews, fit checks, queue state, and revision-bound approval.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"relayId": {
"type": "string",
"description": "The relay identifier returned by draft_live_relay.",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"relayId"
],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}revise_live_relayAction
Create a new relay revision from explicit changes. This invalidates any approval for the previous revision and never publishes externally.
View tool JSON
{
"name": "revise_live_relay",
"kind": "act",
"impl": "imperative",
"description": "Create a new relay revision from explicit changes. This invalidates any approval for the previous revision and never publishes externally.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"relayId": {
"type": "string",
"description": "The relay identifier.",
"minLength": 1,
"maxLength": 128
},
"baseRevision": {
"type": "integer",
"minimum": 1
},
"changes": {
"type": "object",
"properties": {
"cta": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"tone": {
"type": "string",
"enum": [
"high_energy",
"warm",
"urgent",
"informative"
]
},
"hook": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"captions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"destinationId": {
"type": "string",
"description": "The exact destination whose caption is changing.",
"minLength": 1,
"maxLength": 128
},
"caption": {
"type": "string",
"minLength": 1,
"maxLength": 2200
}
},
"required": [
"destinationId",
"caption"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 24
},
"destinationIds": {
"type": "array",
"description": "Exact connected destination/account identifiers shown on the current board.",
"items": {
"type": "string",
"description": "A destination identifier returned by get_live_relay_context.",
"minLength": 1,
"maxLength": 128
},
"minItems": 1,
"maxItems": 24,
"uniqueItems": true
},
"regenerateVideo": {
"type": "boolean"
}
},
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"relayId",
"baseRevision",
"changes"
],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}queue_live_relayAction
Idempotently create review-required queue items for exact connected destination accounts. This never approves or publishes them externally.
View tool JSON
{
"name": "queue_live_relay",
"kind": "act",
"impl": "imperative",
"description": "Idempotently create review-required queue items for exact connected destination accounts. This never approves or publishes them externally.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"relayId": {
"type": "string",
"description": "The relay identifier.",
"minLength": 1,
"maxLength": 128
},
"revision": {
"type": "integer",
"minimum": 1
},
"destinationIds": {
"type": "array",
"description": "Exact connected destination/account identifiers shown on the current board.",
"items": {
"type": "string",
"description": "A destination identifier returned by get_live_relay_context.",
"minLength": 1,
"maxLength": 128
},
"minItems": 1,
"maxItems": 24,
"uniqueItems": true
}
},
"required": [
"relayId",
"revision",
"destinationIds"
],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}release_live_relaySensitive Action
Consequentially publish only the exact queue items covered by an explicit visible UI approval token for this revision. Retries with the same key never create duplicate posts.
View tool JSON
{
"name": "release_live_relay",
"kind": "transact",
"impl": "imperative",
"description": "Consequentially publish only the exact queue items covered by an explicit visible UI approval token for this revision. Retries with the same key never create duplicate posts.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"relayId": {
"type": "string",
"description": "The relay identifier.",
"minLength": 1,
"maxLength": 128
},
"revision": {
"type": "integer",
"minimum": 1
},
"queueItemIds": {
"type": "array",
"description": "Exact review queue item identifiers covered by the visible approval.",
"items": {
"type": "string",
"description": "A queue item identifier returned by queue_live_relay.",
"minLength": 1,
"maxLength": 128
},
"minItems": 1,
"maxItems": 24,
"uniqueItems": true
},
"approved": {
"type": "boolean",
"const": true,
"description": "Must be true and correspond to the creator's visible approval action."
},
"approvalToken": {
"type": "string",
"minLength": 8,
"maxLength": 256,
"description": "Revision-bound token issued only by recordUiApproval in the visible UI."
},
"idempotencyKey": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"description": "Stable retry key for this exact release payload."
}
},
"required": [
"relayId",
"revision",
"queueItemIds",
"approved",
"approvalToken",
"idempotencyKey"
],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}get_live_relay_statusAnswer
Read independent per-destination publishing states, post receipts (marked simulated on the reference board), and actionable failures for an exact relay revision.
View tool JSON
{
"name": "get_live_relay_status",
"kind": "answer",
"impl": "imperative",
"description": "Read independent per-destination publishing states, post receipts (marked simulated on the reference board), and actionable failures for an exact relay revision.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"relayId": {
"type": "string",
"description": "The relay identifier.",
"minLength": 1,
"maxLength": 128
},
"revision": {
"type": "integer",
"minimum": 1
}
},
"required": [
"relayId",
"revision"
],
"additionalProperties": false
},
"page": "/en/webmcp-live-relay"
}