How to Use the Crowdin MCP in Windsurf

Q: How do I get Windsurf to check translation progress in Crowdin?

Just ask it directly. Windsurf's Cascade agent can use the listprojectfiles tool to see the translation percentage for each file or getprojectdetails for a high-level summary.

Q: Can Windsurf find specific screenshots in my Crowdin project?

Yes, it can. The listprojectscreenshots tool lets your agent find screenshots and the strings they're linked to, giving you visual context without opening a browser.

Let Windsurf's Cascade agent run your entire Crowdin localization workflow. It checks project status, pulls files, and finds TMs on its own.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Crowdin MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get a Full Project Snapshot

Ask Windsurf for a project update and its Cascade agent gets to work. It can start with `list_projects` to find the right one, then use `get_project_details` to pull its core settings and `list_project_files` to see how translation is going on a per-file basis. Because Cascade chains these steps, you don't have to prompt it for each tool. You just ask for the end result—a full status report—and Windsurf figures out how to get it from Crowdin. It's the difference between asking for directions and just being teleported there.

Find Translation Assets with this MCP Server

Stop digging through the Crowdin UI to find the right translation memory or glossary. Just tell Windsurf what you need. It uses `list_translation_memories` and `list_glossaries` to find the exact assets for your project's language pairs. This is a huge time-saver when you're setting up a new project or making sure an existing one is using the right terminology. Cascade can even cross-reference TMs with project languages to spot mismatches before they become a problem.

Automate Progress and Cost Reporting

Your agent can now act as your project manager. Give Windsurf a goal like "show me all pending proofreading tasks" and it will use `list_project_tasks` to find them. You can also ask it to pull cost estimates or progress reports. It uses the `list_project_reports` tool to find reports you've already generated in Crowdin. This means you can get updates without ever leaving your IDE. Just ask, and the information appears.

Setup guide

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

mcp_config.json

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

Just ask it directly. Windsurf's Cascade agent can use the `list_project_files` tool to see the translation percentage for each file or `get_project_details` for a high-level summary.

Use the built-in MCP Marketplace in Windsurf. Find the Crowdin server and click install. Your tools will be available in the MCP panel right away.

Yes, it can. The `list_project_screenshots` tool lets your agent find screenshots and the strings they're linked to, giving you visual context without opening a browser.

You can ask Windsurf to list all open translation or proofreading tasks. It uses the `list_project_tasks` tool to pull titles, types, and assignees directly from Crowdin.

It only touches metadata. The server can see project settings, file names, revision history, task lists, and language codes. It doesn't access raw translation strings or user PII. Your connection is sandboxed and ephemeral on Vinkius.

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