KosmoKrator

ai

AssemblyAI MCP Integration for Codex

Connect AssemblyAI to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

6 functions 4 read 2 write API key auth
Submit AssemblyAI feedback View package source

Connect AssemblyAI to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

AssemblyAI MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-assemblyai": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=assemblyai",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=assemblyai --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only AssemblyAI instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

AssemblyAI Tools Visible to Codex

Codex sees stable MCP tool names generated from the AssemblyAI integration catalog.

MCP toolSource functionTypeDescription
integration__assemblyai__assemblyai_transcribe assemblyai.assemblyai_transcribe Write Submit an audio or video file URL for AI transcription. Supports speech-to-text, speaker diarization, summarization, sentiment analysis, and more. Returns a transcript ID to poll for results.
integration__assemblyai__assemblyai_get_transcript assemblyai.assemblyai_get_transcript Read Retrieve a transcript by ID. Returns the transcription text, status (queued, processing, completed, error), confidence score, and any enabled AI features like speaker labels, chapters, or sentiment analysis.
integration__assemblyai__assemblyai_list_transcripts assemblyai.assemblyai_list_transcripts Read List transcripts with optional filtering by status, date range, and pagination. Returns transcript IDs, statuses, and metadata.
integration__assemblyai__assemblyai_upload assemblyai.assemblyai_upload Write Upload a local audio or video file to AssemblyAI. Returns an upload URL that can be passed to the transcribe tool as the audio_url parameter. Supports most common audio and video formats.
integration__assemblyai__assemblyai_get_lemons assemblyai.assemblyai_get_lemons Read Retrieve lemons (billing credits and usage information) from your AssemblyAI account.
integration__assemblyai__assemblyai_get_current_user assemblyai.assemblyai_get_current_user Read Get the authenticated user's profile, including email, subscription plan, and API usage details.

Related AssemblyAI Pages

AssemblyAI CLIUse direct JSON commands instead of MCP discovery. AssemblyAI MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.