KosmoKrator

ai

AssemblyAI MCP Integration for OpenAI Agents SDK

Connect AssemblyAI to OpenAI Agents SDK 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 OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

AssemblyAI MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "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 OpenAI Agents

OpenAI Agents 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 OpenAI AgentsClient-level gateway setup.