# Duolingo MCP for AI Agents AI Agent Connect > Duolingo MCP lets you pull public language learning data directly into your AI client. You can check user profiles, grab dictionary hints for translations, and pull leaderboard rankings without needing an API key. It's the fastest way to get real-time stats on streaks, XP, and progress for learners and educators. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_bZJAGYPiuVrSCxUsIrFbawCKNsjHWAbf05lVgUFK/ai-agent-connect - **Tags:** language-learning, gamification, user-progress, skill-tracking, educational-data, leaderboards ## Description Connect to Duolingo and explore language learning progress through natural conversation. This Connector lets you pull public data into your AI client without the headache of managing API keys. You can ask your agent to check a user's public profile to see their total XP, current streak, and which skills they're working on. If you're trying to build a custom vocabulary list, you can grab translation hints between different languages on the fly. For those who love the gamified side of learning, you can pull daily leaderboards or browse the store for items like streak freezes. It's a great way to see how your friends are doing or to gather data for building your own educational tools. Because it focuses on public endpoints, it's ready to use as soon as you connect it via Vinkius. ## Tools ### get_dictionary_hints Get translation pairs for specific tokens between two language codes. This is perfect for building flashcards or vocabulary lists. ### get_daily_leaderboard See top users by XP for the current day. You can also specify a language code and timezone for specific results. ### get_friends Get a list of a user's friends along with their IDs, streaks, and XP totals. This helps you see who is currently active. ### get_leaderboard Pull rankings with usernames, XP totals, and positions for a specific user. This helps you see where someone stands. ### get_store_items Get item IDs, names, prices, and descriptions for Duolingo store items. Use this to see what power-ups are available. ### get_user_by_id Get a Duolingo user profile using their numeric ID. This is a precise way to pull data when you have the unique ID. ### get_user_by_username Get a user's username, avatar, current language, total XP, and streak. Use this to quickly look up a friend's progress. ### get_version_info Get Duolingo API version info including supported languages. Use this to check which language codes are currently active. ## Prompt Examples **Prompt:** ``` Who's winning on the Spanish leaderboard today? ``` **Response:** ``` ### Top 5 Spanish Learners Today | Rank | Username | XP Total | | :--- | :--- | :--- | | 1 | polyglot_pro | 850 | | 2 | maria_es | 720 | | 3 | john_doe | 650 | | 4 | language_lover | 580 | | 5 | spanish_student | 510 | *Note: Rankings are updated daily based on total XP.* ``` **Prompt:** ``` Give me translation hints for 'apple', 'book', and 'river' from English to French. ``` **Response:** ``` ### Translation Hints (en -> fr) * **apple** $\rightarrow$ pomme * **book** $\rightarrow$ livre * **river** $\rightarrow$ rivière Would you like to see hints for any other words? ``` **Prompt:** ``` What is the progress for the user 'travel_bug'? ``` **Response:** ``` ### User Profile: travel_bug * **Total XP:** 2,450 * **Current Streak:** 12 days * **Current Language:** French * **Status:** Active learner They're currently making steady progress in their French studies. ``` ## Capabilities ### Fetch user profiles Get XP, streaks, and skill progress for any public user. ### Pull dictionary hints Get translation pairs between different language codes. ### Check leaderboards See top rankings for specific languages or users. ### Browse store items See available power-ups and streak freezes. ### List friends See a user's friend list with their current streaks. ## Use Cases ### Vocabulary Building A student asks for translation hints for 10 common verbs to create a new study sheet. ### Competition A learner asks the agent to show the top 10 Spanish speakers today to see if they can climb the ranks. ### Progress Check A teacher asks for the public profile of a student to see their total XP and current streak. ### Store Research A developer uses get_store_items to pull a list of available power-ups for a project. ## Benefits - Skip the API key setup because this Connector works with public data for immediate access to Duolingo stats. - Use get_dictionary_hints to quickly get translation pairs for words you're struggling to remember. - Stay on top of your goals by pulling live data from get_daily_leaderboard to see your daily rank. - Get a clear view of your social circle's progress with get_friends to see who's hitting new milestones. - Easily check any user's status using get_user_by_username to see their XP and current streak without leaving your chat. ## How It Works The bottom line is you get live Duolingo data in your chat window without managing API keys. 1. Subscribe to the Duolingo MCP on Vinkius. 2. Connect your AI client to the Vinkius catalog. 3. Ask your agent to pull specific Duolingo data like leaderboards or profile stats. ## Frequently Asked Questions **Can I use the Duolingo MCP without an API key?** Yes. This Connector works with public endpoints, so you can start pulling stats and hints immediately without needing to manage an API key. **What kind of language data can the Duolingo MCP pull?** It can pull public user profiles, current streaks, total XP, daily leaderboards, and friend lists. **Can I see my friends' progress with the Duolingo MCP?** Yes, you can pull a friend's list to see their usernames, IDs, current streaks, and total XP. **How do I get dictionary hints for my vocabulary list?** Just ask your agent to provide translation hints for a list of words. It will pull the data for you instantly. **Does the Duolingo MCP work for every language?** It supports the languages currently available in the Duolingo public API. You can check the specific supported codes via the version info tool. **Is the Duolingo MCP good for building my own app?** It's great for developers who need to pull public data like dictionary hints or store items to power their own educational tools. **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.