@vocalstack/mcp 0.0.0-stage → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +105 -2
- package/dist/api.js +112 -0
- package/dist/args.js +90 -0
- package/dist/errors.js +39 -0
- package/dist/handlers.js +835 -0
- package/dist/index.js +55 -0
- package/dist/result.js +59 -0
- package/dist/server.js +49 -0
- package/dist/tools.json +847 -0
- package/package.json +49 -4
package/dist/tools.json
ADDED
|
@@ -0,0 +1,847 @@
|
|
|
1
|
+
{
|
|
2
|
+
"instructions": "VocalStack transcribes and translates recorded or live audio and video in about 100 languages, with speaker labels. Recorded: transcribe_url (a public link) or transcribe_file (base64, up to 10 MiB) returns a transcriptionId at once; wait_for_transcription until state is \"done\" (call again while timedOut is true); get_transcription reads the text (next page: offset = nextOffset). Find: list_transcriptions (ids, newest first), search_transcriptions (exact words or names), search_by_meaning (a question, any language). One transcription: get_summary (overview), translate_transcription (whole text in another language), rename_speaker (name \"Speaker N\"), set_cloned_voices (spoken translations in each speaker's own voice, with their consent), delete_transcription (to the trash, restorable for 30 days). Live: start_broadcast transcribes a live stream on a public link where listeners follow it in their own language; get_transcription reads it as it runs; stop_broadcast ends it; list_broadcasts and get_broadcast show broadcasts. Reference: list_voices (voices per language), list_speakers (saved people). Cost: only transcription is billed, per second of audio; everything else, and listening, is free. Retry a start with the same idempotencyKey. Errors are tool results with isError true: error (not_found, invalid_options, invalid_state, forbidden, insufficient_credit, rate_limited), message, retryable, and retryAfterS or topUpUrl when they apply.",
|
|
3
|
+
"tools": [
|
|
4
|
+
{
|
|
5
|
+
"name": "transcribe_url",
|
|
6
|
+
"title": "Transcribe a link",
|
|
7
|
+
"description": "Start transcribing a recorded audio or video at a public link: a media file, a podcast episode, a YouTube video, or a public post on one of the sites listed under url. Use transcribe_file for a file you hold (up to 10 MiB) and start_broadcast for a live stream, which this tool refuses. Billed per second of audio transcribed (only startS to endS when set); a refused call costs nothing. Each call creates and bills a new transcription unless it repeats an idempotencyKey. Returns at once, before any text: transcriptionId, state (\"queued\", then \"fetching\", \"transcribing\", and finally \"done\", \"failed\" or \"stopped\"), progress, and shareUrl when shareLink is true; next call wait_for_transcription. Errors: invalid_options (not a public http(s) link), insufficient_credit (with topUpUrl), quota_exceeded, rate_limited; a link that cannot be read ends in state \"failed\" with error.",
|
|
8
|
+
"inputSchema": {
|
|
9
|
+
"additionalProperties": false,
|
|
10
|
+
"properties": {
|
|
11
|
+
"endS": {
|
|
12
|
+
"description": "Transcribe only up to this second (default: the end); at least 0.5 s after startS. Only the part transcribed is billed.",
|
|
13
|
+
"examples": [
|
|
14
|
+
600
|
|
15
|
+
],
|
|
16
|
+
"type": "number"
|
|
17
|
+
},
|
|
18
|
+
"idempotencyKey": {
|
|
19
|
+
"description": "Any unique string of visible ASCII. Send the same key with the same arguments when retrying: for 24 h the first result comes back (with replayed true) and nothing is created or billed twice.",
|
|
20
|
+
"examples": [
|
|
21
|
+
"meeting-2026-11-19"
|
|
22
|
+
],
|
|
23
|
+
"maxLength": 255,
|
|
24
|
+
"type": "string"
|
|
25
|
+
},
|
|
26
|
+
"name": {
|
|
27
|
+
"description": "Display name shown in lists and on the share page. Defaults to the file name or the link.",
|
|
28
|
+
"examples": [
|
|
29
|
+
"Weekly team call"
|
|
30
|
+
],
|
|
31
|
+
"maxLength": 200,
|
|
32
|
+
"type": "string"
|
|
33
|
+
},
|
|
34
|
+
"shareLink": {
|
|
35
|
+
"default": false,
|
|
36
|
+
"description": "Make a public link anyone can open to read the transcript, without signing in (shareUrl in the result). Off (the default): the transcription stays private to this account.",
|
|
37
|
+
"type": "boolean"
|
|
38
|
+
},
|
|
39
|
+
"speakerLabels": {
|
|
40
|
+
"default": "auto",
|
|
41
|
+
"description": "Label who is speaking: auto (the default) labels lines once a second speaker is heard, on labels every line, off none. Recordings under a minute are never labelled.",
|
|
42
|
+
"enum": [
|
|
43
|
+
"auto",
|
|
44
|
+
"on",
|
|
45
|
+
"off"
|
|
46
|
+
]
|
|
47
|
+
},
|
|
48
|
+
"spokenLanguage": {
|
|
49
|
+
"description": "Code of the language spoken, e.g. en, ro, es. Omit to detect it (recordings that switch language are handled too); set it when you know it, for better accuracy on short or noisy audio.",
|
|
50
|
+
"examples": [
|
|
51
|
+
"en",
|
|
52
|
+
"es"
|
|
53
|
+
],
|
|
54
|
+
"type": "string"
|
|
55
|
+
},
|
|
56
|
+
"startS": {
|
|
57
|
+
"description": "Transcribe only from this second of the recording (default: the start). Only the part transcribed is billed.",
|
|
58
|
+
"examples": [
|
|
59
|
+
90
|
|
60
|
+
],
|
|
61
|
+
"minimum": 0,
|
|
62
|
+
"type": "number"
|
|
63
|
+
},
|
|
64
|
+
"summary": {
|
|
65
|
+
"default": false,
|
|
66
|
+
"description": "Also write a title and summary once it is done, at no extra cost (get_summary reads it; asking get_summary later writes one anyway). Never for a transcription under a minute.",
|
|
67
|
+
"type": "boolean"
|
|
68
|
+
},
|
|
69
|
+
"url": {
|
|
70
|
+
"description": "Public http(s) link to an audio or video file, a YouTube video, or a public recording on Twitch, Facebook, Instagram, Vimeo, Dailymotion, TikTok, X, SoundCloud, Kick, Mixcloud, Bandcamp, LinkedIn, TED, Internet Archive, Streamable, Odysee, Niconico, VK, BitChute, Wistia, Vidyard, Kaltura, JW Player, Pinterest, Bluesky, Google Drive, Dropbox, Spreaker, iHeartRadio, Audioboom, CNN or Loom. It must open without signing in. Live streams are not accepted here (use start_broadcast).",
|
|
71
|
+
"examples": [
|
|
72
|
+
"https://www.youtube.com/watch?v=jNQXAC9IVRw",
|
|
73
|
+
"https://example.com/episode-12.mp3"
|
|
74
|
+
],
|
|
75
|
+
"format": "uri",
|
|
76
|
+
"maxLength": 2048,
|
|
77
|
+
"type": "string"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"required": [
|
|
81
|
+
"url"
|
|
82
|
+
],
|
|
83
|
+
"type": "object"
|
|
84
|
+
},
|
|
85
|
+
"annotations": {
|
|
86
|
+
"title": "Transcribe a link",
|
|
87
|
+
"readOnlyHint": false,
|
|
88
|
+
"destructiveHint": false,
|
|
89
|
+
"idempotentHint": false,
|
|
90
|
+
"openWorldHint": true
|
|
91
|
+
}
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
"name": "transcribe_file",
|
|
95
|
+
"title": "Transcribe a file",
|
|
96
|
+
"description": "Start transcribing an audio or video file you hold, sent whole as base64 (at most 10 MiB decoded; mp3, m4a, wav, mp4, webm and other common formats). Use transcribe_url for a larger file or one already online, and start_broadcast for a live stream. Billed per second of audio transcribed (only startS to endS when set); a refused call costs nothing. Each call creates and bills a new transcription unless it repeats an idempotencyKey. Returns at once, before any text: transcriptionId, state (\"queued\", \"transcribing\", then \"done\", \"failed\" or \"stopped\"), progress, and shareUrl when shareLink is true; next call wait_for_transcription. The transcriptionId stays valid until the transcription is deleted. Errors: invalid_options (bad base64, over 10 MiB), invalid_audio (empty file), insufficient_credit (with topUpUrl), quota_exceeded, rate_limited; audio that cannot be decoded ends in state \"failed\" with error.",
|
|
97
|
+
"inputSchema": {
|
|
98
|
+
"additionalProperties": false,
|
|
99
|
+
"properties": {
|
|
100
|
+
"endS": {
|
|
101
|
+
"description": "Transcribe only up to this second (default: the end); at least 0.5 s after startS. Only the part transcribed is billed.",
|
|
102
|
+
"examples": [
|
|
103
|
+
600
|
|
104
|
+
],
|
|
105
|
+
"type": "number"
|
|
106
|
+
},
|
|
107
|
+
"fileBase64": {
|
|
108
|
+
"contentEncoding": "base64",
|
|
109
|
+
"description": "The whole file, standard base64 (a data: URL prefix and line breaks are accepted). At most 10 MiB decoded; for a larger file use transcribe_url with a link to it.",
|
|
110
|
+
"type": "string"
|
|
111
|
+
},
|
|
112
|
+
"filename": {
|
|
113
|
+
"description": "The file's name, with its extension; also the default display name.",
|
|
114
|
+
"examples": [
|
|
115
|
+
"meeting.m4a"
|
|
116
|
+
],
|
|
117
|
+
"maxLength": 255,
|
|
118
|
+
"type": "string"
|
|
119
|
+
},
|
|
120
|
+
"idempotencyKey": {
|
|
121
|
+
"description": "Any unique string of visible ASCII. Send the same key with the same arguments when retrying: for 24 h the first result comes back (with replayed true) and nothing is created or billed twice.",
|
|
122
|
+
"examples": [
|
|
123
|
+
"meeting-2026-11-19"
|
|
124
|
+
],
|
|
125
|
+
"maxLength": 255,
|
|
126
|
+
"type": "string"
|
|
127
|
+
},
|
|
128
|
+
"mimeType": {
|
|
129
|
+
"description": "The file's media type, when known. Optional: the format is read from the file itself.",
|
|
130
|
+
"examples": [
|
|
131
|
+
"audio/mpeg",
|
|
132
|
+
"video/mp4"
|
|
133
|
+
],
|
|
134
|
+
"type": "string"
|
|
135
|
+
},
|
|
136
|
+
"name": {
|
|
137
|
+
"description": "Display name shown in lists and on the share page. Defaults to the file name or the link.",
|
|
138
|
+
"examples": [
|
|
139
|
+
"Weekly team call"
|
|
140
|
+
],
|
|
141
|
+
"maxLength": 200,
|
|
142
|
+
"type": "string"
|
|
143
|
+
},
|
|
144
|
+
"shareLink": {
|
|
145
|
+
"default": false,
|
|
146
|
+
"description": "Make a public link anyone can open to read the transcript, without signing in (shareUrl in the result). Off (the default): the transcription stays private to this account.",
|
|
147
|
+
"type": "boolean"
|
|
148
|
+
},
|
|
149
|
+
"speakerLabels": {
|
|
150
|
+
"default": "auto",
|
|
151
|
+
"description": "Label who is speaking: auto (the default) labels lines once a second speaker is heard, on labels every line, off none. Recordings under a minute are never labelled.",
|
|
152
|
+
"enum": [
|
|
153
|
+
"auto",
|
|
154
|
+
"on",
|
|
155
|
+
"off"
|
|
156
|
+
]
|
|
157
|
+
},
|
|
158
|
+
"spokenLanguage": {
|
|
159
|
+
"description": "Code of the language spoken, e.g. en, ro, es. Omit to detect it (recordings that switch language are handled too); set it when you know it, for better accuracy on short or noisy audio.",
|
|
160
|
+
"examples": [
|
|
161
|
+
"en",
|
|
162
|
+
"es"
|
|
163
|
+
],
|
|
164
|
+
"type": "string"
|
|
165
|
+
},
|
|
166
|
+
"startS": {
|
|
167
|
+
"description": "Transcribe only from this second of the recording (default: the start). Only the part transcribed is billed.",
|
|
168
|
+
"examples": [
|
|
169
|
+
90
|
|
170
|
+
],
|
|
171
|
+
"minimum": 0,
|
|
172
|
+
"type": "number"
|
|
173
|
+
},
|
|
174
|
+
"summary": {
|
|
175
|
+
"default": false,
|
|
176
|
+
"description": "Also write a title and summary once it is done, at no extra cost (get_summary reads it; asking get_summary later writes one anyway). Never for a transcription under a minute.",
|
|
177
|
+
"type": "boolean"
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
"required": [
|
|
181
|
+
"filename",
|
|
182
|
+
"fileBase64"
|
|
183
|
+
],
|
|
184
|
+
"type": "object"
|
|
185
|
+
},
|
|
186
|
+
"annotations": {
|
|
187
|
+
"title": "Transcribe a file",
|
|
188
|
+
"readOnlyHint": false,
|
|
189
|
+
"destructiveHint": false,
|
|
190
|
+
"idempotentHint": false,
|
|
191
|
+
"openWorldHint": false
|
|
192
|
+
}
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
"name": "get_transcription",
|
|
196
|
+
"title": "Read a transcription",
|
|
197
|
+
"description": "Read one transcription's text, with timestamps and speakers, and its status. Use it once wait_for_transcription reports \"done\", or at any time on a live transcription for the text so far. For another language use translate_transcription, for an overview get_summary, to find a passage across transcriptions search_transcriptions. Read-only and free. format \"text\" (default) gives lines like \"[mm:ss] Speaker 1: words\"; \"segments\" gives start, end, text, speakerNumber and speakerName per line (each word's timing too with includeWords); \"none\" gives the status only. Returns status (state, progress, error when it failed), segmentCount, and the text or segments; partial is true while text is still coming. Long transcripts come in pages of limit segments (default 500): when the result has nextOffset, call again with offset set to that value. Unknown id: not_found.",
|
|
198
|
+
"inputSchema": {
|
|
199
|
+
"additionalProperties": false,
|
|
200
|
+
"properties": {
|
|
201
|
+
"format": {
|
|
202
|
+
"default": "text",
|
|
203
|
+
"description": "text (the default): one readable string, a line per segment as \"[mm:ss] Speaker 1: words\", best for reading or quoting; segments: an array of timed lines, best for subtitles or exact times; none: status only, no text.",
|
|
204
|
+
"enum": [
|
|
205
|
+
"text",
|
|
206
|
+
"segments",
|
|
207
|
+
"none"
|
|
208
|
+
]
|
|
209
|
+
},
|
|
210
|
+
"includeWords": {
|
|
211
|
+
"default": false,
|
|
212
|
+
"description": "With format segments, also return each word with its start and end second. Off by default: it makes the answer several times larger.",
|
|
213
|
+
"type": "boolean"
|
|
214
|
+
},
|
|
215
|
+
"limit": {
|
|
216
|
+
"default": 500,
|
|
217
|
+
"description": "Most segments to return in one call (default 500). When more are left the result has nextOffset; ask again with offset set to it.",
|
|
218
|
+
"examples": [
|
|
219
|
+
200
|
|
220
|
+
],
|
|
221
|
+
"maximum": 2000,
|
|
222
|
+
"minimum": 1,
|
|
223
|
+
"type": "integer"
|
|
224
|
+
},
|
|
225
|
+
"offset": {
|
|
226
|
+
"default": 0,
|
|
227
|
+
"description": "Index of the first segment to return (default 0, the start). To page, pass the nextOffset the previous call returned.",
|
|
228
|
+
"examples": [
|
|
229
|
+
500
|
|
230
|
+
],
|
|
231
|
+
"minimum": 0,
|
|
232
|
+
"type": "integer"
|
|
233
|
+
},
|
|
234
|
+
"transcriptionId": {
|
|
235
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
236
|
+
"examples": [
|
|
237
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
238
|
+
],
|
|
239
|
+
"format": "uuid",
|
|
240
|
+
"type": "string"
|
|
241
|
+
}
|
|
242
|
+
},
|
|
243
|
+
"required": [
|
|
244
|
+
"transcriptionId"
|
|
245
|
+
],
|
|
246
|
+
"type": "object"
|
|
247
|
+
},
|
|
248
|
+
"annotations": {
|
|
249
|
+
"title": "Read a transcription",
|
|
250
|
+
"readOnlyHint": true,
|
|
251
|
+
"destructiveHint": false,
|
|
252
|
+
"idempotentHint": true,
|
|
253
|
+
"openWorldHint": false
|
|
254
|
+
}
|
|
255
|
+
},
|
|
256
|
+
{
|
|
257
|
+
"name": "wait_for_transcription",
|
|
258
|
+
"title": "Wait for a transcription",
|
|
259
|
+
"description": "Wait until a file or link transcription finishes, up to timeoutS seconds (default 50, at most 60), and return its status without the text. Use it after transcribe_url or transcribe_file instead of calling get_transcription in a loop. Read-only and free; clients that send a progress token get progress notifications. Returns transcriptionId, state, progress (pct, processedS, totalS), error when it failed, and timedOut. timedOut true means it is still running: call again. State \"done\": read the text with get_transcription; \"failed\": error says why. A live transcription runs until stopped, so for one this returns its status at once. Errors: not_found; rate_limited past 4 open waits per key (8 per account).",
|
|
260
|
+
"inputSchema": {
|
|
261
|
+
"additionalProperties": false,
|
|
262
|
+
"properties": {
|
|
263
|
+
"timeoutS": {
|
|
264
|
+
"default": 50,
|
|
265
|
+
"description": "Longest to wait in this call, in seconds (default 50, at most 60). It returns sooner when the transcription finishes; otherwise it returns with timedOut true and you call it again. Lower it if your client gives up on calls sooner.",
|
|
266
|
+
"examples": [
|
|
267
|
+
30
|
|
268
|
+
],
|
|
269
|
+
"maximum": 60,
|
|
270
|
+
"minimum": 1,
|
|
271
|
+
"type": "integer"
|
|
272
|
+
},
|
|
273
|
+
"transcriptionId": {
|
|
274
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
275
|
+
"examples": [
|
|
276
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
277
|
+
],
|
|
278
|
+
"format": "uuid",
|
|
279
|
+
"type": "string"
|
|
280
|
+
}
|
|
281
|
+
},
|
|
282
|
+
"required": [
|
|
283
|
+
"transcriptionId"
|
|
284
|
+
],
|
|
285
|
+
"type": "object"
|
|
286
|
+
},
|
|
287
|
+
"annotations": {
|
|
288
|
+
"title": "Wait for a transcription",
|
|
289
|
+
"readOnlyHint": true,
|
|
290
|
+
"destructiveHint": false,
|
|
291
|
+
"idempotentHint": true,
|
|
292
|
+
"openWorldHint": false
|
|
293
|
+
}
|
|
294
|
+
},
|
|
295
|
+
{
|
|
296
|
+
"name": "list_transcriptions",
|
|
297
|
+
"title": "List transcriptions",
|
|
298
|
+
"description": "List this account's transcriptions (files, links and live ones, including those recorded by broadcasts), newest first, one page at a time. Use it to find a transcriptionId or see what exists; to find what was said use search_transcriptions (exact words) or search_by_meaning (a question); for broadcasts use list_broadcasts. Read-only and free. lifecycle: active (default), archived (deleted, restorable for 30 days) or all. Returns transcriptions, each with transcriptionId, name, createdAt, kind (\"file\" or \"live\"), state, durationS and title when known, and broadcastId for a broadcast's live transcription; plus nextCursor when more remain: pass it back as cursor. None: an empty list.",
|
|
299
|
+
"inputSchema": {
|
|
300
|
+
"additionalProperties": false,
|
|
301
|
+
"properties": {
|
|
302
|
+
"cursor": {
|
|
303
|
+
"description": "Omit for the first page (the newest). For the next page, pass the nextCursor the previous call returned, unchanged.",
|
|
304
|
+
"type": "string"
|
|
305
|
+
},
|
|
306
|
+
"lifecycle": {
|
|
307
|
+
"default": "active",
|
|
308
|
+
"description": "Which transcriptions to list: active (the default) those in use; archived those in the trash; all both.",
|
|
309
|
+
"enum": [
|
|
310
|
+
"active",
|
|
311
|
+
"archived",
|
|
312
|
+
"all"
|
|
313
|
+
]
|
|
314
|
+
},
|
|
315
|
+
"limit": {
|
|
316
|
+
"default": 20,
|
|
317
|
+
"description": "Most transcriptions in one page (default 20, at most 100). nextCursor in the result means there are more.",
|
|
318
|
+
"examples": [
|
|
319
|
+
50
|
|
320
|
+
],
|
|
321
|
+
"maximum": 100,
|
|
322
|
+
"minimum": 1,
|
|
323
|
+
"type": "integer"
|
|
324
|
+
}
|
|
325
|
+
},
|
|
326
|
+
"type": "object"
|
|
327
|
+
},
|
|
328
|
+
"annotations": {
|
|
329
|
+
"title": "List transcriptions",
|
|
330
|
+
"readOnlyHint": true,
|
|
331
|
+
"destructiveHint": false,
|
|
332
|
+
"idempotentHint": true,
|
|
333
|
+
"openWorldHint": false
|
|
334
|
+
}
|
|
335
|
+
},
|
|
336
|
+
{
|
|
337
|
+
"name": "search_transcriptions",
|
|
338
|
+
"title": "Search for words",
|
|
339
|
+
"description": "Find the lines where given words or a name were said, across all of this account's transcriptions or in one (transcriptionId). It matches the words themselves, allowing close spellings, and also searches the query's English translation. For a question or topic whose exact words you do not know use search_by_meaning; to read around a hit, get_transcription. Read-only and free. Returns up to limit hits (default 20, at most 50, no next page: narrow the query or set transcriptionId), best first: whole-word matches, then closest spelling, then newest. Each hit has transcriptionId, name, mediaStart (the second it was said), speaker, text, score, live and recordedAt, plus rendered (the line translated into lang) when lang is set; lang never changes what is searched. Also returns query and queryEn. No match: an empty hits list. Unknown transcriptionId: not_found.",
|
|
340
|
+
"inputSchema": {
|
|
341
|
+
"additionalProperties": false,
|
|
342
|
+
"properties": {
|
|
343
|
+
"lang": {
|
|
344
|
+
"description": "Optional language code, e.g. en: each hit also comes back translated into it, as rendered. It never changes what is searched or matched.",
|
|
345
|
+
"examples": [
|
|
346
|
+
"en",
|
|
347
|
+
"de"
|
|
348
|
+
],
|
|
349
|
+
"type": "string"
|
|
350
|
+
},
|
|
351
|
+
"limit": {
|
|
352
|
+
"default": 20,
|
|
353
|
+
"description": "Most matching lines to return, best first (default 20, at most 50). There is no next page: narrow the query or set transcriptionId instead.",
|
|
354
|
+
"examples": [
|
|
355
|
+
10
|
|
356
|
+
],
|
|
357
|
+
"maximum": 50,
|
|
358
|
+
"minimum": 1,
|
|
359
|
+
"type": "integer"
|
|
360
|
+
},
|
|
361
|
+
"query": {
|
|
362
|
+
"description": "Words, a phrase or a name that was said (2 to 200 characters), in any language.",
|
|
363
|
+
"examples": [
|
|
364
|
+
"quarterly budget",
|
|
365
|
+
"María"
|
|
366
|
+
],
|
|
367
|
+
"maxLength": 200,
|
|
368
|
+
"minLength": 2,
|
|
369
|
+
"type": "string"
|
|
370
|
+
},
|
|
371
|
+
"transcriptionId": {
|
|
372
|
+
"description": "Optional: search only this transcription (a transcriptionId from list_transcriptions or a transcribe tool). Omit to search all of this account's transcriptions.",
|
|
373
|
+
"examples": [
|
|
374
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
375
|
+
],
|
|
376
|
+
"format": "uuid",
|
|
377
|
+
"type": "string"
|
|
378
|
+
}
|
|
379
|
+
},
|
|
380
|
+
"required": [
|
|
381
|
+
"query"
|
|
382
|
+
],
|
|
383
|
+
"type": "object"
|
|
384
|
+
},
|
|
385
|
+
"annotations": {
|
|
386
|
+
"title": "Search for words",
|
|
387
|
+
"readOnlyHint": true,
|
|
388
|
+
"destructiveHint": false,
|
|
389
|
+
"idempotentHint": true,
|
|
390
|
+
"openWorldHint": false
|
|
391
|
+
}
|
|
392
|
+
},
|
|
393
|
+
{
|
|
394
|
+
"name": "search_by_meaning",
|
|
395
|
+
"title": "Search by meaning",
|
|
396
|
+
"description": "Find the passages closest in meaning to a question or topic, across this account's transcriptions or in one (transcriptionId), in any language and even when they share none of its words. Use it to answer questions about what was said; use search_transcriptions for exact words or a name, and get_summary for an overview of one transcription. Read-only and free; limited per hour on some plans (searchesLeftThisHour; past it, rate_limited). Returns up to 10 passages, closest first, each with transcriptionId, name, mediaStart and mediaEnd (seconds), text, similarity (0 to 1) and live; state is \"ready\", or \"unavailable\"/\"off\" with no passages when this search cannot run. Nothing close: an empty list. Cite the transcription and second when answering. Unknown transcriptionId: not_found.",
|
|
397
|
+
"inputSchema": {
|
|
398
|
+
"additionalProperties": false,
|
|
399
|
+
"properties": {
|
|
400
|
+
"query": {
|
|
401
|
+
"description": "A question or topic in plain words (2 to 200 characters), in any language.",
|
|
402
|
+
"examples": [
|
|
403
|
+
"What did they decide about hiring?",
|
|
404
|
+
"pricing complaints"
|
|
405
|
+
],
|
|
406
|
+
"maxLength": 200,
|
|
407
|
+
"minLength": 2,
|
|
408
|
+
"type": "string"
|
|
409
|
+
},
|
|
410
|
+
"transcriptionId": {
|
|
411
|
+
"description": "Optional: search only this transcription (a transcriptionId from list_transcriptions or a transcribe tool). Omit to search all of this account's transcriptions.",
|
|
412
|
+
"examples": [
|
|
413
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
414
|
+
],
|
|
415
|
+
"format": "uuid",
|
|
416
|
+
"type": "string"
|
|
417
|
+
}
|
|
418
|
+
},
|
|
419
|
+
"required": [
|
|
420
|
+
"query"
|
|
421
|
+
],
|
|
422
|
+
"type": "object"
|
|
423
|
+
},
|
|
424
|
+
"annotations": {
|
|
425
|
+
"title": "Search by meaning",
|
|
426
|
+
"readOnlyHint": true,
|
|
427
|
+
"destructiveHint": false,
|
|
428
|
+
"idempotentHint": true,
|
|
429
|
+
"openWorldHint": false
|
|
430
|
+
}
|
|
431
|
+
},
|
|
432
|
+
{
|
|
433
|
+
"name": "get_summary",
|
|
434
|
+
"title": "Get a summary",
|
|
435
|
+
"description": "Get the title and summary of a finished transcription. Use it for an overview; get_transcription gives the full text, search_by_meaning answers a specific question, translate_transcription translates the whole text. Free. When there is no summary yet, the first call writes one and keeps it (this needs the write scope; reading an existing one needs only read). Returns state: \"ready\" with title and summary (and lang when translated); \"pending\" while it is being written or the transcription is still running: call again in a few seconds; \"not_requested\" for recordings under a minute, which are never summarised; \"unavailable\" when the transcription failed. lang translates the summary only when the transcription has summary translations on; otherwise the original comes back without lang. Unknown id: not_found.",
|
|
436
|
+
"inputSchema": {
|
|
437
|
+
"additionalProperties": false,
|
|
438
|
+
"properties": {
|
|
439
|
+
"lang": {
|
|
440
|
+
"description": "Optional language code to have the title and summary translated into, when the transcription was made with summary translations on; otherwise the original comes back.",
|
|
441
|
+
"examples": [
|
|
442
|
+
"fr"
|
|
443
|
+
],
|
|
444
|
+
"type": "string"
|
|
445
|
+
},
|
|
446
|
+
"transcriptionId": {
|
|
447
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
448
|
+
"examples": [
|
|
449
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
450
|
+
],
|
|
451
|
+
"format": "uuid",
|
|
452
|
+
"type": "string"
|
|
453
|
+
}
|
|
454
|
+
},
|
|
455
|
+
"required": [
|
|
456
|
+
"transcriptionId"
|
|
457
|
+
],
|
|
458
|
+
"type": "object"
|
|
459
|
+
},
|
|
460
|
+
"annotations": {
|
|
461
|
+
"title": "Get a summary",
|
|
462
|
+
"readOnlyHint": false,
|
|
463
|
+
"destructiveHint": false,
|
|
464
|
+
"idempotentHint": true,
|
|
465
|
+
"openWorldHint": false
|
|
466
|
+
}
|
|
467
|
+
},
|
|
468
|
+
{
|
|
469
|
+
"name": "translate_transcription",
|
|
470
|
+
"title": "Translate a transcription",
|
|
471
|
+
"description": "Get a whole finished transcription translated into another language, in the same text or segments shape as get_transcription. Use get_transcription for the original language, get_summary with lang for a translated overview, and search_transcriptions with lang to translate only matching lines. Needs state \"done\" for a file or link, or a stopped live transcription; earlier it gives invalid_state (read the text so far with get_transcription). Free. The first call for a language can take up to a minute on a long transcription; the translation is kept, so later calls are quick. Returns lang, translated (false when it is already in that language), segmentCount, text or segments (start, end, text, speakerNumber, speakerName), and nextOffset when more remain: call again with offset set to it (limit segments per call, default 500). Unsupported lang: invalid_options; unknown id: not_found.",
|
|
472
|
+
"inputSchema": {
|
|
473
|
+
"additionalProperties": false,
|
|
474
|
+
"properties": {
|
|
475
|
+
"format": {
|
|
476
|
+
"default": "text",
|
|
477
|
+
"description": "text (the default): one readable string, a line per segment as \"[mm:ss] Speaker 1: words\"; segments: an array of timed lines (start, end, speaker, text), best for subtitles.",
|
|
478
|
+
"enum": [
|
|
479
|
+
"text",
|
|
480
|
+
"segments"
|
|
481
|
+
]
|
|
482
|
+
},
|
|
483
|
+
"lang": {
|
|
484
|
+
"description": "Code of the language to translate into, one of about 100 (e.g. es, de, ja, zh, pt).",
|
|
485
|
+
"examples": [
|
|
486
|
+
"es",
|
|
487
|
+
"ja"
|
|
488
|
+
],
|
|
489
|
+
"type": "string"
|
|
490
|
+
},
|
|
491
|
+
"limit": {
|
|
492
|
+
"default": 500,
|
|
493
|
+
"description": "Most segments to return in one call (default 500). When more are left the result has nextOffset; ask again with offset set to it.",
|
|
494
|
+
"examples": [
|
|
495
|
+
200
|
|
496
|
+
],
|
|
497
|
+
"maximum": 2000,
|
|
498
|
+
"minimum": 1,
|
|
499
|
+
"type": "integer"
|
|
500
|
+
},
|
|
501
|
+
"offset": {
|
|
502
|
+
"default": 0,
|
|
503
|
+
"description": "Index of the first segment to return (default 0, the start). To page, pass the nextOffset the previous call returned.",
|
|
504
|
+
"examples": [
|
|
505
|
+
500
|
|
506
|
+
],
|
|
507
|
+
"minimum": 0,
|
|
508
|
+
"type": "integer"
|
|
509
|
+
},
|
|
510
|
+
"transcriptionId": {
|
|
511
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
512
|
+
"examples": [
|
|
513
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
514
|
+
],
|
|
515
|
+
"format": "uuid",
|
|
516
|
+
"type": "string"
|
|
517
|
+
}
|
|
518
|
+
},
|
|
519
|
+
"required": [
|
|
520
|
+
"transcriptionId",
|
|
521
|
+
"lang"
|
|
522
|
+
],
|
|
523
|
+
"type": "object"
|
|
524
|
+
},
|
|
525
|
+
"annotations": {
|
|
526
|
+
"title": "Translate a transcription",
|
|
527
|
+
"readOnlyHint": false,
|
|
528
|
+
"destructiveHint": false,
|
|
529
|
+
"idempotentHint": true,
|
|
530
|
+
"openWorldHint": false
|
|
531
|
+
}
|
|
532
|
+
},
|
|
533
|
+
{
|
|
534
|
+
"name": "rename_speaker",
|
|
535
|
+
"title": "Rename a speaker",
|
|
536
|
+
"description": "Name a speaker in one transcription, so its transcript shows the name instead of \"Speaker N\". speaker is the N that get_transcription shows (speakerNumber in its segments). The name applies to that person in every recording of the transcription, and listeners following it live see it at once. It names them in this transcription only: it does not add them to the account's saved speakers (list_speakers). An empty name clears it back to \"Speaker N\". Free; repeating a call changes nothing. Returns transcriptionId, speaker and name (null when cleared). Errors: not_found for an unknown transcription or a speaker number it does not have; forbidden for a read-only key.",
|
|
537
|
+
"inputSchema": {
|
|
538
|
+
"additionalProperties": false,
|
|
539
|
+
"properties": {
|
|
540
|
+
"name": {
|
|
541
|
+
"description": "The name to show instead of \"Speaker N\" (at most 80 characters). An empty string clears it back to \"Speaker N\".",
|
|
542
|
+
"examples": [
|
|
543
|
+
"Maria Lopez"
|
|
544
|
+
],
|
|
545
|
+
"maxLength": 80,
|
|
546
|
+
"type": "string"
|
|
547
|
+
},
|
|
548
|
+
"speaker": {
|
|
549
|
+
"description": "The speaker's number: the N of \"Speaker N\" in get_transcription's text, or speakerNumber in its segments (also there once the speaker has a name).",
|
|
550
|
+
"examples": [
|
|
551
|
+
2
|
|
552
|
+
],
|
|
553
|
+
"minimum": 1,
|
|
554
|
+
"type": "integer"
|
|
555
|
+
},
|
|
556
|
+
"transcriptionId": {
|
|
557
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
558
|
+
"examples": [
|
|
559
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
560
|
+
],
|
|
561
|
+
"format": "uuid",
|
|
562
|
+
"type": "string"
|
|
563
|
+
}
|
|
564
|
+
},
|
|
565
|
+
"required": [
|
|
566
|
+
"transcriptionId",
|
|
567
|
+
"speaker",
|
|
568
|
+
"name"
|
|
569
|
+
],
|
|
570
|
+
"type": "object"
|
|
571
|
+
},
|
|
572
|
+
"annotations": {
|
|
573
|
+
"title": "Rename a speaker",
|
|
574
|
+
"readOnlyHint": false,
|
|
575
|
+
"destructiveHint": false,
|
|
576
|
+
"idempotentHint": true,
|
|
577
|
+
"openWorldHint": false
|
|
578
|
+
}
|
|
579
|
+
},
|
|
580
|
+
{
|
|
581
|
+
"name": "delete_transcription",
|
|
582
|
+
"title": "Delete a transcription",
|
|
583
|
+
"description": "Delete a transcription: it moves to the trash with its recordings, transcript, translations and summary, and its share links stop working. It can be restored for 30 days (Dashboard trash, or POST /v1/transcriptions/{id}/restore), then it is erased for good; list_transcriptions with lifecycle \"archived\" lists the trash. A file or link still being transcribed is stopped first. It refuses one that is recording live: stop it first (stop_broadcast for a broadcast). Deleting one already in the trash changes nothing. Returns transcriptionId, name, deleted, deletedAt and restorableUntil. Errors: invalid_state while recording live or when the transcription is locked; not_found for an unknown id; forbidden for a read-only key.",
|
|
584
|
+
"inputSchema": {
|
|
585
|
+
"additionalProperties": false,
|
|
586
|
+
"properties": {
|
|
587
|
+
"transcriptionId": {
|
|
588
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
589
|
+
"examples": [
|
|
590
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
591
|
+
],
|
|
592
|
+
"format": "uuid",
|
|
593
|
+
"type": "string"
|
|
594
|
+
}
|
|
595
|
+
},
|
|
596
|
+
"required": [
|
|
597
|
+
"transcriptionId"
|
|
598
|
+
],
|
|
599
|
+
"type": "object"
|
|
600
|
+
},
|
|
601
|
+
"annotations": {
|
|
602
|
+
"title": "Delete a transcription",
|
|
603
|
+
"readOnlyHint": false,
|
|
604
|
+
"destructiveHint": true,
|
|
605
|
+
"idempotentHint": true,
|
|
606
|
+
"openWorldHint": false
|
|
607
|
+
}
|
|
608
|
+
},
|
|
609
|
+
{
|
|
610
|
+
"name": "list_voices",
|
|
611
|
+
"title": "List voices",
|
|
612
|
+
"description": "List the voices that can read translations aloud in one language: stock voices and this account's own cloned voices. For information only: VocalStack picks the voice for each speaker and no tool takes a voice id; the only choice is cloned voices on or off per transcription (set_cloned_voices). For the people the account has saved, use list_speakers. Read-only and free. Returns lang and voices, each with id, name, default (used first), cloned, quality, gender and accent when known, and previewUrl (a short sample). A language with no voices: an empty list.",
|
|
613
|
+
"inputSchema": {
|
|
614
|
+
"additionalProperties": false,
|
|
615
|
+
"properties": {
|
|
616
|
+
"lang": {
|
|
617
|
+
"description": "Code of the language the voices should speak, e.g. en, ro, es.",
|
|
618
|
+
"examples": [
|
|
619
|
+
"en",
|
|
620
|
+
"ro"
|
|
621
|
+
],
|
|
622
|
+
"type": "string"
|
|
623
|
+
}
|
|
624
|
+
},
|
|
625
|
+
"required": [
|
|
626
|
+
"lang"
|
|
627
|
+
],
|
|
628
|
+
"type": "object"
|
|
629
|
+
},
|
|
630
|
+
"annotations": {
|
|
631
|
+
"title": "List voices",
|
|
632
|
+
"readOnlyHint": true,
|
|
633
|
+
"destructiveHint": false,
|
|
634
|
+
"idempotentHint": true,
|
|
635
|
+
"openWorldHint": false
|
|
636
|
+
}
|
|
637
|
+
},
|
|
638
|
+
{
|
|
639
|
+
"name": "set_cloned_voices",
|
|
640
|
+
"title": "Turn cloned voices on or off",
|
|
641
|
+
"description": "Turn cloned voices on or off for one transcription's spoken translations. On: each speaker's translated words are read in that speaker's own cloned voice, never anyone else's; a speaker without a usable clone is read in a stock voice. Off (the default): stock voices for everyone. This is the only voice choice; VocalStack picks the voices (list_voices shows them). Turning on needs consent: true, confirming everyone speaking agreed to have their voice cloned; it is recorded with your account and the time, and grants the clones in this transcription that were waiting for consent. Speakers who refused are never cloned. Free; setting the current value again changes nothing. Returns transcriptionId, name and clonedVoices. Errors: invalid_options without consent, invalid_state for a deleted transcription, not_found, forbidden for a read-only key.",
|
|
642
|
+
"inputSchema": {
|
|
643
|
+
"additionalProperties": false,
|
|
644
|
+
"properties": {
|
|
645
|
+
"consent": {
|
|
646
|
+
"default": false,
|
|
647
|
+
"description": "Required as true to turn cloned voices on: confirms everyone speaking agreed to have their voice cloned. Recorded with your account and the time. Not needed to turn them off.",
|
|
648
|
+
"type": "boolean"
|
|
649
|
+
},
|
|
650
|
+
"on": {
|
|
651
|
+
"description": "true: read each speaker's translated words in their own cloned voice; false (the default for every transcription): stock voices.",
|
|
652
|
+
"type": "boolean"
|
|
653
|
+
},
|
|
654
|
+
"transcriptionId": {
|
|
655
|
+
"description": "The transcriptionId that transcribe_url, transcribe_file, list_transcriptions, a search tool or start_broadcast returned.",
|
|
656
|
+
"examples": [
|
|
657
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
658
|
+
],
|
|
659
|
+
"format": "uuid",
|
|
660
|
+
"type": "string"
|
|
661
|
+
}
|
|
662
|
+
},
|
|
663
|
+
"required": [
|
|
664
|
+
"transcriptionId",
|
|
665
|
+
"on"
|
|
666
|
+
],
|
|
667
|
+
"type": "object"
|
|
668
|
+
},
|
|
669
|
+
"annotations": {
|
|
670
|
+
"title": "Turn cloned voices on or off",
|
|
671
|
+
"readOnlyHint": false,
|
|
672
|
+
"destructiveHint": false,
|
|
673
|
+
"idempotentHint": true,
|
|
674
|
+
"openWorldHint": false
|
|
675
|
+
}
|
|
676
|
+
},
|
|
677
|
+
{
|
|
678
|
+
"name": "list_speakers",
|
|
679
|
+
"title": "List saved speakers",
|
|
680
|
+
"description": "List the speakers this account has saved: people named once so they are recognised by name in later transcriptions. Use it to see who is known; names within one transcription come from get_transcription and are set with rename_speaker, which saves no one here; list_voices lists the voices for a language. Read-only and free; no arguments. Returns speakers, newest first, each with id, name, gender when known, cloned (their own voice was cloned to read translations of what they say) and, for cloned ones, voiceReady (ready, switched on and consented to). None saved: an empty list.",
|
|
681
|
+
"inputSchema": {
|
|
682
|
+
"additionalProperties": false,
|
|
683
|
+
"properties": {},
|
|
684
|
+
"type": "object"
|
|
685
|
+
},
|
|
686
|
+
"annotations": {
|
|
687
|
+
"title": "List saved speakers",
|
|
688
|
+
"readOnlyHint": true,
|
|
689
|
+
"destructiveHint": false,
|
|
690
|
+
"idempotentHint": true,
|
|
691
|
+
"openWorldHint": false
|
|
692
|
+
}
|
|
693
|
+
},
|
|
694
|
+
{
|
|
695
|
+
"name": "list_broadcasts",
|
|
696
|
+
"title": "List broadcasts",
|
|
697
|
+
"description": "List this account's broadcasts, most recently updated first (up to 500, no paging). A broadcast is a public link where listeners follow a live transcription in their own language. Use it to find a broadcastId for get_broadcast, start_broadcast or stop_broadcast, or to see which are on air; get_broadcast lists one broadcast's past transcriptions, which also appear in list_transcriptions. Read-only and free. lifecycle: active (default), archived (the trash; each marked archived) or all. Returns broadcasts, each with broadcastId, name, link, access, onAir, listenersNow, lastRecordedAt once it has recorded, and while on air transcriptionId (read it with get_transcription), state and onAirSince. None: an empty list.",
|
|
698
|
+
"inputSchema": {
|
|
699
|
+
"additionalProperties": false,
|
|
700
|
+
"properties": {
|
|
701
|
+
"lifecycle": {
|
|
702
|
+
"default": "active",
|
|
703
|
+
"description": "Which broadcasts to list: active (the default) those in use; archived those in the trash; all both.",
|
|
704
|
+
"enum": [
|
|
705
|
+
"active",
|
|
706
|
+
"archived",
|
|
707
|
+
"all"
|
|
708
|
+
]
|
|
709
|
+
}
|
|
710
|
+
},
|
|
711
|
+
"type": "object"
|
|
712
|
+
},
|
|
713
|
+
"annotations": {
|
|
714
|
+
"title": "List broadcasts",
|
|
715
|
+
"readOnlyHint": true,
|
|
716
|
+
"destructiveHint": false,
|
|
717
|
+
"idempotentHint": true,
|
|
718
|
+
"openWorldHint": false
|
|
719
|
+
}
|
|
720
|
+
},
|
|
721
|
+
{
|
|
722
|
+
"name": "get_broadcast",
|
|
723
|
+
"title": "Get a broadcast",
|
|
724
|
+
"description": "Get one broadcast in detail: whether it is on air, its public link, the transcriptions it recorded and the stream addresses it uses. Use it when you have a broadcastId and need more than list_broadcasts gives; read a transcription's text with get_transcription. Read-only and free. Returns broadcastId, name, link, access, onAir, listenersNow, and while on air transcriptionId, state and onAirSince; transcriptions (up to 20, each with transcriptionId, name, recording and lastRecordedAt) and streams (name, url). Unknown id: not_found.",
|
|
725
|
+
"inputSchema": {
|
|
726
|
+
"additionalProperties": false,
|
|
727
|
+
"properties": {
|
|
728
|
+
"broadcastId": {
|
|
729
|
+
"description": "The broadcastId that list_broadcasts or start_broadcast returned.",
|
|
730
|
+
"examples": [
|
|
731
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
732
|
+
],
|
|
733
|
+
"format": "uuid",
|
|
734
|
+
"type": "string"
|
|
735
|
+
}
|
|
736
|
+
},
|
|
737
|
+
"required": [
|
|
738
|
+
"broadcastId"
|
|
739
|
+
],
|
|
740
|
+
"type": "object"
|
|
741
|
+
},
|
|
742
|
+
"annotations": {
|
|
743
|
+
"title": "Get a broadcast",
|
|
744
|
+
"readOnlyHint": true,
|
|
745
|
+
"destructiveHint": false,
|
|
746
|
+
"idempotentHint": true,
|
|
747
|
+
"openWorldHint": false
|
|
748
|
+
}
|
|
749
|
+
},
|
|
750
|
+
{
|
|
751
|
+
"name": "start_broadcast",
|
|
752
|
+
"title": "Start a broadcast",
|
|
753
|
+
"description": "Start live transcription and translation of a live stream (YouTube live, internet radio, HLS .m3u8 or Icecast). Omit broadcastId to create a new broadcast with a new public link; set it to reuse one and keep its link. Use transcribe_url for a recording that has already ended. Billed per second while it runs; listeners are free. It runs until stop_broadcast or the stream ends, so stop it when done. Each call starts a new run (and, without broadcastId, a new broadcast) unless it repeats an idempotencyKey. Returns broadcastId, name, link (anyone who opens it reads, or with spokenTranslations also hears, the stream in their own language), transcriptionId (read the text so far with get_transcription) and state. Errors: invalid_state (with link) when it is already on air, invalid_options for a non-http(s) address, insufficient_credit (with topUpUrl), not_found for an unknown broadcastId.",
|
|
754
|
+
"inputSchema": {
|
|
755
|
+
"additionalProperties": false,
|
|
756
|
+
"properties": {
|
|
757
|
+
"broadcastId": {
|
|
758
|
+
"description": "Optional: run it on this existing broadcast (from list_broadcasts), so its listeners' link stays the same. Omit to make a new broadcast with a new link.",
|
|
759
|
+
"examples": [
|
|
760
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
761
|
+
],
|
|
762
|
+
"format": "uuid",
|
|
763
|
+
"type": "string"
|
|
764
|
+
},
|
|
765
|
+
"idempotencyKey": {
|
|
766
|
+
"description": "Any unique string of visible ASCII. Send the same key with the same arguments when retrying: for 24 h the first result comes back (with replayed true) and nothing is started twice.",
|
|
767
|
+
"examples": [
|
|
768
|
+
"sunday-2026-11-22"
|
|
769
|
+
],
|
|
770
|
+
"maxLength": 255,
|
|
771
|
+
"type": "string"
|
|
772
|
+
},
|
|
773
|
+
"name": {
|
|
774
|
+
"description": "Name of a new broadcast, shown to listeners. Defaults to the stream's host. Ignored when broadcastId is set.",
|
|
775
|
+
"examples": [
|
|
776
|
+
"Sunday service"
|
|
777
|
+
],
|
|
778
|
+
"maxLength": 200,
|
|
779
|
+
"type": "string"
|
|
780
|
+
},
|
|
781
|
+
"spokenLanguage": {
|
|
782
|
+
"description": "Code of the language spoken, e.g. en, es. Omit to detect it.",
|
|
783
|
+
"examples": [
|
|
784
|
+
"en"
|
|
785
|
+
],
|
|
786
|
+
"type": "string"
|
|
787
|
+
},
|
|
788
|
+
"spokenTranslations": {
|
|
789
|
+
"default": false,
|
|
790
|
+
"description": "Also read each translation aloud, so listeners can hear it in their language as well as read it. Off by default; listening stays free.",
|
|
791
|
+
"type": "boolean"
|
|
792
|
+
},
|
|
793
|
+
"streamUrl": {
|
|
794
|
+
"description": "http(s) address of a live stream to transcribe and translate as it plays: a YouTube live, an internet radio station, an HLS (.m3u8) or Icecast stream. For a recording that has ended, use transcribe_url.",
|
|
795
|
+
"examples": [
|
|
796
|
+
"https://www.youtube.com/watch?v=jfKfPfyJRdk",
|
|
797
|
+
"https://stream.example.org/radio.m3u8"
|
|
798
|
+
],
|
|
799
|
+
"format": "uri",
|
|
800
|
+
"maxLength": 2048,
|
|
801
|
+
"type": "string"
|
|
802
|
+
}
|
|
803
|
+
},
|
|
804
|
+
"required": [
|
|
805
|
+
"streamUrl"
|
|
806
|
+
],
|
|
807
|
+
"type": "object"
|
|
808
|
+
},
|
|
809
|
+
"annotations": {
|
|
810
|
+
"title": "Start a broadcast",
|
|
811
|
+
"readOnlyHint": false,
|
|
812
|
+
"destructiveHint": false,
|
|
813
|
+
"idempotentHint": false,
|
|
814
|
+
"openWorldHint": true
|
|
815
|
+
}
|
|
816
|
+
},
|
|
817
|
+
{
|
|
818
|
+
"name": "stop_broadcast",
|
|
819
|
+
"title": "Stop a broadcast",
|
|
820
|
+
"description": "Stop the live transcription a broadcast is running (started with start_broadcast), which also stops its billing. Use it when the event is over. The transcript is kept (get_transcription, translate_transcription, get_summary; delete_transcription removes it) and the link stays, ready for the next start_broadcast with the same broadcastId. Returns the stopped transcription's status (transcriptionId, name, kind \"live\", state \"finishing\" then \"done\", startedAt, endedAt, durationS) with broadcastId and link. Errors: invalid_state when the broadcast is not on air, not_found for an unknown broadcastId.",
|
|
821
|
+
"inputSchema": {
|
|
822
|
+
"additionalProperties": false,
|
|
823
|
+
"properties": {
|
|
824
|
+
"broadcastId": {
|
|
825
|
+
"description": "The broadcastId that list_broadcasts or start_broadcast returned.",
|
|
826
|
+
"examples": [
|
|
827
|
+
"0190f0e0-7c1a-7d3e-9b2a-5f4e3d2c1b0a"
|
|
828
|
+
],
|
|
829
|
+
"format": "uuid",
|
|
830
|
+
"type": "string"
|
|
831
|
+
}
|
|
832
|
+
},
|
|
833
|
+
"required": [
|
|
834
|
+
"broadcastId"
|
|
835
|
+
],
|
|
836
|
+
"type": "object"
|
|
837
|
+
},
|
|
838
|
+
"annotations": {
|
|
839
|
+
"title": "Stop a broadcast",
|
|
840
|
+
"readOnlyHint": false,
|
|
841
|
+
"destructiveHint": false,
|
|
842
|
+
"idempotentHint": true,
|
|
843
|
+
"openWorldHint": false
|
|
844
|
+
}
|
|
845
|
+
}
|
|
846
|
+
]
|
|
847
|
+
}
|