How to Use the Maestra MCP in Windsurf

Q: How does Windsurf use Maestra to automate translations?

You give Windsurf a goal like "Translate video.mp4 to German." Its Cascade agent automatically calls uploadmediafortranscription, then translatetranscription, and finally generateaivoiceover in sequence. You don't manage the individual steps.

Q: Can I manage my Maestra files directly from Windsurf?

Yes. Your agent can use the Maestra MCP tools to listmaestrafiles, check status with getfiledetails, and organize content. It's all done through natural language commands right inside your IDE.

Automate video localization from your IDE. Tell Windsurf to translate a video, and it handles the entire Maestra pipeline for you.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Maestra MCP to Windsurf

Create your Vinkius account to connect Maestra 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 Maestra with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full-Stack Localization, Zero Clicks

This toolset connects the Maestra API to your agent. Give Windsurf's Cascade agent a high-level goal, like localizing a video for a new market. It plans the whole sequence: it calls `upload_media_for_transcription`, waits for the job to finish, and then automatically starts the translation with `translate_transcription`. It doesn't stop there. The agent can then find the right voice using `list_available_ai_voices` and create the final audio with `generate_ai_voiceover`. The entire multi-step process runs without you having to prompt each action. You just get a notification when your new localized video is ready to go.

Manage Your Media Library with Windsurf

Don't leave your IDE to check on your files. Your agent can use `list_maestra_files` and `list_account_folders` to see everything in your Maestra account. Just ask Windsurf to find a specific video, and it will use `get_file_details` to report back on its transcription or translation status. This isn't just about viewing files. You can build workflows with this MCP Server. For example, tell Cascade to "find all untranslated videos from Q2 and queue them for Spanish translation." It will chain `list_maestra_files` with `translate_transcription` for every matching file, clearing out your backlog while you work on something else.

Generate Voiceovers on the Fly

Create synthetic voiceovers right from your editor. Once you have a translated script from Maestra, you can have Windsurf find the perfect voice for it. The agent uses `list_available_ai_voices` to filter by language, gender, or style, presenting you with the best options. After you pick one, Windsurf calls `generate_ai_voiceover` with the correct file and voice IDs. Maestra gets to work creating the audio track. This is a fast way to produce marketing assets or internal training videos without booking a studio or hiring voice actors.

Setup guide

Set up Maestra 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 Maestra 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 Maestra payment history." If connected, Cascade will call the Maestra tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "maestra-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 Maestra. 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 Maestra 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 Maestra MCP in Windsurf

You give Windsurf a goal like "Translate `video.mp4` to German." Its Cascade agent automatically calls `upload_media_for_transcription`, then `translate_transcription`, and finally `generate_ai_voiceover` in sequence. You don't manage the individual steps.

Yes. Your agent can use the Maestra MCP tools to `list_maestra_files`, check status with `get_file_details`, and organize content. It's all done through natural language commands right inside your IDE.

You can set up a two-step workflow. First, tell Windsurf to transcribe the file and use `export_transcription_results` to get the text. After you review it, give a second command to proceed with `generate_ai_voiceover`.

It automates the technical work: transcription, translation, and voice generation. For critical marketing copy, you should still have a native speaker review the text from `export_transcription_results` before creating the final voiceover.

The server processes the public URLs you provide for your media files, plus the resulting transcription text and voiceover audio. Your Vinkius endpoint token is the only credential needed; your Maestra API key is managed securely on the server, never exposed to your client.

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