MCP server

Local MCP setup

Run the stdio MCP package for controlled access to local audio and video files.

Install and build

git clone https://github.com/MalikElate/fast-transcriber.git
cd fast-transcriber/mcp-server
npm ci
npm run build

The local package lives in the Fast Transcriber repository and runs as a stdio process launched by your MCP client.

Client configuration

{
  "mcpServers": {
    "fast-transcriber": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "FAST_TRANSCRIBER_API_TOKEN": "ft_live_replace_me",
        "FAST_TRANSCRIBER_ALLOWED_DIRS": "/absolute/path/to/media"
      }
    }
  }
}

Local tools

Field	Type	Description
`transcribe_url`	url, speaker_diarization	Queue one public media URL.
`get_transcription`	id	Get one job and its completed result.
`list_transcriptions`	limit	List recent jobs for the API account.
`transcribe_file`	path, speaker_diarization=false	Resolve, upload, and queue one file inside an allowed directory.
`wait_for_transcription`	id, timeout_seconds=900	Poll until completed, failed, or the 1–3600 second timeout expires.

Optional settings

Field	Type	Description
`FAST_TRANSCRIBER_ALLOWED_DIRS`	path list	Defaults to the current directory.
`FAST_TRANSCRIBER_BASE_URL`	URL	Defaults to https://fast-transcriber.com.
`FAST_TRANSCRIBER_POLL_INTERVAL_MS`	milliseconds	Defaults to 2000.
`FAST_TRANSCRIBER_REQUEST_TIMEOUT_MS`	milliseconds	Defaults to 30000.
`FAST_TRANSCRIBER_UPLOAD_TIMEOUT_MS`	milliseconds	Defaults to 900000 per storage request.

Local-file security

Directory boundaries are enforced

File paths are resolved—including symlinks—and must remain inside FAST_TRANSCRIBER_ALLOWED_DIRS.

Grant only the media directories required by the assistant.
Use absolute paths in client configuration.
Rotate the API key when the client or machine is retired.