How to Use the DeepL MCP in Windsurf

Q: How do I configure the DeepL MCP Server in Windsurf?

Add the server configuration to your mcpconfig.json file under the mcpServers key. Once saved, Cascade immediately discovers this MCP Server and its translation tools.

Q: Can Windsurf translate entire files with DeepL?

Yes. Cascade reads your local files, calls translatetext through the MCP Server, and writes the translated output directly back into your project.

Q: How does Windsurf handle translation tone using DeepL?

Windsurf chooses between translateformal and translateinformal based on your prompt's context. It automatically applies the correct linguistic tone to your target files without manual editing.

Q: Can I use my existing DeepL glossaries in Windsurf?

Yes, this integration lets Windsurf call listglossaries to find your saved glossaries. You can tell Cascade to translate your files using a specific glossary ID to keep brand terms intact.

Translate files and text directly inside Windsurf by letting Cascade manage your multi-language files.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DeepL MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate code translation with Windsurf and DeepL

This DeepL MCP Server lets Cascade translate your application localization files on the fly. When you tell Cascade to translate a JSON locale file, it calls `translate_text` to convert raw strings and writes the new file directly to your workspace. You don't have to copy-paste back and forth between your editor and a browser. Cascade reads your existing localization structure, plans the translation steps, and updates your project files in one shot. It handles the API limits by checking `get_usage` before running large batches, making sure your translation pipeline doesn't break mid-run.

Manage brand terminology inside Cascade

Cascade uses `create_glossary` to build custom dictionaries so your brand terms stay consistent across languages. If you tell Cascade to translate technical docs, it first checks `list_glossaries` to find the right terminology mapping. This keeps your UI text from looking like a cheap machine translation. The agent runs `translate_with_glossary` to apply your custom rules automatically. You get accurate, context-aware translations in Windsurf without manually correcting wrong terms after Cascade writes the code.

Control tone directly from your Windsurf chat

This MCP Server exposes `translate_formal` and `translate_informal` to let Cascade adjust your copy's tone depending on the target market. If Cascade is writing a user-facing email template, it picks the informal tool. For legal terms or privacy policies, it switches to the formal variant. You guide the agent with a single prompt about your target audience. Cascade handles the tool selection, processes the files, and displays the diff right inside your Windsurf editor.

Setup guide

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

mcp_config.json

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

Add the server configuration to your `mcp_config.json` file under the `mcpServers` key. Once saved, Cascade immediately discovers this MCP Server and its translation tools.

Yes. Cascade reads your local files, calls `translate_text` through the MCP Server, and writes the translated output directly back into your project.

Windsurf chooses between `translate_formal` and `translate_informal` based on your prompt's context. It automatically applies the correct linguistic tone to your target files without manual editing.

Yes, this integration lets Windsurf call `list_glossaries` to find your saved glossaries. You can tell Cascade to translate your files using a specific glossary ID to keep brand terms intact.

Your translation text and glossary terms go directly to DeepL API endpoints through Vinkius's secure sandboxed connection. No translation data is stored on Vinkius servers, keeping your proprietary source code and brand dictionaries private.

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