Duolingo MCP. Track Streaks, XP, and Language Progress Automatically
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Duolingo tracks language learning progress by pulling public user data right into your agent. View XP totals, current streaks, friend lists, and leaderboard rankings for any supported language.
It also gives translation hints and lets you browse in-app store items—all without needing a developer API key.
What your AI agents can do
Get daily leaderboard
Gets the top users and their XP scores on the leaderboard for a specified language on the current day.
Get dictionary hints
Returns translation pairs between two languages, useful for building flashcards or vocabulary tools.
Get friends
Retrieves a user's friend list, including each person's current streaks and total XP.
Get a user's public profile details, including their total XP and current language focus.
View a list of friends for any user along with their individual streaks and XP totals.
Identify the top users based on XP scores for a specific language on a given day.
Fetch translation hints between two specified languages, useful for building flashcards or quizzes.
List available items from the Duolingo store, such as streak freezes and power-ups.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Duolingo: 8 Tools for Learning Data Tracking
These tools allow you to pull everything from Duolingo's public data—from user profiles and friend activity to daily leaderboards and translation hints.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Duolingo on Vinkius019d8431get daily leaderboard
Gets the top users and their XP scores on the leaderboard for a specified language on the current day.
019d8431get dictionary hints
Returns translation pairs between two languages, useful for building flashcards or vocabulary tools.
019d8431get friends
Retrieves a user's friend list, including each person's current streaks and total XP.
019d8431get leaderboard
Gets leaderboard data for a specific user ID or username, showing their ranking and XP.
019d8431get store items
Lists available items from the Duolingo store, including names, prices, and descriptions.
019d8431get user by id
Retrieves a user's full profile data using their unique numerical ID.
019d8432get user by username
Gets a public user profile by username, detailing XP, streak, and current language study.
019d8432get version info
Provides information on the API version and all supported languages for the platform.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Duolingo, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tracking student activity used to mean logging into dashboards and clicking through pages.
Today, tracking progress means juggling tabs: checking the leaderboard on one screen, copying a user's streak from their profile page, and then opening a separate spreadsheet to record the data. It’s slow, prone to copy-paste errors, and you always risk missing the most up-to-date score.
With this MCP, your agent handles it all. You simply tell it which language or user group you want to track. The platform pulls the current metrics—like XP totals or friend streaks—and gives them back in a clean data format that your workflow can use immediately.
get_dictionary_hints delivers structured vocabulary pairs for building learning tools.
Before, if you needed translation hints, you had to open the Duolingo website and manually check the dictionary for every word. Then, you'd have to copy those results into your app’s database or quiz generator, wasting time on formatting.
Now, just ask your agent for the hint pairs. It sends back clean JSON data containing the source words and their translations between any two supported languages. You get structured vocabulary ready to load instantly.
What you can do with this MCP connector
You need to track how people are learning a new language, but manual checking of Duolingo dashboards is a waste of time. This MCP lets your agent pull structured data about user progress directly from the platform. You can view detailed profiles, check friend activity, and find out who's leading the board for Spanish today.
Need to build an app that combines learning metrics with, say, billing records? The real power comes when you chain this Duolingo MCP with other services in Vinkius. Because all tool calls run inside a secure V8 isolate sandbox, your agent can pull user data and then pass it to another process without ever risking key exposure or needing manual oversight of credentials passing through the zero-trust proxy.
It's pure, reliable data flow for building complex learning tools.
019d8432-3514-73d0-bbb5-3fc2b80ba751 
How Duolingo MCP Works
- 1 Tell your agent which specific data you need—for example, 'Show me the leaderboard for French today.'
- 2 Your AI client calls this MCP, requesting the necessary information like a user's username or language code.
- 3 The platform returns clean, structured JSON containing the requested progress metrics, streaks, or rankings.
The bottom line is: you get accurate Duolingo data without leaving your AI workflow.
Who Is Duolingo MCP For?
Anyone running educational platforms or corporate training programs. Think curriculum designers who need to audit student engagement, or product managers building language tools that can't afford manual dashboard checks.
Needs to check user progress and friend activity for groups of students without logging into the platform.
Builds beta features that rely on external data, needing metrics like leaderboards or store item pricing to validate design choices.
Needs to pull dictionary hints programmatically to generate large sets of flashcards for a new module.
What Changes When You Connect
- Monitor social engagement: Use
get_friendsto instantly see a user's entire circle and their current streaks without manual checks. - Benchmark performance: The
get_daily_leaderboardtool lets you quickly identify top performers across specific languages for the day. - Build learning aids: Need vocabulary?
get_dictionary_hintspulls translation pairs, making it simple to generate structured flashcard content. - Audit user status: Use
get_user_by_usernameorget_user_by_idto pull a clean profile snapshot showing XP and skill progress for any account. - Understand the ecosystem: The
get_store_itemstool lists what's available in the Duolingo store, useful for feature comparison or monetization planning.
Real-World Use Cases
Analyzing Team Cohorts
A corporate trainer needs to audit a new cohort of 50 employees. Instead of checking 50 profiles manually, the agent calls get_friends and get_user_by_username for all users to report back on average streaks and XP totals.
Creating Dynamic Quizzes
A developer building a language practice app needs word translations. The agent calls get_dictionary_hints with three source words and two target languages, getting clean pairs for immediate use in the quiz engine.
Running Daily Contests
To run a daily internal contest, the agent uses get_daily_leaderboard, filtering by language code. It instantly gets the top 10 users and their scores for real-time leaderboard display.
Debugging User Data Flow
A developer needs to verify if a user account was correctly created in the system. They use get_user_by_id with the numeric ID, confirming the profile data before integrating it into other services.
The Tradeoffs
Assuming Profile Data is Universal
Calling a function expecting full skill trees or detailed history when only basic public metrics are available.
→
Always check the difference between get_user_by_username and get_user_by_id. Use the ID if you need maximum detail, but be aware that deep progress data often still requires client authentication.
Mixing Data Sources Blindly
Trying to build a full user report by manually copying streaks from one dashboard and XP from another.
→
Use this MCP as the single source of truth. Call get_friends for social context, then call get_user_by_username for individual metrics. Keep data retrieval in the agent.
Ignoring Language Specifics
Running a leaderboard query without specifying both the language code and timezone.
→
Always specify parameters when calling get_daily_leaderboard to ensure the results match your intended region and course.
When It Fits, When It Doesn't
Use this MCP if you need public, structured data about Duolingo user activity—specifically profiles, streaks, leaderboards, or basic translation pairs. It's perfect for auditing student engagement or powering educational tools that display metrics. Don't use it if you require private account details (e.g., detailed spending history or locked feature status), as those usually need specific authentication credentials not covered by the public endpoints. If your goal is to compare this progress data against a CRM record, connect this MCP with the CRM MCP via Vinkius; that cross-chaining capability lets your agent build automations spanning multiple platforms without you having to write complex integration code.
Common Questions About Duolingo MCP
Do I need a Duolingo account to use this? +
No! Public endpoints like user profiles, version info and dictionary hints work without authentication. Just provide a username to look up. For private data (your own progress, store items), you'd need to be logged into Duolingo.
What languages are supported? +
Duolingo supports 40+ languages including English, Spanish, French, German, Italian, Portuguese, Japanese, Korean, Chinese, Hindi and many more. Use get_version_info to see the full list of supported language codes.
Can I get my full learning progress? +
The public API returns limited profile data. For full progress including individual skill levels and detailed stats, you need to be authenticated with your Duolingo session. The username-based endpoint returns basic info like total XP, streak and current language.
Can I get translation hints for vocabulary? +
Yes! Use get_dictionary_hints with target and source language codes plus a list of words. It returns common translations for each word, useful for building flashcards or studying vocabulary.
How do I use `get_friends` to view a list of usernames, streaks, and XP totals? +
Yes, you can get a user's public friends list. This tool returns the friend's username, ID, streak count, and total XP for everyone connected.
How does `get_daily_leaderboard` handle timezones when showing top users by XP? +
The tool lets you specify a timezone and language code. This guarantees the leaderboard data is correct for the region's local day, so your rankings are accurate.
What does `get_version_info` tell me about available languages or features? +
It returns metadata about the Duolingo API version. You can use this info to verify which language codes and specific capabilities are supported before calling other tools.
Do I need special credentials to get full details using `get_store_items`? +
No, but full detail requires authentication. The tool notes that while it provides item IDs, names, and prices, detailed information needs user login.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.