mcp-stt-openai mcp

v1.0.1 · MCP Tool · audio · registry.pascalai.org

Speech-to-text via OpenAI Whisper / GPT-4o transcription API. Supports transcribe and translate to English. Auth via apiKey or OPENAI_API_KEY env var.

sttwhisperopenaitranscriptionaudiospeech

Input Parameters

ParameterTypeDescription
filePathrequired string Path to the audio file (mp3, mp4, wav, m4a, ogg, flac, webm).
languageoptional string Language code (e.g. es, en, fr). Empty = auto-detect.
operationoptional string Operation: transcribe (default) | translate (to English). Default: transcribe.
promptoptional string Optional prompt to guide transcription style or vocabulary.
modeloptional string Model: whisper-1 (default), gpt-4o-transcribe, gpt-4o-mini-transcribe. Default: whisper-1.
apiKeyoptional string OpenAI API key (or OPENAI_API_KEY env var).
baseUrloptional string Base URL override (default: https://api.openai.com/v1). Default: https://api.openai.com/v1.

Output Fields

FieldTypeDescription
text string Transcribed text.
language string
duration number
operation string
error string

Examples

Transcribe audio file

// Input
{
  "filePath": "C:\\recordings\\meeting.mp3",
  "language": "en",
  "apiKey": "sk-..."
}

// Output
{
  "text": "Good morning everyone, let's start the meeting.",
  "language": "en",
  "duration": 325.4
}

Translate Spanish audio to English

// Input
{
  "filePath": "C:\\audio\\entrevista.mp3",
  "operation": "translate",
  "apiKey": "sk-..."
}

// Output
{
  "text": "Hello, my name is Carlos and I work in technology.",
  "language": "en",
  "duration": 45.2
}

Install & Discovery

Install

ppm install mcp-stt-openai

Get JSON Schema

GET /v1/packages/mcp-stt-openai/1.0.1/schema

Discover by keyword

GET /v1/mcp/discover?q=stt
Discovery hint: Install with ppm install mcp-stt-openai or invoke remotely via POST /v1/invoke/mcp-stt-openai on the MCP Service.