MCP tools¶
Every tool akou mcp lists, with its parameters and the annotations a harness reads to decide which tools it may run without asking. The server answers from the local API, so each tool does what the matching command or route does. akou_ask is listed only while akou's provider can answer, and never to a client that is itself that provider's harness. The page is generated from the server's tool list, and CI fails when it differs.
akou_add_note¶
Add a note
Add a line to the live call's notepad, marked as written by you.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string |
yes | The note, one line, such as "Ben ships the fix Friday". |
Input schema
akou_answer¶
Answer the ask box
Post your answer to a question the user typed in akou's ask box: an ask line with by: "user" from your akou events watch, or one listed in akou_status live.unanswered. Read the call with akou_context first, answer briefly, cite lines as [HH:MM Name], then say the same answer in this conversation. The box shows it under your name. Never answer an ask whose by starts with agent:. already_answered means you did already: that is done. others says what else answered; with an answer from a model there, post again only to correct or add to it.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
ask |
string |
yes | The ask id from the ask event, such as "q0007". |
text |
string |
yes | Your answer, with [HH:MM Name] citations. |
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
model |
string |
no | The model that wrote it, if you know. |
Input schema
{
"type": "object",
"properties": {
"ask": {
"type": "string",
"pattern": "^q\\d{4,}$",
"description": "The ask id from the `ask` event, such as \"q0007\"."
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "Your answer, with [HH:MM Name] citations."
},
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
},
"model": {
"description": "The model that wrote it, if you know.",
"type": "string",
"maxLength": 200
}
},
"required": [
"ask",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_ask¶
Ask akou's provider
Answer with akou's own configured provider. Prefer akou_context and answer yourself: akou_ask spawns another agent run on the user's subscription.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true.
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string |
yes | The user's question, word for word, such as "what did Ben say about the budget?". |
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
Input schema
{
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 1,
"description": "The user's question, word for word, such as \"what did Ben say about the budget?\"."
},
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
}
},
"required": [
"question"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_config_get¶
Read the settings
akou's settings as they are in force, secrets redacted, or one with key (asr.live). Read-only: changing one is the user's, in the window or with akou config set.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
key |
string |
no | One setting's key, such as "asr.live". |
Input schema
akou_context¶
Context for a question
The main tool for answering any question about a call: pass the user's question verbatim and answer from the pack it returns (a few thousand tokens, never the whole transcript). Also returns, as typed fields, the cursor for akou_read, the call state and memoStale. Cite wall-clock times as [HH:MM Name]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when. If the answer is not in the pack, say so and name the time range to fetch.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string |
yes | The user's question, word for word, such as "what did Ben say about the budget?". |
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
budget |
integer |
no | The pack's size in tokens, 500 to 7000. |
Input schema
{
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 1,
"description": "The user's question, word for word, such as \"what did Ben say about the budget?\"."
},
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
},
"budget": {
"default": 6000,
"description": "The pack's size in tokens, 500 to 7000.",
"type": "integer",
"minimum": 500,
"maximum": 7000
}
},
"required": [
"question"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_delete_note¶
Delete a note
Delete one notepad line, by its id from akou_get_notes. Only when the user asks: the line may be theirs.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The note's id from akou_get_notes, such as "n0003". |
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
Input schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The note's id from akou_get_notes, such as \"n0003\"."
},
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_devices¶
List microphones and apps
The microphones, outputs and apps with audio akou can record: an input's id is what akou_start takes as mic, an app's id what it takes as call: "app:ID". Read-only; opens no device.
Annotations: readOnlyHint: true, openWorldHint: false.
Parameters: none.
Input schema
akou_dictation_get¶
Read a dictation
One past dictation by id: its state, the app it went to, the text inserted and the raw text heard, the language, the engine and its timing. Read-only.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | A dictation's id from akou_dictation_list. |
Input schema
akou_dictation_list¶
List past dictations
The user's past dictations (text they spoke into other apps with akou's dictation key), newest first: id, time, state, the app it went to, and the text. Read-only. q keeps those whose text holds it; page with cursor.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
q |
string |
no | Only dictations whose text holds this, in any case. |
limit |
integer |
no | The most dictations per page, 1 to 100. |
cursor |
string |
no | The nextCursor of the previous page. |
Input schema
{
"type": "object",
"properties": {
"q": {
"description": "Only dictations whose text holds this, in any case.",
"type": "string",
"minLength": 1
},
"limit": {
"default": 20,
"description": "The most dictations per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_edit_note¶
Edit a note
Replace the text of one notepad line, by its id from akou_get_notes (n0003). The old text stays in the call's log.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The note's id from akou_get_notes, such as "n0003". |
text |
string |
yes | The note's new text. |
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
Input schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The note's id from akou_get_notes, such as \"n0003\"."
},
"text": {
"type": "string",
"minLength": 1,
"description": "The note's new text."
},
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
}
},
"required": [
"id",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_enhance¶
Enhance notes with akou's provider
Ask akou's own provider to write the enhanced notes for a call (default the latest). Prefer akou_enhance_context and write them yourself.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | A call: "live" (the one recording now), "last", or an id from akou_list_calls. |
template |
string |
no | The template to follow; omit for the call's own. |
Input schema
{
"type": "object",
"properties": {
"call": {
"default": "last",
"type": "string",
"minLength": 1,
"description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
},
"template": {
"description": "The template to follow; omit for the call's own.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_enhance_context¶
Context for enhanced notes
What you need to write enhanced notes for a call yourself (default the latest): the template and a pack. Pass the call it answers to akou_enhanced_put, so the notes land on this call even if another one starts meanwhile.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | A call: "live" (the one recording now), "last", or an id from akou_list_calls. |
template |
string |
no | The template to follow; omit for the call's own. |
Input schema
{
"type": "object",
"properties": {
"call": {
"default": "last",
"type": "string",
"minLength": 1,
"description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
},
"template": {
"description": "The template to follow; omit for the call's own.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_enhanced_put¶
Save enhanced notes
Save the enhanced notes you wrote for a call: the call akou_enhance_context answered (default the latest when saved). Every bullet must end with the segment ids it rests on, like [#l000031]; a bullet without a real citation is dropped. Place the user's own notes by id (- {n0004}); they are kept word for word.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | The call id akou_enhance_context answered; omit for the latest call at the time of saving. |
markdown |
string |
yes | The notes in Markdown, in the template's sections, each bullet cited. |
coversSeq |
integer |
yes | The coversSeq akou_enhance_context answered: what the notes were written from. |
Input schema
{
"type": "object",
"properties": {
"call": {
"description": "The call id akou_enhance_context answered; omit for the latest call at the time of saving.",
"type": "string",
"minLength": 1
},
"markdown": {
"type": "string",
"minLength": 1,
"description": "The notes in Markdown, in the template's sections, each bullet cited."
},
"coversSeq": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "The `coversSeq` akou_enhance_context answered: what the notes were written from."
}
},
"required": [
"markdown",
"coversSeq"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_export¶
Export a call
Hand a finished call off to the export folder: Markdown with frontmatter (enhanced notes, your raw notes, the transcript), the event log and the audio. Needs export.dir set.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
yes | A call: "live" (the one recording now), "last", or an id from akou_list_calls. |
Input schema
akou_finalize¶
Run the final pass
Start the accurate final pass on an ended call (default the latest). It runs on its own; akou_get_call with layer final reads it once done. force runs it again on a call that has one; model picks qwen, parakeet, or fusion (several engines, their words combined; slower) for this run only.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | A call: "live" (the one recording now), "last", or an id from akou_list_calls. |
force |
boolean |
no | Run it again on a call that has a final pass. |
model |
"qwen" or "parakeet" or "fusion" |
no | The engine for this run only; omit for the setting. |
Input schema
{
"type": "object",
"properties": {
"call": {
"default": "last",
"type": "string",
"minLength": 1,
"description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
},
"force": {
"description": "Run it again on a call that has a final pass.",
"type": "boolean"
},
"model": {
"description": "The engine for this run only; omit for the setting.",
"type": "string",
"enum": [
"qwen",
"parakeet",
"fusion"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_forget¶
Forget a fact
Retract a line kept with akou_remember, by its id.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id akou_remember answered, such as "r0001". |
Input schema
akou_get_call¶
Read a named call
A call the user named: its transcript from the start, one page at a time, each line with its segment id. When nextCursor is not null, call again with it as cursor for the next page, and the same layer. To answer a question, akou_context with call is cheaper than reading every page. Cite wall-clock times as [HH:MM Name]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
yes | A call: "live" (the one recording now), "last", or an id from akou_list_calls. |
layer |
"best" or "live" or "final" |
no | "best": the final pass where it ran, else live; "live": as heard during the call; "final": only the final pass. |
cursor |
string |
no | The nextCursor of the previous page; leave it out for the first page. |
Input schema
{
"type": "object",
"properties": {
"call": {
"type": "string",
"minLength": 1,
"description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
},
"layer": {
"default": "best",
"description": "\"best\": the final pass where it ran, else live; \"live\": as heard during the call; \"final\": only the final pass.",
"type": "string",
"enum": [
"best",
"live",
"final"
]
},
"cursor": {
"description": "The nextCursor of the previous page; leave it out for the first page.",
"type": "string"
}
},
"required": [
"call"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_get_notes¶
Read the notepad
The live call's notepad: the user's lines and yours, oldest first. A long notepad comes in pages: pass nextOffset as offset for the next.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
offset |
integer |
no | The first note to return: 0, or the nextOffset of the page before. |
Input schema
akou_job_delete¶
Delete a transcription job
Delete a transcription job: a queued one is dropped, a running one stopped, and its file and transcript removed for good. Only when the user asks, such as for a wrong upload.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The job id, such as "job_1". |
Input schema
akou_job_get¶
Read a transcription job
One transcription job by id, waiting up to wait seconds for it to end; a done job comes with its transcript in result. format: text (or srt, vtt) returns the transcript alone, much shorter than the default JSON with every word's times: use it for a long file. Read-only.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The job id akou_transcribe or akou_jobs_list gave, such as "job_1". |
wait |
integer |
no | Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call. |
format |
"json" or "text" or "srt" or "vtt" |
no | The transcript's form: "json" (words with times), "text", or "srt" / "vtt" subtitles. |
Input schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The job id akou_transcribe or akou_jobs_list gave, such as \"job_1\"."
},
"wait": {
"default": 50,
"description": "Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call.",
"type": "integer",
"minimum": 0,
"maximum": 50
},
"format": {
"default": "json",
"description": "The transcript's form: \"json\" (words with times), \"text\", or \"srt\" / \"vtt\" subtitles.",
"type": "string",
"enum": [
"json",
"text",
"srt",
"vtt"
]
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_jobs_list¶
List transcription jobs
The transcription jobs this key submitted, newest first: id, title, state, preset, model and times, no transcript. status keeps one state and q the jobs whose title or id holds a text; when cursor is not null, pass it back for older jobs. Read-only.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
status |
"queued" or "running" or "done" or "failed" or "cancelled" |
no | Only jobs in this state. |
q |
string |
no | Only jobs whose title, id or state holds this text, in any case. |
limit |
integer |
no | The most jobs per page, 1 to 200. |
cursor |
integer |
no | The cursor of the page before: the jobs older than it. |
Input schema
{
"type": "object",
"properties": {
"status": {
"description": "Only jobs in this state.",
"type": "string",
"enum": [
"queued",
"running",
"done",
"failed",
"cancelled"
]
},
"q": {
"description": "Only jobs whose title, id or state holds this text, in any case.",
"type": "string",
"minLength": 1
},
"limit": {
"default": 20,
"description": "The most jobs per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"cursor": {
"description": "The `cursor` of the page before: the jobs older than it.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_list_calls¶
List past calls
Past calls by date, title and state (no content search). History beyond a named call lives in the user's own notes.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace |
string |
no | Only this workspace's calls. |
limit |
integer |
no | The most calls to return, newest first, 1 to 1000. |
failed |
boolean |
no | Only the calls whose start failed (nothing was recorded), instead of the others. A call whose final pass failed is not one. |
Input schema
{
"type": "object",
"properties": {
"workspace": {
"description": "Only this workspace's calls.",
"type": "string",
"minLength": 1
},
"limit": {
"default": 20,
"description": "The most calls to return, newest first, 1 to 1000.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"failed": {
"description": "Only the calls whose start failed (nothing was recorded), instead of the others. A call whose final pass failed is not one.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_memo_get¶
Read the memo
The live call's rolling memo and the seq it covers.
Annotations: readOnlyHint: true, openWorldHint: false.
Parameters: none.
Input schema
akou_memo_put¶
Write the memo
Write the rolling memo when akou_context reports memoStale and no provider writes it: topics, decisions, actions with owner, open questions, people, each with [HH:MM]. coversSeq is the cursor the memo covers up to.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string |
yes | The whole memo, in Markdown, replacing the one before. |
coversSeq |
integer |
yes | The cursor of the last akou_context or akou_read the memo covers. |
Input schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"description": "The whole memo, in Markdown, replacing the one before."
},
"coversSeq": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "The `cursor` of the last akou_context or akou_read the memo covers."
}
},
"required": [
"text",
"coversSeq"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_merge_speakers¶
Merge two speakers
Merge speaker a into speaker b when both are the same person: a's lines read as b from then on. Undo with akou_unmerge_speaker.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
a |
string |
yes | The speaker to merge away, such as "c3". |
b |
string |
yes | The speaker to keep, such as "c2". |
Input schema
{
"type": "object",
"properties": {
"a": {
"type": "string",
"minLength": 1,
"description": "The speaker to merge away, such as \"c3\"."
},
"b": {
"type": "string",
"minLength": 1,
"description": "The speaker to keep, such as \"c2\"."
}
},
"required": [
"a",
"b"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_mute¶
Mute the microphone
Mute the live call's microphone.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
Parameters: none.
Input schema
akou_name_speaker¶
Name a speaker
Name a speaker the moment the user says who a voice is ("Speaker 2 is Ben"). speaker is the id from the transcript: you, c2, c3...
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
speaker |
string |
yes | A speaker id from the transcript: "you" for the microphone, then "c2", "c3"... |
name |
string |
yes | The person's name as the user says it, such as "Ben". |
Input schema
{
"type": "object",
"properties": {
"speaker": {
"type": "string",
"minLength": 1,
"description": "A speaker id from the transcript: \"you\" for the microphone, then \"c2\", \"c3\"..."
},
"name": {
"type": "string",
"minLength": 1,
"description": "The person's name as the user says it, such as \"Ben\"."
}
},
"required": [
"speaker",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_open_window¶
Show the window
Show akou's window to the user, on a call if one is named (live, last or an id). With no window (headless), answers a browser address that works once, within a minute.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | Open the window on this call. |
Input schema
akou_pause¶
Pause recording
Pause the live call.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
Parameters: none.
Input schema
akou_read¶
Read new lines
New committed lines since a cursor (the cursor field of akou_context or an earlier akou_read), plus the line still being spoken and the next cursor. Use it to follow a call instead of re-reading. Cite wall-clock times as [HH:MM Name]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
since |
integer |
no | The cursor of the last akou_context or akou_read: only lines after it. |
lastSeconds |
integer |
no | Only the lines of the last N seconds, such as 120 for the last two minutes. |
Input schema
{
"type": "object",
"properties": {
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
},
"since": {
"description": "The `cursor` of the last akou_context or akou_read: only lines after it.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"lastSeconds": {
"description": "Only the lines of the last N seconds, such as 120 for the last two minutes.",
"type": "integer",
"minimum": 1,
"maximum": 86400
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_remember¶
Remember a fact
Keep a fact you will need in later turns (it comes back in every akou_context pack, even after your context is compacted).
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string |
yes | The fact, in one sentence, such as "Ben owns the deploy". |
Input schema
akou_rename_call¶
Rename a call
Rename a call, live or saved, when the user gives it a name ("call this the Q3 planning"). call is live (default), last or an id from akou_list_calls. Every list and search shows the new title at once.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | A call: "live" (the one recording now), "last", or an id from akou_list_calls. |
title |
string |
yes | The new title, such as "Q3 planning". |
Input schema
{
"type": "object",
"properties": {
"call": {
"default": "live",
"type": "string",
"minLength": 1,
"description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The new title, such as \"Q3 planning\"."
}
},
"required": [
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_restart¶
Restart capture
Start a new part in the latest call (after a stop, or to rebuild capture). force is needed when its last audio is over an hour old.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
force |
boolean |
no | Start the new part even when the call's last audio is over an hour old. |
Input schema
akou_resume¶
Resume recording
Resume the live call.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
Parameters: none.
Input schema
akou_search¶
Search a call
Exact word hits in a call with wall-time citations, for names, numbers and terms. Cite wall-clock times as [HH:MM Name]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string |
yes | The exact word, name or number to find, such as "Hetzner" or "40k". |
call |
string |
no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
k |
integer |
no | The most hits to return, 1 to 50. |
Input schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "The exact word, name or number to find, such as \"Hetzner\" or \"40k\"."
},
"call": {
"default": "live",
"description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
"type": "string"
},
"k": {
"default": 6,
"description": "The most hits to return, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_share_off¶
Stop sharing
Stop sharing a call's live link, or every link when no call is named. The people holding the link lose it for good; sharing again makes a new address.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | The call whose link to stop; omit for every link. |
Input schema
akou_share_on¶
Share a live link
Start a read-only live link to a call (default the live one), only when the user asks to share it. notes shares the notepad too; expires turns it off after a while (2h). Answers the address to hand over.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true.
| Parameter | Type | Required | Description |
|---|---|---|---|
call |
string |
no | The call to share; default "live". |
notes |
boolean |
no | Share the notepad too. |
expires |
string |
no | When the link turns off: "call-end", "call-end+2h" (the default), or a duration up to 24 hours like "90m" or "2h". |
Input schema
{
"type": "object",
"properties": {
"call": {
"description": "The call to share; default \"live\".",
"type": "string",
"minLength": 1
},
"notes": {
"description": "Share the notepad too.",
"type": "boolean"
},
"expires": {
"description": "When the link turns off: \"call-end\", \"call-end+2h\" (the default), or a duration up to 24 hours like \"90m\" or \"2h\".",
"type": "string",
"pattern": "^(call-end|call-end\\+2h|\\d{1,4} ?(m|min|h))$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_share_status¶
Live links that are on
The read-only live links that are on, one per shared call: the call, where it listens, when it expires and how many people watch. The token in each address is cut out (/s/<token>/): it is the whole credential, so only akou_share_on, which the user asks for, answers it.
Annotations: readOnlyHint: true, openWorldHint: false.
Parameters: none.
Input schema
akou_start¶
Start recording
Start recording a call now. Make this the first call when the user wants a call recorded: no status check first. Returns once audio is being written. vocab takes call-scoped words known before the call (attendee names, title terms). If a call is already recording, starts nothing and returns that call with attached: true: follow it with akou_context and akou_read like one you started.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace |
string |
no | A workspace name, such as "work" or "acme": calls and vocabulary are kept per workspace. |
title |
string |
no | The call's title, such as "Q3 planning"; the invite's title when there is one. |
template |
string |
no | The note template for this call's enhanced notes; omit and akou picks one by title. |
call |
string |
no | What to capture as the call side: "system" (the whole computer), "none", or "app:ID" with an app id from akou_devices |
mic |
string |
no | The microphone: an input id from akou_devices, or "none" |
vocab |
string[] |
no | Words known before the call for this call only: attendee names, title terms. |
final |
string |
no | The final pass for this call: "fusion" runs several speech engines after the call and combines their words, slower and more accurate; "qwen" or "parakeet" one model. Omit for the setting |
withoutModels |
boolean |
no | Record audio now and transcribe it later, when the speech models are not downloaded yet. |
Input schema
{
"type": "object",
"properties": {
"workspace": {
"type": "string",
"minLength": 1,
"description": "A workspace name, such as \"work\" or \"acme\": calls and vocabulary are kept per workspace."
},
"title": {
"description": "The call's title, such as \"Q3 planning\"; the invite's title when there is one.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"template": {
"description": "The note template for this call's enhanced notes; omit and akou picks one by title.",
"type": "string",
"minLength": 1
},
"call": {
"description": "What to capture as the call side: \"system\" (the whole computer), \"none\", or \"app:ID\" with an app id from akou_devices",
"type": "string",
"pattern": "^(system|none|app:.+)$"
},
"mic": {
"description": "The microphone: an input id from akou_devices, or \"none\"",
"type": "string"
},
"vocab": {
"description": "Words known before the call for this call only: attendee names, title terms.",
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"final": {
"description": "The final pass for this call: \"fusion\" runs several speech engines after the call and combines their words, slower and more accurate; \"qwen\" or \"parakeet\" one model. Omit for the setting",
"type": "string"
},
"withoutModels": {
"description": "Record audio now and transcribe it later, when the speech models are not downloaded yet.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_status¶
Recorder status
Whether a call is recording, its health, recognizer lag and live model (live.setup: parakeet or nemotron, live.engine, and live.review: the second pass's model and interval, or null), the models and provider in use, and sharing. Read models and provider from here, never from memory. Not needed before akou_start.
Annotations: readOnlyHint: true, openWorldHint: false.
Parameters: none.
Input schema
akou_stop¶
Stop recording
Stop the live call.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false.
Parameters: none.
Input schema
akou_template_get¶
Read a note template
One note template as akou would use it (the user's own file when it replaces the shipped one): read it before writing enhanced notes with akou_enhanced_put.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
name |
string |
yes | A note template, such as "standup" or "general": the names akou_template_list shows. |
Input schema
akou_template_list¶
List note templates
The note templates enhanced notes can follow: the shipped ones and the user's own, with each one's sections and title keywords. Read one with akou_template_get.
Annotations: readOnlyHint: true, openWorldHint: false.
Parameters: none.
Input schema
akou_transcribe¶
Transcribe a file on a server
Transcribe an audio or video file on this machine as a job on the akou server (AKOU_URL, server mode): uploads the file once (up to 512 MB) and waits up to wait seconds. A job that ends in time comes back done with its transcript in result; one still queued or running comes back with its id for akou_job_get. task: translate writes the speech in English instead. A path that is missing, too large, or not an audio or video file is refused and nothing is sent.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string |
yes | The file's absolute path on this machine, such as /Users/me/Downloads/note.m4a. |
preset |
"lite" or "fast" or "best" or "fusion" or "auto" |
no | How much accuracy matters; auto lets the server choose. |
language |
string |
no | The spoken language as an ISO code such as en or es, or auto. |
diarize |
boolean |
no | Label the speakers. |
title |
string |
no | A name for the job in akou_jobs_list; default the file's name. |
task |
"transcribe" or "translate" |
no | "translate" writes the speech in English; default "transcribe". |
keywords |
string[] |
no | Up to 24 names and terms the speech holds, so the engine spells them right. |
wait |
integer |
no | Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call. |
Input schema
{
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"description": "The file's absolute path on this machine, such as /Users/me/Downloads/note.m4a."
},
"preset": {
"description": "How much accuracy matters; auto lets the server choose.",
"type": "string",
"enum": [
"lite",
"fast",
"best",
"fusion",
"auto"
]
},
"language": {
"description": "The spoken language as an ISO code such as en or es, or auto.",
"type": "string"
},
"diarize": {
"description": "Label the speakers.",
"type": "boolean"
},
"title": {
"description": "A name for the job in akou_jobs_list; default the file's name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"task": {
"description": "\"translate\" writes the speech in English; default \"transcribe\".",
"type": "string",
"enum": [
"transcribe",
"translate"
]
},
"keywords": {
"description": "Up to 24 names and terms the speech holds, so the engine spells them right.",
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"wait": {
"default": 50,
"description": "Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call.",
"type": "integer",
"minimum": 0,
"maximum": 50
}
},
"required": [
"path"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_unmerge_speaker¶
Undo a speaker merge
Undo a merge: the speaker gets its own label back for later lines.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
speaker |
string |
yes | The speaker that was merged away. |
Input schema
akou_unmute¶
Unmute the microphone
Unmute the live call's microphone.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
Parameters: none.
Input schema
akou_vocab_add¶
Add a word
Pass on a word the user stated ("it's Vercel, not versal"), with how it was heard. Scope "call" (the default) works like the user fixing a line: every line of the live call with that heard form reads corrected at once. A name, product or jargon word is also learned into the call's and the workspace's vocabulary with no review; a rewording of common words stays in this call only and goes into the call's Notes as "Fixed: heard -> term" (so does any word while the live engine takes no word list). decode: false only corrects the reading of this call. "workspace" or "global" only writes the vocabulary file. Never add a word you inferred; propose it with akou_vocab_propose.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
term |
string |
yes | The word as it should be written, such as "Vercel". |
heard |
string[] |
no | How the transcript wrote it, such as ["versal"]. |
scope |
"call" or "workspace" or "global" |
no | "call": fix the live call now and learn the word; "workspace" or "global": only write that vocabulary file. |
workspace |
string |
no | The workspace, with scope "workspace". |
decode |
boolean |
no | false: correct only how this call reads, without biasing recognition. |
note |
string |
no | Why the word is there, for the user reading the file. |
Input schema
{
"type": "object",
"properties": {
"term": {
"type": "string",
"minLength": 1,
"description": "The word as it should be written, such as \"Vercel\"."
},
"heard": {
"description": "How the transcript wrote it, such as [\"versal\"].",
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"scope": {
"default": "call",
"description": "\"call\": fix the live call now and learn the word; \"workspace\" or \"global\": only write that vocabulary file.",
"type": "string",
"enum": [
"call",
"workspace",
"global"
]
},
"workspace": {
"description": "The workspace, with scope \"workspace\".",
"type": "string",
"minLength": 1
},
"decode": {
"description": "false: correct only how this call reads, without biasing recognition.",
"type": "boolean"
},
"note": {
"description": "Why the word is there, for the user reading the file.",
"type": "string"
}
},
"required": [
"term"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_vocab_approve¶
Approve proposed words
Approve proposed words once the user says yes; they become confirmed entries in the workspace file.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
terms |
string[] |
yes | The terms, as akou_vocab_list shows them. |
call |
string |
no | A call whose proposals these are. |
Input schema
{
"type": "object",
"properties": {
"terms": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "The terms, as akou_vocab_list shows them."
},
"call": {
"description": "A call whose proposals these are.",
"type": "string",
"minLength": 1
}
},
"required": [
"terms"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_vocab_check¶
Check a word
Whether a word is safe to bias recognition with.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
term |
string |
yes | The word to check, such as "Kubernetes". |
Input schema
akou_vocab_list¶
List the vocabulary
The vocabulary in force: a call's own words and proposals (with call), or the files for a workspace. With call and unconfirmed, the words to review: the call's open proposals with the lines they rest on, and the workspace's unconfirmed entries. With dictation, also the words the user fixed while dictating, each pair at its latest status (proposed, ignored, accepted, rejected). Ask the user before approving any.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace |
string |
no | The files for this workspace, with the global one. |
call |
string |
no | A call's own words and proposals instead of the files. |
unconfirmed |
boolean |
no | Only the words waiting for the user's yes or no. |
dictation |
boolean |
no | Also the words the user fixed while dictating. |
Input schema
{
"type": "object",
"properties": {
"workspace": {
"description": "The files for this workspace, with the global one.",
"type": "string",
"minLength": 1
},
"call": {
"description": "A call's own words and proposals instead of the files.",
"type": "string",
"minLength": 1
},
"unconfirmed": {
"description": "Only the words waiting for the user's yes or no.",
"type": "boolean"
},
"dictation": {
"description": "Also the words the user fixed while dictating.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_vocab_propose¶
Propose words
Propose words you inferred (from an invite, a document, a correction you noticed). A proposal does nothing until the user approves it with akou_vocab_approve. With call, they go to that call's workspace.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
entries |
object[] |
yes | The words to propose, each with how it was heard and why, when known. |
call |
string |
no | Propose into this call's workspace. |
Input schema
{
"type": "object",
"properties": {
"entries": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"term": {
"type": "string",
"minLength": 1
},
"heard": {
"type": "array",
"items": {
"type": "string"
}
},
"note": {
"type": "string"
}
},
"required": [
"term"
]
},
"description": "The words to propose, each with how it was heard and why, when known."
},
"call": {
"description": "Propose into this call's workspace.",
"type": "string",
"minLength": 1
}
},
"required": [
"entries"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_vocab_reject¶
Reject proposed words
Reject proposed words; they are not proposed again.
Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
terms |
string[] |
yes | The terms, as akou_vocab_list shows them. |
call |
string |
no | A call whose proposals these are. |
Input schema
{
"type": "object",
"properties": {
"terms": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "The terms, as akou_vocab_list shows them."
},
"call": {
"description": "A call whose proposals these are.",
"type": "string",
"minLength": 1
}
},
"required": [
"terms"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
akou_vocab_suggest¶
Suggest words
Ranked candidate words from a call or a text, to propose to the user with akou_vocab_propose. Give text or call.
Annotations: readOnlyHint: true, openWorldHint: false.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string |
no | A text to mine: an invite, an agenda, a document. |
call |
string |
no | A call to mine instead of a text. |
k |
integer |
no | The most words to return, 1 to 200. |
Input schema
{
"type": "object",
"properties": {
"text": {
"description": "A text to mine: an invite, an agenda, a document.",
"type": "string",
"minLength": 1
},
"call": {
"description": "A call to mine instead of a text.",
"type": "string",
"minLength": 1
},
"k": {
"default": 20,
"description": "The most words to return, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}