How to Use the Duolingo MCP in Windsurf
Use the Duolingo MCP Server in Windsurf to track streaks, XP, and leaderboards directly within your coding flow.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Duolingo MCP to Windsurf
Create your Vinkius account to connect Duolingo 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.
Fetch real-time Duolingo stats in Windsurf
Cascade pulls your current streak, total XP, and language progress without leaving the editor. Use `get_user_by_username` to grab profile data and display it in your dashboard. Windsurf chains these calls automatically. It parses the JSON output and updates your local files or status bars as you work.
Build vocabulary tools with Duolingo data
Generate flashcards by querying `get_dictionary_hints` for specific word translations. You get the raw data needed to populate your own study apps. Cascade handles the logic for you. It maps the source and target language codes and formats the response for your project files.
Monitor your Duolingo leaderboard in Windsurf
Keep an eye on your weekly tier standing using `get_leaderboard`. It tracks your rank against friends automatically so you know when to push for more XP. Windsurf refreshes this data on your command. You see the updated leaderboard positions without switching browser tabs.
Set up Duolingo 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 Duolingo MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. 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 Duolingo payment history." If connected, Cascade will call the Duolingo tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"duolingo-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Duolingo. 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.
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 Duolingo MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Duolingo MCP today
We host it, we monitor it, we maintain it. You just paste one token.
