How to Use the AssemblyAI MCP in Windsurf

Q: Does AssemblyAI in Windsurf support batch processing?

You can use listtranscripts to pull up your recent files and handle them one by one. The agent manages the sequence for you.

Q: What happens if a transcript fails to process?

Use gettranscript to check the current status of your request. It will return the result or an error message if the file is invalid.

Use Cascade in Windsurf to transcribe audio and pull insights from your media files directly in your workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AssemblyAI MCP to Windsurf

Create your Vinkius account to connect AssemblyAI to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup AssemblyAI with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Transcribe and summarize with Windsurf

Cascade handles the heavy lifting by passing your audio URLs to `transcribe_audio_url`. You get the full text back without leaving the editor. Once the file is processed, ask Cascade to run `get_summary` to pull out the key points for your project documentation.

Identify speakers and topics in Windsurf

Pass your transcript ID to `get_speakers` so Cascade can label who said what in the meeting logs. It keeps your team records organized. Then use `get_topics` to see what the conversation actually covered. This MCP Server makes it simple to tag content without manual review.

Analyze sentiment with Windsurf

Call `get_sentiments` through your agent to gauge the tone of your recorded calls. You'll see exactly how your users feel about the latest feature. If you need to clean up your workspace, `delete_transcript` lets you purge old files immediately. Cascade manages the cleanup so you don't have to.

Setup guide

Set up AssemblyAI MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the AssemblyAI MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my AssemblyAI payment history." If connected, Cascade will call the AssemblyAI tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "assemblyai-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AssemblyAI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect AssemblyAI now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about AssemblyAI MCP in Windsurf

Open your MCP settings in the Cascade panel. Add the server details there and hit refresh to load the tools.

Yes, it can. Just point the agent to your file and ask it to run the `get_chapters` tool to generate timestamps.

You can use `list_transcripts` to pull up your recent files and handle them one by one. The agent manages the sequence for you.

Use `get_transcript` to check the current status of your request. It will return the result or an error message if the file is invalid.

Your audio files and transcript text are processed securely through the API endpoint. No raw data is stored by the server beyond what is needed to fulfill your requests.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript