AssemblyAI MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with AssemblyAI MCP or direct API to transcribe media, retrieve transcripts, generate summaries, and extract audio insights through natural language.

AssemblyAI logoAssemblyAI
Api Key

AssemblyAI is a speech-to-text and audio intelligence API for uploaded or hosted media. Use it to turn audio and video into accurate transcripts, summaries, and insights.

9 Tools

Try AssemblyAI now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
AssemblyAI
Try asking
TOOLS

Supported Tools

Every AssemblyAI action and event your agent gets out of the box.

Delete Transcript Content

Irreversibly delete a transcript's stored content.

Export Subtitles

Export a completed transcript as raw SRT or WebVTT subtitle text.

Get Redacted Audio

Get the processing status and short-lived signed download URL for PII-redacted audio.

Get Transcript

Retrieve an AssemblyAI transcript's current state and results, optionally waiting until asynchronous processing completes or fails.

Get Transcript Segments

Return sentence- or paragraph-level segments, timestamps, confidence, and words for a completed transcript.

List Transcripts

List project transcripts from the last 90 days, newest first, with optional filters and a cursor for the next older page.

Search Transcript

Find words or phrases in a completed transcript and return occurrence counts and timestamps.

Submit Transcript

Queue an asynchronous pre-recorded transcription from a reachable media URL.

Upload Media

Upload an audio or video file to AssemblyAI and return the project-private URL to use when submitting a transcript.

SETUP GUIDE

Connect AssemblyAI MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-composio-api-key' });

const authConfig = await composio.auth_configs.create({
  toolkit: 'ASSEMBLYAI',
  auth_scheme: 'API_KEY',
});
const connectedAccount = await composio.connected_accounts.link({
  user_id: 'your-user-id',
  auth_config_id: authConfig.id,
  config: {
    api_key: 'your-assemblyai-api-key',
  },
});
const mcp = await composio.mcp.create({
  user_id: 'your-user-id',
  toolkits: ['ASSEMBLYAI'],
  auth_config_ids: [authConfig.id],
});
console.log(`AssemblyAI MCP server created: ${mcp.url}`);
Import and initialize the Composio client, configure AssemblyAI API key auth, then create an MCP server for AssemblyAI
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Transcribe the audio file at https://storage.googleapis.com/aai-web-samples/5_common_sports_injuries.mp3 and summarize the key points'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect AssemblyAI API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});

const authConfig = await composio.auth_configs.create({
  toolkit: 'ASSEMBLYAI',
  auth_scheme: 'API_KEY',
});
const connectedAccount = await composio.connected_accounts.link({
  user_id: 'your-user-id',
  auth_config_id: authConfig.id,
  config: {
    api_key: 'your-assemblyai-api-key',
  },
});
const session = await composio.create('your-user-id');
Import and initialize Composio client, configure AssemblyAI API key auth, then create a Tool Router session
3

Execute AssemblyAI Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Transcribe the audio file at https://storage.googleapis.com/aai-web-samples/5_common_sports_injuries.mp3 and summarize the key points'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute AssemblyAI actions with your Agent

Why Use Composio?

AI Native AssemblyAI Integration

  • Supports both AssemblyAI MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable transcription and audio intelligence workflows
  • Rich coverage for creating transcripts, checking status, reading results, and pulling insights from audio

Managed Auth

  • Secure API key storage for AssemblyAI credentials, without hard-coding secrets in agent code
  • Central place to manage, scope, and revoke AssemblyAI access
  • Per user and per environment credentials for safer transcription workflows

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear tool schemas help agents pick the right AssemblyAI action for transcription, summarization, and retrieval tasks
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access AssemblyAI
  • Scoped, least privilege access to AssemblyAI transcription and audio intelligence workflows
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use AssemblyAI with any AI Agent Framework

Choose a Framework you want to connect AssemblyAI with

FAQ

Frequently asked questions

Yes, AssemblyAI requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with AssemblyAI.It takes 30 seconds.

Managed auth, hosted MCP servers, and every AssemblyAI tool your agent needs.Free to start.

Start building