Skip to content

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
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The note, one line, such as \"Ben ships the fix Friday\"."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "key": {
      "description": "One setting's key, such as \"asr.live\".",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "A dictation's id from akou_dictation_list."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "call": {
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    }
  },
  "required": [
    "call"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The id akou_remember answered, such as \"r0001\"."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "offset": {
      "default": 0,
      "description": "The first note to return: 0, or the `nextOffset` of the page before.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The job id, such as \"job_1\"."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "call": {
      "description": "Open the window on this call.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

akou_pause

Pause recording

Pause the live call.

Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.

Parameters: none.

Input schema
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The fact, in one sentence, such as \"Ben owns the deploy\"."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "force": {
      "description": "Start the new part even when the call's last audio is over an hour old.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

akou_resume

Resume recording

Resume the live call.

Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.

Parameters: none.

Input schema
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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
{
  "type": "object",
  "properties": {
    "call": {
      "description": "The call whose link to stop; omit for every link.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

akou_stop

Stop recording

Stop the live call.

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false.

Parameters: none.

Input schema
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "A note template, such as \"standup\" or \"general\": the names akou_template_list shows."
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "speaker": {
      "type": "string",
      "minLength": 1,
      "description": "The speaker that was merged away."
    }
  },
  "required": [
    "speaker"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/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
{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "minLength": 1,
      "description": "The word to check, such as \"Kubernetes\"."
    }
  },
  "required": [
    "term"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/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"
}