oruk Speech

Transcribe English audio AND score how it was said in one call: transcript, tagged transcript, selected scores from 15 emotion and 16 speaking-style labels, and time-local segments. Use this when the user cares about both the words and the delivery — meetings, support calls, interviews, voice notes. Accepts wav/flac/mp3/m4a/ogg/webm. Up to 30 MB via audio_url or 8 MiB decoded via audio_base64; up to 60 minutes of English speech. Returns compact summaries by default. For words only use oruk_transcribe_audio; for tone only use oruk_analyze_tone.

{
  "type": "object",
  "properties": {
    "audio_url": {
      "description": "Publicly fetchable audio file URL (wav, flac, mp3, m4a, ogg, webm; up to 30 MB / 60 minutes of English speech).",
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "audio_base64": {
      "description": "Base64-encoded audio bytes for local files (up to 8 MiB decoded). Prefer audio_url for anything larger.",
      "type": "string",
      "maxLength": 11500000
    },
    "filename": {
      "description": "Original filename including extension (e.g. call.wav). Helps decoding when audio_base64 is used.",
      "type": "string",
      "maxLength": 160
    },
    "model": {
      "description": "oruk-resonance (full local pipeline: transcription, emotion, style, affect, analysis) or oruk-fourier (parallel transcript and native 15-label emotion, with the shared 16-label style model). Resonance is the default.",
      "type": "string",
      "enum": [
        "oruk-resonance",
        "oruk-fourier"
      ]
    },
    "detail": {
      "description": "compact (default) returns top label scores and condensed segments; full preserves all returned labels, segments, and word-level timings, subject to response-size limits. It does not expose unreturned label scores.",
      "type": "string",
      "enum": [
        "compact",
        "full"
      ]
    },
    "diarize": {
      "description": "Label speakers (oruk-resonance only; the model is switched to oruk-resonance automatically). Speaker diarization locates turns, then Resonance scores each turn with its own text, emotions, and styles. Use for calls, meetings, and interviews. Included in subscription plan minutes. Processing details: https://oruk.ai/security#processing.",
      "type": "boolean"
    },
    "api_key": {
      "description": "Only for temporary keys from oruk_create_trial_key. Permanent keys belong in your MCP client config as an \"Authorization: Bearer <key>\" header, never in tool arguments.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

Transcribe prerecorded English audio to text with time-ordered segments and word timings. Use this when only the words matter. Accepts wav/flac/mp3/m4a/ogg/webm. Up to 30 MB via audio_url or 8 MiB decoded via audio_base64; up to 60 minutes of English speech. Does not score emotion or tone — use oruk_analyze_speech for transcript + tone together, or oruk_analyze_tone for tone alone.

{
  "type": "object",
  "properties": {
    "audio_url": {
      "description": "Publicly fetchable audio file URL (wav, flac, mp3, m4a, ogg, webm; up to 30 MB / 60 minutes of English speech).",
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "audio_base64": {
      "description": "Base64-encoded audio bytes for local files (up to 8 MiB decoded). Prefer audio_url for anything larger.",
      "type": "string",
      "maxLength": 11500000
    },
    "filename": {
      "description": "Original filename including extension (e.g. call.wav). Helps decoding when audio_base64 is used.",
      "type": "string",
      "maxLength": 160
    },
    "model": {
      "description": "oruk-resonance (full local pipeline: transcription, emotion, style, affect, analysis) or oruk-fourier (parallel transcript and native 15-label emotion, with the shared 16-label style model). Resonance is the default.",
      "type": "string",
      "enum": [
        "oruk-resonance",
        "oruk-fourier"
      ]
    },
    "detail": {
      "description": "compact (default) returns top label scores and condensed segments; full preserves all returned labels, segments, and word-level timings, subject to response-size limits. It does not expose unreturned label scores.",
      "type": "string",
      "enum": [
        "compact",
        "full"
      ]
    },
    "diarize": {
      "description": "Label speakers (oruk-resonance only; the model is switched to oruk-resonance automatically). Speaker diarization locates turns, then Resonance scores each turn with its own text, emotions, and styles. Use for calls, meetings, and interviews. Included in subscription plan minutes. Processing details: https://oruk.ai/security#processing.",
      "type": "boolean"
    },
    "api_key": {
      "description": "Only for temporary keys from oruk_create_trial_key. Permanent keys belong in your MCP client config as an \"Authorization: Bearer <key>\" header, never in tool arguments.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

Score how speech sounds without transcribing it: selected emotion (happy, frustrated, worried, …) and speaking-style (sarcastic, confident, hesitant, warm, …) scores per acoustic segment. Runs the Resonance encoder and affect head only — the transcription decoder is never invoked, so nothing is transcribed and it consumes the same subscription audio minutes as unified analysis. Use this when the user asks about mood, delivery, sentiment, sarcasm, or emotional dynamics in audio. Up to 30 MB via audio_url or 8 MiB decoded via audio_base64; up to 60 minutes of English speech. Labels use model-specific thresholds; the highest-scoring emotion is returned if none passes, and styles can be empty. Outputs describe delivery, not probabilities of inner state. Need the words too? Use oruk_analyze_speech.

{
  "type": "object",
  "properties": {
    "audio_url": {
      "description": "Publicly fetchable audio file URL (wav, flac, mp3, m4a, ogg, webm; up to 30 MB / 60 minutes of English speech).",
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "audio_base64": {
      "description": "Base64-encoded audio bytes for local files (up to 8 MiB decoded). Prefer audio_url for anything larger.",
      "type": "string",
      "maxLength": 11500000
    },
    "filename": {
      "description": "Original filename including extension (e.g. call.wav). Helps decoding when audio_base64 is used.",
      "type": "string",
      "maxLength": 160
    },
    "model": {
      "description": "oruk-resonance (full local pipeline: transcription, emotion, style, affect, analysis) or oruk-fourier (parallel transcript and native 15-label emotion, with the shared 16-label style model). Resonance is the default.",
      "type": "string",
      "enum": [
        "oruk-resonance",
        "oruk-fourier"
      ]
    },
    "detail": {
      "description": "compact (default) returns top label scores and condensed segments; full preserves all returned labels, segments, and word-level timings, subject to response-size limits. It does not expose unreturned label scores.",
      "type": "string",
      "enum": [
        "compact",
        "full"
      ]
    },
    "diarize": {
      "description": "Label speakers (oruk-resonance only; the model is switched to oruk-resonance automatically). Speaker diarization locates turns, then Resonance scores each turn with its own text, emotions, and styles. Use for calls, meetings, and interviews. Included in subscription plan minutes. Processing details: https://oruk.ai/security#processing.",
      "type": "boolean"
    },
    "api_key": {
      "description": "Only for temporary keys from oruk_create_trial_key. Permanent keys belong in your MCP client config as an \"Authorization: Bearer <key>\" header, never in tool arguments.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

Verify that an Oruk API key works and report the subscription, remaining audio minutes, and recent API usage. Use this after setup or to diagnose access and usage limits. Requires the Authorization header from your MCP config or a temporary api_key.

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "Only for temporary keys from oruk_create_trial_key. Permanent keys belong in the Authorization header of your MCP client config.",
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

Mint a real, temporary oruk API key with no account required: 3 requests, expires in 30 minutes, spends from a capped shared budget. Use this when no Authorization header is configured and the user wants to try transcription or tone analysis right now. Pass the returned key as the api_key argument of the audio tools. Share the signup link with the user so they can keep using oruk afterwards (7-day free trial on self-serve plans).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List oruk’s speech models with lifecycle, current subscription plans, and explicitly labeled legacy reference rates, the five API tasks, the 15 emotion and 16 speaking-style labels, and audio limits. No API key required. Use this to choose a model, estimate cost before analyzing long audio, or see which labels exist.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Quickstart for the oruk Speech API and this MCP server: how to get an API key, per-client MCP configuration snippets, SDK install commands, and an optional routing rule the user can add to their agent instructions. No API key required. Use this when setting oruk up for the first time or when the user asks how oruk works.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}