@udondan/duolingo 1.0.0

package/dist/client/types.d.ts

@@ -0,0 +1,272 @@
+/**
+ * TypeScript interfaces for Duolingo REST API response shapes.
+ * Based on the unofficial Duolingo API at https://www.duolingo.com/users/<username>
+ */
+export interface DuolingoCalendarEntry {
+    datetime: number;
+    improvement: number;
+    event_type?: string | null;
+    skill_id?: string | null;
+}
+export interface DuolingoSkill {
+    id: string;
+    name: string;
+    title: string;
+    learned: boolean;
+    strength: number;
+    progress_percent: number;
+    words: string[];
+    dependencies_name: string[];
+    dependency_order?: number;
+    [key: string]: unknown;
+}
+export interface DuolingoLanguageData {
+    streak: number;
+    language_string: string;
+    level_progress: number;
+    num_skills_learned: number;
+    level_percent: number;
+    level_points: number;
+    next_level: number;
+    level_left: number;
+    language: string;
+    points: number;
+    fluency_score: number | null;
+    level: number;
+    calendar: DuolingoCalendarEntry[];
+    skills: DuolingoSkill[];
+    [key: string]: unknown;
+}
+export interface DuolingoLanguage {
+    language: string;
+    language_string: string;
+    learning: boolean;
+    current_learning: boolean;
+    level: number;
+    points: number;
+    streak: number;
+    [key: string]: unknown;
+}
+export interface DuolingoTrackingProperties {
+    num_followers?: number;
+    num_following?: number;
+    streak?: number;
+    gems?: number;
+    [key: string]: unknown;
+}
+export interface DuolingoUserData {
+    username: string;
+    bio: string;
+    id: number;
+    cohort: number | null;
+    learning_language_string: string;
+    /** Returns human-readable relative text. Use creation_date for ISO string. */
+    created?: string;
+    /** ISO date string e.g. "2025-08-07T17:13:57". */
+    creation_date?: string;
+    /** Unix ms timestamp. */
+    created_dt?: number;
+    gplus_id?: string;
+    twitter_id?: string;
+    admin: boolean;
+    location: string | null;
+    fullname: string;
+    avatar: string;
+    ui_language: string;
+    daily_goal: number | null;
+    site_streak: number;
+    streak_extended_today: boolean;
+    notify_comment: boolean;
+    deactivated: boolean;
+    tts_base_url?: string;
+    tracking_properties?: DuolingoTrackingProperties;
+    calendar: DuolingoCalendarEntry[];
+    languages: DuolingoLanguage[];
+    language_data: Record<string, DuolingoLanguageData>;
+    [key: string]: unknown;
+}
+/**
+ * A course entry from the 2023-05-23 API.
+ * Covers language courses as well as non-language subjects (math, chess, music).
+ */
+export interface DuolingoCourse {
+    id: string;
+    /** Subject type: 'language' | 'math' | 'chess' | 'music' */
+    subject: string;
+    /** Short topic code, e.g. 'es', 'bt' (math), 'ch' (chess), 'mt' (music). */
+    topic: string;
+    xp: number;
+    fromLanguage: string;
+    /** Only present for language courses. */
+    learningLanguage?: string;
+    /** Only present for language courses. */
+    title?: string;
+    /** Only present for language courses. */
+    authorId?: string;
+    [key: string]: unknown;
+}
+export interface DuolingoStreakInfo {
+    length: number;
+    lastExtendedDate?: string;
+    startDate?: string;
+    endDate?: string;
+}
+export interface DuolingoStreakDataV2 {
+    currentStreak: DuolingoStreakInfo | null;
+    previousStreak: DuolingoStreakInfo | null;
+    longestStreak?: DuolingoStreakInfo;
+    updatedTimestamp?: number;
+    [key: string]: unknown;
+}
+/** User data from the 2023-05-23 API — includes non-language courses. */
+export interface DuolingoUserDataV2 {
+    id: number;
+    username: string;
+    name: string | null;
+    picture: string;
+    totalXp: number;
+    streak: number;
+    streakData: DuolingoStreakDataV2;
+    courses: DuolingoCourse[];
+    hasPlus: boolean;
+    subscriberLevel: string;
+    fromLanguage: string;
+    learningLanguage: string;
+    location?: string | null;
+    creationDate?: number;
+    [key: string]: unknown;
+}
+export interface DuolingoUserIdResponse {
+    users: {
+        id: number;
+    }[];
+}
+export interface DuolingoShopItem {
+    id: string;
+    name?: string;
+    type: string;
+    localizedDescription?: string;
+    price: number;
+    currencyType: string;
+    lastUsedDate?: number;
+    lastPurchaseDate?: number;
+    isActive?: boolean;
+    value?: number;
+    [key: string]: unknown;
+}
+export interface DuolingoShopItemsResponse {
+    shopItems: DuolingoShopItem[];
+}
+export interface DuolingoHealth {
+    eligibleForFreeRefill: boolean;
+    healthEnabled: boolean;
+    hearts: number;
+    maxHearts: number;
+    secondsPerHeartSegment: number;
+    secondsUntilNextHeartSegment: number | null;
+    useHealth: boolean;
+    unlimitedHeartsAvailable: boolean;
+}
+export interface DuolingoStreakGoalCheckpoint {
+    length: number;
+    dayInterval: number;
+    tier: number;
+}
+export interface DuolingoStreakGoal {
+    userId: string;
+    lastCompleteGoal: number;
+    checkpoints: DuolingoStreakGoalCheckpoint[];
+    nextSelectedGoal?: DuolingoStreakGoalCheckpoint;
+}
+export interface DuolingoStreakGoalCurrentResponse {
+    hasActiveGoal: boolean;
+    streakGoal: DuolingoStreakGoal | null;
+}
+export interface DuolingoStreakGoalOption {
+    length: number;
+    dayInterval: number;
+    tier: number;
+}
+export interface DuolingoStreakGoalNextOptionsResponse {
+    currentStreakOptions: DuolingoStreakGoalOption[];
+    previousStreakOptions: DuolingoStreakGoalOption[];
+}
+export interface DuolingoXpGain {
+    skillId: string | null;
+    xp: number;
+    time: number;
+    eventType?: string | null;
+}
+export interface DuolingoStreakData {
+    updatedTimestamp: number;
+    [key: string]: unknown;
+}
+export interface DuolingoDailyProgress {
+    xpGoal: number;
+    xpGains: DuolingoXpGain[];
+    streakData: DuolingoStreakData;
+}
+export interface DuolingoLeaderboardData {
+    ranking: Record<string, string>;
+}
+/** A user entry from /2017-06-30/friends/users/{id}/following or /followers */
+export interface DuolingoFriendUser {
+    userId: number;
+    username: string;
+    displayName: string | null;
+    picture: string;
+    totalXp: number;
+    isFollowing: boolean;
+    isFollowedBy: boolean;
+    hasSubscription: boolean;
+    userScore?: {
+        courseId: string;
+        score: number | null;
+    };
+    [key: string]: unknown;
+}
+export interface DuolingoFollowingResponse {
+    following: {
+        users: DuolingoFriendUser[];
+        totalUsers: number;
+        cursor: string | null;
+    };
+}
+export interface DuolingoFollowersResponse {
+    followers: {
+        users: DuolingoFriendUser[];
+        totalUsers: number;
+        cursor: string | null;
+    };
+}
+export interface DuolingoSessionRequest {
+    fromLanguage: string;
+    learningLanguage: string;
+    challengeTypes: string[];
+    skillId?: string;
+    type: string;
+    juicy: boolean;
+    smartTipsVersion: number;
+}
+export interface DuolingoChallenge {
+    prompt?: string;
+    tts?: string;
+    metadata?: {
+        non_character_tts?: {
+            tokens: Record<string, string>;
+        };
+    };
+    tokens?: DuolingoToken[];
+    [key: string]: unknown;
+}
+export type DuolingoToken = {
+    tts?: string;
+    value?: string;
+    [key: string]: unknown;
+} | DuolingoToken[];
+export interface DuolingoSessionResponse {
+    challenges: DuolingoChallenge[];
+    /** Map of TTS URL → annotation data. Keys are the TTS CDN URLs. */
+    ttsAnnotations?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}

package/dist/client/types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interfaces for Duolingo REST API response shapes.
+ * Based on the unofficial Duolingo API at https://www.duolingo.com/users/<username>
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @udondan/duolingo — public library API
+ *
+ * Use this entry point when importing the package as a library:
+ *
+ *   import { DuolingoClient } from '@udondan/duolingo';
+ *
+ * For the MCP server binary, use the `duolingo-mcp` CLI (installed via
+ * `npm install -g @udondan/duolingo`) or the `@udondan/duolingo/server` export.
+ */
+export { DuolingoClient, getClient, resetClient } from './client/duolingo.js';
+export { DuolingoClientError, DuolingoAuthError, DuolingoNotFoundError, DuolingoCaptchaError, DuolingoLanguageNotFoundError, } from './client/errors.js';
+export type { DuolingoUserData, DuolingoUserDataV2, DuolingoLanguage, DuolingoLanguageData, DuolingoCalendarEntry, DuolingoSkill, DuolingoTrackingProperties, DuolingoCourse, DuolingoFriendUser, DuolingoFollowingResponse, DuolingoFollowersResponse, DuolingoDailyProgress, DuolingoXpGain, DuolingoStreakData, DuolingoStreakDataV2, DuolingoStreakInfo, DuolingoStreakGoal, DuolingoStreakGoalCheckpoint, DuolingoStreakGoalCurrentResponse, DuolingoStreakGoalNextOptionsResponse, DuolingoStreakGoalOption, DuolingoShopItem, DuolingoHealth, DuolingoLeaderboardData, DuolingoSessionRequest, DuolingoSessionResponse, DuolingoChallenge, DuolingoToken, } from './client/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAEV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,0BAA0B,EAG1B,cAAc,EAGd,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EAGzB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAGlB,oBAAoB,EACpB,kBAAkB,EAGlB,kBAAkB,EAClB,4BAA4B,EAC5B,iCAAiC,EACjC,qCAAqC,EACrC,wBAAwB,EAGxB,gBAAgB,EAGhB,cAAc,EAGd,uBAAuB,EAGvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @udondan/duolingo — public library API
+ *
+ * Use this entry point when importing the package as a library:
+ *
+ *   import { DuolingoClient } from '@udondan/duolingo';
+ *
+ * For the MCP server binary, use the `duolingo-mcp` CLI (installed via
+ * `npm install -g @udondan/duolingo`) or the `@udondan/duolingo/server` export.
+ */
+// Client class and singleton helpers
+export { DuolingoClient, getClient, resetClient } from './client/duolingo.js';
+// All error classes
+export { DuolingoClientError, DuolingoAuthError, DuolingoNotFoundError, DuolingoCaptchaError, DuolingoLanguageNotFoundError, } from './client/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qCAAqC;AACrC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Duolingo MCP Server
+ *
+ * A TypeScript MCP server that exposes Duolingo learning data and actions to
+ * LLM agents via the unofficial Duolingo REST API.
+ *
+ * Authentication:
+ *   Set the following environment variables before starting the server:
+ *   - DUOLINGO_USERNAME: Your Duolingo username
+ *   - DUOLINGO_JWT: Your Duolingo JWT token (extracted from browser)
+ *
+ * Usage:
+ *   npm run build && npm start
+ *   # or in development:
+ *   npx tsx src/server.ts
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/server.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * Duolingo MCP Server
+ *
+ * A TypeScript MCP server that exposes Duolingo learning data and actions to
+ * LLM agents via the unofficial Duolingo REST API.
+ *
+ * Authentication:
+ *   Set the following environment variables before starting the server:
+ *   - DUOLINGO_USERNAME: Your Duolingo username
+ *   - DUOLINGO_JWT: Your Duolingo JWT token (extracted from browser)
+ *
+ * Usage:
+ *   npm run build && npm start
+ *   # or in development:
+ *   npx tsx src/server.ts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerAccountTools } from './tools/account.js';
+import { registerLanguageTools } from './tools/language.js';
+import { registerShopTools } from './tools/shop.js';
+const server = new McpServer({
+    name: 'duolingo_mcp',
+    version: '1.0.0',
+}, {
+    instructions: 'This server provides access to Duolingo learning data via the unofficial ' +
+        'Duolingo API. You can query user profiles, streak information, language ' +
+        'progress, topics, words, TTS audio, and more. ' +
+        'Authentication requires DUOLINGO_USERNAME and DUOLINGO_JWT environment variables. ' +
+        'To get your JWT token: log in to Duolingo in a browser, open the developer ' +
+        'console, and run: ' +
+        "document.cookie.match(new RegExp('(^| )jwt_token=([^;]+)'))[0].slice(11)",
+});
+registerAccountTools(server);
+registerLanguageTools(server);
+registerShopTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EACV,2EAA2E;QAC3E,0EAA0E;QAC1E,gDAAgD;QAChD,oFAAoF;QACpF,6EAA6E;QAC7E,oBAAoB;QACpB,0EAA0E;CAC7E,CACF,CAAC;AAEF,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/account.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Account-level Duolingo MCP tools.
+ *
+ * Tools: get_user_info, get_settings, get_streak_info, get_daily_xp_progress,
+ *        get_languages, get_courses, get_friends, get_calendar, get_leaderboard,
+ *        get_shop_items, get_health, get_currencies, get_streak_goal
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAccountTools(server: McpServer): void;
+//# sourceMappingURL=account.d.ts.map

package/dist/tools/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA22B5D"}