KosmoKrator

ai

AssemblyAI MCP Integration for Claude Agent SDK

Connect AssemblyAI to Claude Agent 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

AssemblyAI MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.