@lingochunk/mcp 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Olkhovskiy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# LingoChunk MCP
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server (and Claude
+Code plugin) that turns a coding agent into a language tutor grounded in **your
+own LingoChunk listening history**: your FSRS-graded vocabulary, native-audio
+transcripts and clips, and your library.
+
+It is a thin client over the LingoChunk public API (`/api/v1`): read-only tools
+for your vocabulary, transcripts and audio, plus write tools to add review cards,
+export Anki decks and save lessons. The app stays closed source; this repo is
+just the client, the committed API spec, and two lesson skills.
+
+> Status: local/preview. Not yet published to npm and not yet a public repo.
+
+## What it gives an agent
+
+Eleven tools, each wrapping one public endpoint. The first seven are read-only;
+the last four (phase 3) write to your account.
+
+| Tool | Scope | What it does |
+|---|---|---|
+| `get_vocabulary` | `vocab:read` | Your vocabulary, aggregated per word with FSRS maturity (known/learning/new/due). Filterable; incremental sync via `since` + `cursor` (additive-only, so full-resync periodically). |
+| `lookup_word` | `vocab:read` | One word: your own context plus a shared-lexicon gender/CEFR fallback. Grounds an LLM's guesses. |
+| `list_library` | `content:read` | Your ready-to-study episodes (own + followed collections), cursor-paginated. |
+| `get_transcript` | `content:read` | A submission's timestamped sentences + translations, sliceable by sentence or time range. |
+| `get_audio_url` | `content:read` | A short-lived presigned URL to the full native audio (Range-capable). |
+| `search_examples` | `content:read` | Example sentences across your library, by word (`lemma`) or text (`q`). A capped sample, not exhaustive. |
+| `get_audio_clip` | `content:read` | Cuts a short native-audio snippet, **saves it to a local file**, and returns `{path, media_type, size_bytes}` for embedding in lessons. |
+| `list_decks` | `cards:write` or `decks:export` | Your study decks with card counts, for picking a `deck_id` to add to or export. |
+| `add_card` | `cards:write` | Adds a card to your review queue (FSRS, starts new): `kind=vocab` from your vocabulary, or `kind=custom` front/back. Omit `deck_id` to use the deck for the card's own submission. |
+| `export_anki_deck` | `decks:export` | Exports a deck to Anki `.apkg` (no LLM), polling internally; returns a download URL when ready. A deck with no linked episode can't be exported. |
+| `save_lesson` | `lessons:write` | Saves a self-contained HTML lesson to your private library (10 MB cap, 100 max); returns metadata + a short-lived view URL. |
+
+Plus two skills:
+
+- **`lingochunk-lesson`** - builds a single self-contained HTML lesson (data-URI
+  audio; gap-fill, multiple-choice, listening and blur-reveal exercises) from the
+  tools above, filtering out words you already know.
+- **`lingochunk-discuss`** - a lighter, conversational "talk me through this
+  episode" workflow.
+
+## Prerequisites
+
+- Node.js >= 18.
+- A LingoChunk **personal access token**: in LingoChunk, open Settings -> API
+  access, create a token, and grant the scopes you need (`vocab:read` +
+  `content:read` cover the read tools; add `cards:write`, `decks:export` and
+  `lessons:write` for the write tools). The token is shown once and starts with
+  `lcp_`. The 403 errors from the tools name the exact scope you are missing.
+
+## Use it
+
+### Option A - Claude Code plugin (bundles the server + the skills)
+
+Build once, then point Claude Code at this directory as a plugin. The bundled
+`.mcp.json` runs the server from `dist/` via `${CLAUDE_PLUGIN_ROOT}`, and the
+`skills/` are auto-discovered.
+
+```bash
+npm install     # installs deps and builds dist/ (via the prepare script)
+export LINGOCHUNK_TOKEN=lcp_your_token_here
+```
+
+**Run `npm install` before adding the plugin.** `dist/` is gitignored and does
+not exist in a fresh checkout; the `prepare` script builds it during
+`npm install`. Until it does, `.mcp.json` points at a `dist/index.js` that is not
+there and the server will not start.
+
+Then add the plugin from its local path in Claude Code (plugin install from a
+local directory), or copy the MCP block from `.mcp.json` into your Claude Code
+MCP config, replacing `${CLAUDE_PLUGIN_ROOT}` with the absolute path to this repo.
+
+### Option B - standalone MCP server
+
+Once published to npm this will be a one-liner:
+
+```bash
+claude mcp add lingochunk --env LINGOCHUNK_TOKEN=lcp_... -- npx -y @lingochunk/mcp
+```
+
+Until then, build locally and run it directly:
+
+```bash
+npm install
+claude mcp add lingochunk --env LINGOCHUNK_TOKEN=lcp_... -- node /absolute/path/to/lingochunk-mcp/dist/index.js
+```
+
+## Configuration
+
+| Variable | Required | Default | Meaning |
+|---|---|---|---|
+| `LINGOCHUNK_TOKEN` | yes | - | Your personal access token (`lcp_...`). |
+| `LINGOCHUNK_BASE_URL` | no | `https://lingochunk.com` | API origin override (for self-host/testing). |
+| `LINGOCHUNK_CLIP_DIR` | no | `~/.cache/lingochunk-mcp` | Where `get_audio_clip` writes clip files (a private per-user dir, created mode 0700). |
+
+The token is only ever sent as an `Authorization: Bearer` header to the
+configured origin; it is never written to disk or logged.
+
+## Building a lesson
+
+Ask your agent something like "build me a lesson from yesterday's German episode"
+or "quiz me on the words I'm learning". The `lingochunk-lesson` skill drives the
+workflow: pick the source, pull a transcript slice, gather and **filter** your
+vocabulary (never quizzing you on mastered words), fetch short audio clips, and
+render one shareable HTML file. See `skills/lingochunk-lesson/`.
+
+## Repository layout
+
+```
+src/                                    the MCP server (TypeScript, stdio)
+skills/lingochunk-lesson/               the lesson skill
+skills/lingochunk-lesson/assets/lesson-template.html   self-contained HTML template
+skills/lingochunk-discuss/              the "discuss an episode" skill
+docs/integrations/fluent.md             how to plug this into the fluent tutor plugin
+spec/openapi-public-v1.json             the committed public API spec (the contract)
+scripts/smoke.ts                        live smoke test (run by hand, never in CI)
+test/                                   vitest unit tests (mocked fetch)
+.claude-plugin/plugin.json              Claude Code plugin manifest
+.mcp.json                               MCP server definition for the plugin
+```
+
+## Development
+
+```bash
+npm install        # deps + build (prepare)
+npm run build      # compile src/ -> dist/
+npm run typecheck  # type-check without emitting
+npm test           # vitest unit tests (mocked fetch; no network)
+```
+
+`spec/openapi-public-v1.json` is the source contract; it is exported from the
+LingoChunk repo (`make generate-openapi-public`) and refreshed here on each API
+release. This copy was taken from LingoChunk commit `3c226795`.
+
+### Live smoke test
+
+`scripts/smoke.ts` exercises a **real** API and is not part of `npm test`. Build
+first, then run it by hand with a real token:
+
+```bash
+npm run build
+LINGOCHUNK_TOKEN=lcp_... [LINGOCHUNK_BASE_URL=http://localhost:8000] \
+  node --experimental-strip-types scripts/smoke.ts
+```
+
+## License
+
+MIT.

package/dist/client.d.ts

@@ -0,0 +1,68 @@
+import type { Config } from "./config.js";
+/** An error returned by the LingoChunk API (non-2xx), carrying the HTTP status,
+ *  the API's `detail` message, and its stable machine-readable `code` (e.g.
+ *  ``ambiguous_lemma``) when present, so tools can branch on the outcome. */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly detail: string;
+    readonly retryAfter?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(status: number, detail: string, retryAfter?: number | undefined, code?: string | undefined);
+}
+/** A binary audio clip plus the media type the server reported. */
+export interface AudioClip {
+    data: Buffer;
+    contentType: string;
+}
+/** Result of POST /decks/{id}/export. */
+export interface DeckExportStart {
+    status: "ready" | "queued";
+    poll: string;
+}
+/** Result of GET /decks/{id}/export/status. */
+export interface DeckExportStatus {
+    status: "ready" | "pending" | "failed" | "none";
+    download_url?: string;
+}
+export type QueryValue = string | number | boolean | undefined | null;
+/** How long any single request may take before we abort it. */
+export declare const REQUEST_TIMEOUT_MS = 30000;
+/** Refuse to buffer a clip larger than this (a runaway or wrong endpoint). */
+export declare const MAX_CLIP_BYTES: number;
+/** Coerce a FastAPI error `detail` into a single readable line.
+ *
+ *  Intentional errors (400/403/404/429) carry a string detail. Automatic
+ *  request-validation errors (422) carry a LIST of `{loc, msg, ...}` objects;
+ *  without this they would collapse to the bare status text ("Unprocessable
+ *  Entity") and lose the field message that tells the agent what to fix. A
+ *  detail of any other shape is stringified (truncated) rather than dropped.
+ *  Returns undefined when there is nothing usable, so the caller keeps the
+ *  status text. */
+export declare function formatDetail(detail: unknown): string | undefined;
+/** Thin, typed client over the public `/api/v1` surface. One instance per
+ *  process, holding the configured base URL + token. */
+export declare class LingoChunkClient {
+    private readonly config;
+    constructor(config: Config);
+    private buildUrl;
+    private authHeaders;
+    private raiseForStatus;
+    /** GET a JSON endpoint. */
+    private getJson;
+    /** POST a JSON body to an endpoint and parse the JSON response. */
+    private postJson;
+    getVocabulary(params: Record<string, QueryValue>): Promise<unknown>;
+    lookupWord(params: Record<string, QueryValue>): Promise<unknown>;
+    listLibrary(params: Record<string, QueryValue>): Promise<unknown>;
+    getTranscript(submissionId: string, params: Record<string, QueryValue>): Promise<unknown>;
+    getAudioUrl(submissionId: string): Promise<unknown>;
+    searchExamples(params: Record<string, QueryValue>): Promise<unknown>;
+    listDecks(): Promise<unknown>;
+    addCard(body: object): Promise<unknown>;
+    createLesson(body: object): Promise<unknown>;
+    /** Start an Anki export (no body). 400 for a deck with no linked submission. */
+    exportDeck(deckId: number): Promise<DeckExportStart>;
+    exportDeckStatus(deckId: number): Promise<DeckExportStatus>;
+    /** GET a clip as raw audio bytes (the endpoint streams audio, not JSON). */
+    getAudioClip(submissionId: string, start: number, end: number): Promise<AudioClip>;
+}

package/dist/client.js

@@ -0,0 +1,215 @@
+/** An error returned by the LingoChunk API (non-2xx), carrying the HTTP status,
+ *  the API's `detail` message, and its stable machine-readable `code` (e.g.
+ *  ``ambiguous_lemma``) when present, so tools can branch on the outcome. */
+export class ApiError extends Error {
+    status;
+    detail;
+    retryAfter;
+    code;
+    constructor(status, detail, retryAfter, code) {
+        super(`LingoChunk API ${status}: ${detail}`);
+        this.status = status;
+        this.detail = detail;
+        this.retryAfter = retryAfter;
+        this.code = code;
+        this.name = "ApiError";
+    }
+}
+/** How long any single request may take before we abort it. */
+export const REQUEST_TIMEOUT_MS = 30_000;
+/** Refuse to buffer a clip larger than this (a runaway or wrong endpoint). */
+export const MAX_CLIP_BYTES = 25 * 1024 * 1024;
+/** Never read more than this much of an error body into the message. */
+const MAX_ERROR_BODY = 10_000;
+function truncate(value, max = 300) {
+    return value.length > max ? `${value.slice(0, max)}...` : value;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Coerce a FastAPI error `detail` into a single readable line.
+ *
+ *  Intentional errors (400/403/404/429) carry a string detail. Automatic
+ *  request-validation errors (422) carry a LIST of `{loc, msg, ...}` objects;
+ *  without this they would collapse to the bare status text ("Unprocessable
+ *  Entity") and lose the field message that tells the agent what to fix. A
+ *  detail of any other shape is stringified (truncated) rather than dropped.
+ *  Returns undefined when there is nothing usable, so the caller keeps the
+ *  status text. */
+export function formatDetail(detail) {
+    if (typeof detail === "string") {
+        return detail.trim() || undefined;
+    }
+    if (Array.isArray(detail)) {
+        const parts = detail
+            .map(formatDetailItem)
+            .filter((p) => p !== undefined);
+        return parts.length ? parts.join("; ") : undefined;
+    }
+    if (detail && typeof detail === "object") {
+        return truncate(safeStringify(detail));
+    }
+    return undefined;
+}
+function formatDetailItem(item) {
+    if (typeof item === "string")
+        return item;
+    if (item && typeof item === "object") {
+        const rec = item;
+        if (typeof rec.msg === "string") {
+            const loc = Array.isArray(rec.loc)
+                ? rec.loc
+                    .filter((p) => typeof p === "string" || typeof p === "number")
+                    .join(".")
+                : "";
+            return loc ? `${loc}: ${rec.msg}` : rec.msg;
+        }
+        return truncate(safeStringify(item));
+    }
+    return undefined;
+}
+/** Thin, typed client over the public `/api/v1` surface. One instance per
+ *  process, holding the configured base URL + token. */
+export class LingoChunkClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    buildUrl(path, params) {
+        const url = new URL(`${this.config.baseUrl}/api/v1${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null && value !== "") {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url;
+    }
+    authHeaders(accept) {
+        return {
+            Authorization: `Bearer ${this.config.token}`,
+            Accept: accept,
+            "User-Agent": "lingochunk-mcp",
+        };
+    }
+    async raiseForStatus(res) {
+        let detail = res.statusText || `HTTP ${res.status}`;
+        let code;
+        // Only read a JSON error body, and only a bounded slice of it: a 5xx from a
+        // proxy can be a whole HTML page, which we neither want to buffer nor dump
+        // into the tool message. Non-JSON errors fall back to the status text.
+        if ((res.headers.get("content-type") ?? "").includes("json")) {
+            try {
+                const raw = (await res.text()).slice(0, MAX_ERROR_BODY);
+                const body = JSON.parse(raw);
+                const formatted = formatDetail(body?.detail);
+                if (formatted)
+                    detail = formatted;
+                if (typeof body?.code === "string")
+                    code = body.code;
+            }
+            catch {
+                // Malformed or truncated JSON error body; keep the status text.
+            }
+        }
+        const retryHeader = res.headers.get("retry-after");
+        const retryAfter = retryHeader ? Number(retryHeader) : undefined;
+        throw new ApiError(res.status, detail, Number.isFinite(retryAfter) ? retryAfter : undefined, code);
+    }
+    /** GET a JSON endpoint. */
+    async getJson(path, params) {
+        const res = await fetch(this.buildUrl(path, params), {
+            method: "GET",
+            headers: this.authHeaders("application/json"),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            await this.raiseForStatus(res);
+        }
+        return (await res.json());
+    }
+    /** POST a JSON body to an endpoint and parse the JSON response. */
+    async postJson(path, body) {
+        const headers = this.authHeaders("application/json");
+        if (body !== undefined)
+            headers["Content-Type"] = "application/json";
+        const res = await fetch(this.buildUrl(path), {
+            method: "POST",
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            await this.raiseForStatus(res);
+        }
+        return (await res.json());
+    }
+    // --- Read endpoints (thin pass-throughs; the tools shape the arguments) ---
+    getVocabulary(params) {
+        return this.getJson("/vocab", params);
+    }
+    lookupWord(params) {
+        return this.getJson("/vocab/lookup", params);
+    }
+    listLibrary(params) {
+        return this.getJson("/library", params);
+    }
+    getTranscript(submissionId, params) {
+        return this.getJson(`/submissions/${encodeURIComponent(submissionId)}/transcript`, params);
+    }
+    getAudioUrl(submissionId) {
+        return this.getJson(`/submissions/${encodeURIComponent(submissionId)}/audio-url`);
+    }
+    searchExamples(params) {
+        return this.getJson("/sentences/search", params);
+    }
+    // --- Write endpoints (phase 3) ------------------------------------------
+    listDecks() {
+        return this.getJson("/decks");
+    }
+    addCard(body) {
+        return this.postJson("/cards", body);
+    }
+    createLesson(body) {
+        return this.postJson("/lessons", body);
+    }
+    /** Start an Anki export (no body). 400 for a deck with no linked submission. */
+    exportDeck(deckId) {
+        return this.postJson(`/decks/${deckId}/export`);
+    }
+    exportDeckStatus(deckId) {
+        return this.getJson(`/decks/${deckId}/export/status`);
+    }
+    /** GET a clip as raw audio bytes (the endpoint streams audio, not JSON). */
+    async getAudioClip(submissionId, start, end) {
+        const res = await fetch(this.buildUrl(`/submissions/${encodeURIComponent(submissionId)}/clip`, {
+            start,
+            end,
+        }), {
+            method: "GET",
+            headers: this.authHeaders("audio/*"),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            await this.raiseForStatus(res);
+        }
+        // Guard against buffering something huge: a short clip is a few hundred KB,
+        // so a Content-Length past the cap means a wrong/overlong request. Reject
+        // before reading the body into memory.
+        const declared = Number(res.headers.get("content-length"));
+        if (Number.isFinite(declared) && declared > MAX_CLIP_BYTES) {
+            throw new Error(`Clip is too large (${Math.round(declared / (1024 * 1024))} MB); ` +
+                "request a shorter time range.");
+        }
+        const data = Buffer.from(await res.arrayBuffer());
+        const contentType = res.headers.get("content-type") ?? "audio/mpeg";
+        return { data, contentType };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+/** Runtime configuration, read once from the environment at startup. */
+export interface Config {
+    /** Base origin of the LingoChunk API, e.g. https://lingochunk.com (no trailing slash). */
+    baseUrl: string;
+    /** Personal access token (prefix "lcp_") sent as a Bearer credential. */
+    token: string;
+    /** Directory audio clips are written to (get_audio_clip returns the file path). */
+    clipDir: string;
+}
+/**
+ * Build the config from environment variables.
+ *
+ * - LINGOCHUNK_TOKEN    (required) the personal access token, created in the
+ *   LingoChunk account settings. Must start with "lcp_".
+ * - LINGOCHUNK_BASE_URL (optional) override the API origin (default production).
+ * - LINGOCHUNK_CLIP_DIR (optional) where audio clips are saved (default a
+ *   private per-user cache dir, ~/.cache/lingochunk-mcp).
+ *
+ * Throws a clear error when the token is missing, so onboarding fails loudly
+ * rather than sending unauthenticated requests.
+ */
+export declare function loadConfig(env?: NodeJS.ProcessEnv): Config;

package/dist/config.js

@@ -0,0 +1,44 @@
+import os from "node:os";
+import path from "node:path";
+const DEFAULT_BASE_URL = "https://lingochunk.com";
+/**
+ * Build the config from environment variables.
+ *
+ * - LINGOCHUNK_TOKEN    (required) the personal access token, created in the
+ *   LingoChunk account settings. Must start with "lcp_".
+ * - LINGOCHUNK_BASE_URL (optional) override the API origin (default production).
+ * - LINGOCHUNK_CLIP_DIR (optional) where audio clips are saved (default a
+ *   private per-user cache dir, ~/.cache/lingochunk-mcp).
+ *
+ * Throws a clear error when the token is missing, so onboarding fails loudly
+ * rather than sending unauthenticated requests.
+ */
+export function loadConfig(env = process.env) {
+    const token = (env.LINGOCHUNK_TOKEN ?? "").trim();
+    if (!token) {
+        throw new Error("LINGOCHUNK_TOKEN is required. Create a personal access token in your " +
+            "LingoChunk account settings and pass it as LINGOCHUNK_TOKEN (it starts " +
+            "with 'lcp_').");
+    }
+    const baseUrl = (env.LINGOCHUNK_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    // Fail fast on a malformed origin rather than throwing an opaque error on the
+    // first request. A bare host like "localhost:8000" parses with a bogus scheme,
+    // so also require http(s).
+    let parsed;
+    try {
+        parsed = new URL(baseUrl);
+    }
+    catch {
+        throw new Error(`LINGOCHUNK_BASE_URL is not a valid URL: ${baseUrl}`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`LINGOCHUNK_BASE_URL must be an http(s) URL (e.g. https://lingochunk.com), got: ${baseUrl}`);
+    }
+    // Default to a private per-user cache dir rather than the world-readable
+    // shared temp dir: clips are the user's own study audio, so they should not
+    // land somewhere every account on the machine can read.
+    const clipDir = env.LINGOCHUNK_CLIP_DIR?.trim() ||
+        path.join(os.homedir(), ".cache", "lingochunk-mcp");
+    return { baseUrl, token, clipDir };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAY7B,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,yEAAyE;YACzE,eAAe,CAClB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,mBAAmB,IAAI,gBAAgB,CAAC,CAAC,OAAO,CACnE,MAAM,EACN,EAAE,CACH,CAAC;IACF,8EAA8E;IAC9E,+EAA+E;IAC/E,2BAA2B;IAC3B,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,2CAA2C,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,kFAAkF,OAAO,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,4EAA4E;IAC5E,wDAAwD;IACxD,MAAM,OAAO,GACX,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE;QAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEtD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { LingoChunkClient } from "./client.js";
+import { registerTools } from "./tools.js";
+const VERSION = "0.2.1";
+async function main() {
+    // Fail fast (to stderr, never stdout - stdout is the MCP wire) if the token
+    // is missing, so onboarding surfaces the problem immediately.
+    const config = loadConfig();
+    const client = new LingoChunkClient(config);
+    const server = new McpServer({ name: "lingochunk", version: VERSION });
+    registerTools(server, client, config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`lingochunk-mcp failed to start: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type LingoChunkClient } from "./client.js";
+import type { Config } from "./config.js";
+export declare function registerTools(server: McpServer, client: LingoChunkClient, config: Config): void;

package/dist/tools.js

@@ -0,0 +1,475 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { ApiError } from "./client.js";
+/** Format a successful JSON result as a single text block. */
+function jsonResult(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+/** AbortSignal.timeout rejects with a DOMException named "TimeoutError" (a
+ *  manual abort is "AbortError"); both mean the request gave up waiting. */
+function isTimeoutError(err) {
+    return (err instanceof Error &&
+        (err.name === "TimeoutError" || err.name === "AbortError"));
+}
+/** Node's fetch reports a network failure as "fetch failed" with the real
+ *  reason on `.cause` (e.g. getaddrinfo ENOTFOUND). Surface that reason. */
+function causeMessage(err) {
+    const cause = err.cause;
+    if (cause instanceof Error && cause.message)
+        return cause.message;
+    if (typeof cause === "string" && cause)
+        return cause;
+    return undefined;
+}
+/** Turn an error into a tool error result the agent can read and act on. */
+function errorResult(err) {
+    let text;
+    if (err instanceof ApiError) {
+        text = `LingoChunk API error ${err.status}: ${err.detail}`;
+        // A machine-readable code (when present) is more specific than the status.
+        if (err.code === "ambiguous_lemma") {
+            text +=
+                "\nRetry with the 'pos' (or 'submission_id') value named above to pick " +
+                    "one.";
+        }
+        else if (err.code === "duplicate_card") {
+            text += "\nThe card already exists; this is safe to ignore, not to retry.";
+        }
+        else if (err.code === "lesson_cap") {
+            text +=
+                "\nYou are at the lesson limit; delete an old lesson in your LingoChunk " +
+                    "library (Settings) to make room.";
+        }
+        else if (err.status === 401) {
+            text += "\nCheck LINGOCHUNK_TOKEN is a valid, un-revoked token (prefix lcp_).";
+        }
+        else if (err.status === 403) {
+            text +=
+                "\nThe token lacks the scope named above. Mint a new token in " +
+                    "LingoChunk settings that includes it.";
+        }
+        else if (err.status === 429 && err.retryAfter !== undefined) {
+            text += `\nRate limited; retry after ${err.retryAfter}s.`;
+        }
+    }
+    else if (isTimeoutError(err)) {
+        text =
+            "The request to the LingoChunk API timed out after 30s. Check your " +
+                "connection (and LINGOCHUNK_BASE_URL) and try again.";
+    }
+    else if (err instanceof Error) {
+        text = err.message;
+        const cause = causeMessage(err);
+        if (cause)
+            text += `: ${cause}`;
+    }
+    else {
+        text = String(err);
+    }
+    return { content: [{ type: "text", text }], isError: true };
+}
+/** Run a fetch and format its JSON, converting any error into a tool error. */
+async function runJson(fn) {
+    try {
+        return jsonResult(await fn());
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+/** Run a handler that builds its own result, converting errors uniformly. */
+async function runResult(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+const AUDIO_EXTENSIONS = {
+    "audio/mp4": ".m4a",
+    "audio/mpeg": ".mp3",
+    "audio/webm": ".webm",
+    "audio/wav": ".wav",
+    "audio/ogg": ".ogg",
+};
+function extensionFor(contentType) {
+    const base = contentType.split(";")[0].trim().toLowerCase();
+    return AUDIO_EXTENSIONS[base] ?? ".audio";
+}
+function sanitise(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+/** Adapt a validated (zod-inferred) args object to the client's query shape.
+ *  The client skips undefined/null/empty values, so this is a plain view. */
+function params(obj) {
+    return obj;
+}
+const EXPORT_POLL_INTERVAL_MS = 2_000;
+const EXPORT_POLL_BUDGET_MS = 60_000;
+// Fallback wait when a 429 carries no Retry-After.
+const EXPORT_RETRY_FALLBACK_MS = 5_000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** POST the export, absorbing a 429 by sleeping for Retry-After (capped by the
+ *  remaining budget) and retrying rather than aborting the whole tool. Returns
+ *  false only when the budget runs out mid-backoff. A 400/403/etc bubbles up. */
+async function triggerExport(client, deckId, deadline) {
+    for (;;) {
+        try {
+            await client.exportDeck(deckId);
+            return true;
+        }
+        catch (err) {
+            if (!(err instanceof ApiError) || err.status !== 429)
+                throw err;
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return false;
+            const wait = err.retryAfter && err.retryAfter > 0
+                ? err.retryAfter * 1000
+                : EXPORT_RETRY_FALLBACK_MS;
+            await sleep(Math.min(wait, remaining));
+        }
+    }
+}
+/** Start a deck export, then poll its status for up to ~60s and return a compact
+ *  result the agent can act on. The endpoint does not re-enqueue while a job is
+ *  in flight, so a 429 while triggering is absorbed with a Retry-After backoff
+ *  (not an abort). A 400 (e.g. a deck with no linked submission) or 403 bubbles
+ *  up as an ApiError for errorResult. */
+async function exportAndPoll(client, deckId) {
+    const deadline = Date.now() + EXPORT_POLL_BUDGET_MS;
+    if (!(await triggerExport(client, deckId, deadline))) {
+        return jsonResult({
+            status: "pending",
+            message: "Rate limited before the export could start; call export_anki_deck " +
+                "again shortly.",
+        });
+    }
+    for (;;) {
+        const st = await client.exportDeckStatus(deckId);
+        if (st.status === "ready") {
+            return jsonResult({ status: "ready", download_url: st.download_url });
+        }
+        if (st.status === "failed") {
+            return jsonResult({
+                status: "failed",
+                message: "Export failed; call export_anki_deck again to retry.",
+            });
+        }
+        if (st.status === "none") {
+            return jsonResult({
+                status: "none",
+                message: "No export is available to download; call export_anki_deck again to " +
+                    "trigger a fresh one.",
+            });
+        }
+        if (Date.now() >= deadline) {
+            return jsonResult({
+                status: "pending",
+                message: "Still generating. Call export_anki_deck again shortly to check " +
+                    "status; it will not start a second job while one is in flight. Only " +
+                    "re-trigger if a later call reports 'failed' or 'none'.",
+            });
+        }
+        await sleep(EXPORT_POLL_INTERVAL_MS);
+    }
+}
+export function registerTools(server, client, config) {
+    server.registerTool("get_vocabulary", {
+        title: "Get vocabulary",
+        description: "List the user's vocabulary, aggregated per word with FSRS maturity " +
+            "(state/stability/due/reps). Grounded in the user's real listening " +
+            "history. Filter by language, status (known|learning|new|due), or CEFR; " +
+            "use 'since' (an ISO 8601 time from a prior 'updated_at') plus 'cursor' " +
+            "for incremental sync. Sync is additive-only, so full-resync periodically. " +
+            "The list is cursor-paginated (limit up to 200); follow next_cursor until " +
+            "it is null to read the complete set.",
+        inputSchema: {
+            language: z
+                .string()
+                .transform((v) => v.toLowerCase())
+                .optional()
+                .describe("Filter to one learning language, ISO 639-1, e.g. 'de' " +
+                "(normalised to lowercase)."),
+            status: z
+                .enum(["known", "learning", "new", "due"])
+                .optional()
+                .describe("Filter by learning status derived from FSRS state."),
+            cefr: z
+                .string()
+                .transform((v) => v.toUpperCase())
+                .refine((v) => ["A1", "A2", "B1", "B2", "C1", "C2"].includes(v), {
+                message: "cefr must be one of A1, A2, B1, B2, C1, C2",
+            })
+                .optional()
+                .describe("Filter by CEFR level; one of A1-C2 (normalised to uppercase)."),
+            since: z
+                .string()
+                .refine((v) => !Number.isNaN(Date.parse(v)), {
+                message: "since must be a date or datetime string, e.g. 2026-07-01 or " +
+                    "2026-07-01T10:00:00Z",
+            })
+                .optional()
+                .describe("Return only words changed at/after this date or datetime."),
+            limit: z.number().int().min(1).max(200).optional(),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Opaque cursor from a previous page's next_cursor."),
+        },
+    }, async (args) => runJson(() => client.getVocabulary(params(args))));
+    server.registerTool("lookup_word", {
+        title: "Look up a word",
+        description: "Look up one word: the user's own context (translation, gender, CEFR, " +
+            "FSRS state) if they have cards for it, backed by the shared enrichment " +
+            "lexicon as a gender/CEFR fallback. Use this to ground an LLM's guesses " +
+            "about a word rather than inventing them.",
+        inputSchema: {
+            lemma: z.string().min(1).describe("Dictionary (base) form to look up."),
+            language: z
+                .string()
+                .min(1)
+                .transform((v) => v.toLowerCase())
+                .describe("Language of the word, ISO 639-1 (normalised to lowercase)."),
+            pos: z.string().optional().describe("Part of speech, if known (e.g. NOUN)."),
+        },
+    }, async (args) => runJson(() => client.lookupWord(params(args))));
+    server.registerTool("list_library", {
+        title: "List library",
+        description: "List the user's ready-to-study episodes (their own submissions plus " +
+            "collections they follow), newest first. Cursor-paginated. Use the " +
+            "returned submission ids with get_transcript / get_audio_url / " +
+            "get_audio_clip.",
+        inputSchema: {
+            limit: z.number().int().min(1).max(200).optional(),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Opaque cursor from a previous page's next_cursor."),
+        },
+    }, async (args) => runJson(() => client.listLibrary(params(args))));
+    server.registerTool("get_transcript", {
+        title: "Get transcript",
+        description: "Fetch a submission's transcript: timestamped sentences with " +
+            "translations. Sliceable by sentence-position range (from_sentence/" +
+            "to_sentence) or time range in seconds (from_time/to_time) so you can " +
+            "pull an excerpt instead of a whole episode. transcript_state tells you " +
+            "if it is ready, still processing, or unavailable.",
+        inputSchema: {
+            submission_id: z.string().min(1).describe("The submission id."),
+            from_sentence: z.number().int().min(1).optional(),
+            to_sentence: z.number().int().min(1).optional(),
+            from_time: z.number().min(0).optional().describe("Start of window (s)."),
+            to_time: z.number().min(0).optional().describe("End of window (s)."),
+        },
+    }, async ({ submission_id, ...rest }) => runJson(() => client.getTranscript(submission_id, params(rest))));
+    server.registerTool("get_audio_url", {
+        title: "Get audio URL",
+        description: "Get a short-lived presigned URL to a submission's full native audio " +
+            "(supports HTTP Range). Use for streaming; for a durable snippet to " +
+            "embed in a lesson, use get_audio_clip instead.",
+        inputSchema: {
+            submission_id: z.string().min(1).describe("The submission id."),
+        },
+    }, async ({ submission_id }) => runJson(() => client.getAudioUrl(submission_id)));
+    server.registerTool("search_examples", {
+        title: "Search example sentences",
+        description: "Search the user's readable library for sentences. 'lemma' returns the " +
+            "curated example sentences for that word; 'q' does a case-insensitive " +
+            "substring match on sentence text. At least one is required, and 'lemma' " +
+            "takes precedence when both are given. Results are a capped sample, not " +
+            "exhaustive.",
+        inputSchema: {
+            lemma: z
+                .string()
+                .max(200)
+                .optional()
+                .describe("Find example sentences for this dictionary form."),
+            q: z
+                .string()
+                .max(200)
+                .optional()
+                .describe("Case-insensitive substring match on sentence text."),
+            language: z
+                .string()
+                .transform((v) => v.toLowerCase())
+                .optional()
+                .describe("Restrict to one language (normalised to lowercase)."),
+            limit: z.number().int().min(1).max(100).optional(),
+        },
+    }, async (args) => {
+        // The API also 400s on this, but validating here names both fields and
+        // saves a round trip.
+        if (!args.lemma && !args.q) {
+            return errorResult(new Error("search_examples needs at least one of 'lemma' or 'q'."));
+        }
+        return runJson(() => client.searchExamples(params(args)));
+    });
+    server.registerTool("get_audio_clip", {
+        title: "Get audio clip",
+        description: "Cut a native-audio snippet [start, end] (seconds, max 60s) from a " +
+            "submission and SAVE IT to a local file, returning the file path. Use " +
+            "these small clips to embed audio in a self-contained HTML lesson (e.g. " +
+            "as a data URI). Rate limited.",
+        inputSchema: {
+            submission_id: z.string().min(1).describe("The submission id."),
+            start: z.number().min(0).describe("Clip start in seconds."),
+            end: z.number().gt(0).describe("Clip end in seconds (start < end)."),
+        },
+    }, async ({ submission_id, start, end }) => runResult(async () => {
+        // The API enforces these too; checking here gives a precise message and
+        // avoids a wasted request.
+        if (!(start < end)) {
+            throw new Error("get_audio_clip needs start < end.");
+        }
+        if (end - start > 60) {
+            throw new Error("get_audio_clip cannot exceed 60 seconds (end - start).");
+        }
+        const clip = await client.getAudioClip(submission_id, start, end);
+        // 0o700: the clip dir holds the user's own study audio, so keep it
+        // readable only by them (mode applies to dirs this call creates).
+        await fs.mkdir(config.clipDir, { recursive: true, mode: 0o700 });
+        const filename = `clip-${sanitise(submission_id)}-${start}-${end}${extensionFor(clip.contentType)}`;
+        const filePath = path.join(config.clipDir, filename);
+        await fs.writeFile(filePath, clip.data);
+        return jsonResult({
+            path: filePath,
+            media_type: clip.contentType,
+            size_bytes: clip.data.byteLength,
+        });
+    }));
+    // --- Write tools (phase 3) ----------------------------------------------
+    server.registerTool("list_decks", {
+        title: "List decks",
+        description: "List the user's study decks so you can pick a deck_id before adding " +
+            "cards (add_card) or exporting (export_anki_deck). Each deck reports its " +
+            "language and card counts (total / new / due). Requires the cards:write " +
+            "or decks:export scope.",
+        inputSchema: {},
+    }, async () => runJson(() => client.listDecks()));
+    server.registerTool("add_card", {
+        title: "Add a card",
+        description: "Add a card to the user's LingoChunk review queue (FSRS; it starts as " +
+            "'new'). kind=vocab adds a word the user ALREADY has in their vocabulary, " +
+            "resolved by lemma against their own content (404 if the lemma is not in " +
+            "their vocabulary; 409 code=ambiguous_lemma if it occurs in several " +
+            "episodes or under several parts of speech, so pass submission_id or pos " +
+            "as the message names). kind=custom adds a freeform card and REQUIRES " +
+            "front, back and submission_id (the episode it anchors to); pass " +
+            "sentence_position to anchor its example to a specific transcript " +
+            "sentence. Omit deck_id and the card goes to the deck for its own " +
+            "submission (the same deck the app builds, reviews and exports that " +
+            "episode from, so it is immediately visible and exportable); an explicit " +
+            "deck_id must belong to that submission (400 otherwise). A 409 " +
+            "code=duplicate_card means the card already exists: expected, not worth " +
+            "retrying. NOTE: deleting the anchoring episode deletes the card " +
+            "(cascade), and a card added while the app's Words tab is open on that " +
+            "episode may be overwritten by the app's own save, so add cards when the " +
+            "app is not actively editing that deck. Requires the cards:write scope.",
+        inputSchema: {
+            deck_id: z
+                .number()
+                .int()
+                .optional()
+                .describe("Target deck id from list_decks; omit to use the deck for the card's " +
+                "own submission. When given, it must belong to that submission."),
+            kind: z
+                .enum(["vocab", "custom"])
+                .describe("vocab = a word from your vocabulary; custom = freeform front/back."),
+            lemma: z
+                .string()
+                .max(200)
+                .optional()
+                .describe("Dictionary form to add (kind=vocab)."),
+            pos: z
+                .string()
+                .max(20)
+                .optional()
+                .describe("Part of speech, to disambiguate the lemma (kind=vocab); case-insensitive."),
+            submission_id: z
+                .string()
+                .optional()
+                .describe("Disambiguate the lemma to one episode (kind=vocab); the episode the " +
+                "card anchors to (REQUIRED for kind=custom)."),
+            front: z
+                .string()
+                .max(200)
+                .optional()
+                .describe("Front/prompt text (kind=custom; max 200 chars)."),
+            back: z
+                .string()
+                .max(500)
+                .optional()
+                .describe("Back/answer text (kind=custom; max 500 chars)."),
+            note: z
+                .string()
+                .max(300)
+                .optional()
+                .describe("Optional note shown on the card (kind=custom; max 300 chars)."),
+            sentence_position: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe("1-based transcript position (see get_transcript) to anchor a custom " +
+                "card's example; defaults to the submission's first sentence."),
+        },
+    }, async (args) => {
+        // Mirror the server's cross-field rules so the message is precise and no
+        // request is wasted.
+        if (args.kind === "vocab" && !args.lemma) {
+            return errorResult(new Error("add_card kind=vocab requires 'lemma'."));
+        }
+        if (args.kind === "custom" &&
+            !(args.front && args.back && args.submission_id)) {
+            return errorResult(new Error("add_card kind=custom requires 'front', 'back' and 'submission_id'."));
+        }
+        return runJson(() => client.addCard(args));
+    });
+    server.registerTool("export_anki_deck", {
+        title: "Export an Anki deck",
+        description: "Export one of the user's decks to an Anki .apkg and return a download " +
+            "URL. Running it costs nothing (no LLM). This starts the export and polls " +
+            "status for up to ~60s, absorbing rate limits with a Retry-After backoff " +
+            "and never starting a second job while one is already in flight. It " +
+            "returns {status:'ready', download_url} when the file is ready, " +
+            "{status:'pending'} (call again shortly to keep checking) while it " +
+            "generates, {status:'failed'} to retry, or {status:'none'} (nothing to " +
+            "download; call again to trigger a fresh export). A deck with no linked " +
+            "source episode cannot be exported (400). Use list_decks to find a " +
+            "deck_id. Requires the decks:export scope.",
+        inputSchema: {
+            deck_id: z.number().int().describe("The deck to export (from list_decks)."),
+        },
+    }, async ({ deck_id }) => runResult(() => exportAndPoll(client, deck_id)));
+    server.registerTool("save_lesson", {
+        title: "Save a lesson",
+        description: "Save a single self-contained HTML lesson to the user's private " +
+            "LingoChunk library (10 MB max, up to 100 lessons, private by default). " +
+            "Returns the lesson metadata plus a short-lived view URL to open it now; " +
+            "its durable home is the app's library, where it opens on any device. Use " +
+            "this to keep a lesson the lingochunk-lesson skill produced. Requires the " +
+            "lessons:write scope.",
+        inputSchema: {
+            title: z.string().min(1).max(255).describe("Lesson title."),
+            language: z
+                .string()
+                .min(1)
+                .max(10)
+                .describe("Target language, ISO 639-1."),
+            html: z
+                .string()
+                .min(1)
+                .describe("The complete self-contained HTML document."),
+            source_submission_ids: z
+                .array(z.string())
+                .optional()
+                .describe("Optional provenance: the episode ids the lesson was built from."),
+        },
+    }, async (args) => runJson(() => client.createLesson(args)));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@lingochunk/mcp",
+  "version": "0.2.1",
+  "description": "Model Context Protocol server for the LingoChunk public API: your FSRS-graded vocabulary, native-audio transcripts and clips, and library, as tools for a coding agent.",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "lingochunk-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "smoke": "node --experimental-strip-types scripts/smoke.ts",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lxol/lingochunk-mcp.git"
+  },
+  "homepage": "https://github.com/lxol/lingochunk-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/lxol/lingochunk-mcp/issues"
+  }
+}