@unclick/mcp-server 0.1.1 → 0.2.0

package/dist/lichess-tool.js

@@ -0,0 +1,211 @@
+// Lichess API integration for the UnClick MCP server.
+// Uses the Lichess public API via fetch - no external dependencies, no API key required.
+// Documentation: https://lichess.org/api
+const LICHESS_BASE = "https://lichess.org/api";
+// ─── API helper ──────────────────────────────────────────────────────────────
+async function lichessFetch(path, params = {}) {
+    const url = new URL(`${LICHESS_BASE}${path}`);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": "UnClick MCP Server",
+        },
+    });
+    if (!res.ok) {
+        if (res.status === 404) {
+            throw new Error("Not found (HTTP 404). Check the username or resource exists.");
+        }
+        const text = await res.text().catch(() => "");
+        throw new Error(`Lichess API HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+    return res.json();
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function lichessUser(args) {
+    const username = String(args.username ?? "").trim().toLowerCase();
+    if (!username)
+        throw new Error("username is required.");
+    const data = (await lichessFetch(`/user/${username}`));
+    const perfs = data.perfs ?? {};
+    const ratings = {};
+    for (const [key, val] of Object.entries(perfs)) {
+        ratings[key] = val.rating ?? null;
+    }
+    return {
+        id: data.id,
+        username: data.username,
+        title: data.title ?? null,
+        patron: data.patron ?? false,
+        created_at: data.createdAt
+            ? new Date(Number(data.createdAt)).toISOString()
+            : null,
+        seen_at: data.seenAt
+            ? new Date(Number(data.seenAt)).toISOString()
+            : null,
+        play_time_hours: data.playTime
+            ? Math.round(Number(data.playTime.total) / 3600)
+            : null,
+        game_count: data.count
+            ? data.count.all
+            : null,
+        ratings,
+        online: data.online ?? false,
+    };
+}
+export async function lichessUserGames(args) {
+    const username = String(args.username ?? "").trim().toLowerCase();
+    if (!username)
+        throw new Error("username is required.");
+    const max = Math.min(50, Math.max(1, Number(args.max ?? 10)));
+    // Lichess returns NDJSON by default; request JSON
+    const url = new URL(`${LICHESS_BASE}/games/user/${username}`);
+    url.searchParams.set("max", String(max));
+    url.searchParams.set("pgnInJson", "false");
+    url.searchParams.set("clocks", "false");
+    url.searchParams.set("evals", "false");
+    url.searchParams.set("opening", "true");
+    const res = await fetch(url.toString(), {
+        headers: {
+            Accept: "application/x-ndjson",
+            "User-Agent": "UnClick MCP Server",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Lichess API HTTP ${res.status}`);
+    }
+    const text = await res.text();
+    const games = text
+        .split("\n")
+        .filter((line) => line.trim())
+        .map((line) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((g) => g !== null);
+    return {
+        username,
+        count: games.length,
+        games: games.map((g) => {
+            const players = g.players ?? {};
+            const white = players.white ?? {};
+            const black = players.black ?? {};
+            return {
+                id: g.id,
+                rated: g.rated,
+                speed: g.speed,
+                status: g.status,
+                winner: g.winner ?? null,
+                created_at: g.createdAt
+                    ? new Date(Number(g.createdAt)).toISOString()
+                    : null,
+                white: {
+                    user: white.user?.name ?? null,
+                    rating: white.rating ?? null,
+                    result: g.winner === "white" ? "win" : g.winner === "black" ? "loss" : "draw",
+                },
+                black: {
+                    user: black.user?.name ?? null,
+                    rating: black.rating ?? null,
+                    result: g.winner === "black" ? "win" : g.winner === "white" ? "loss" : "draw",
+                },
+                opening: g.opening
+                    ? g.opening.name
+                    : null,
+            };
+        }),
+    };
+}
+export async function lichessPuzzleDaily(_args) {
+    const data = (await lichessFetch("/puzzle/daily"));
+    const puzzle = data.puzzle ?? {};
+    const game = data.game ?? {};
+    return {
+        id: puzzle.id,
+        rating: puzzle.rating ?? null,
+        plays: puzzle.plays ?? null,
+        themes: puzzle.themes ?? [],
+        solution: puzzle.solution ?? [],
+        fen: game.pgn?.split(" ").pop() ?? null,
+        pgn: game.pgn ?? null,
+        url: puzzle.id ? `https://lichess.org/training/${puzzle.id}` : null,
+    };
+}
+export async function lichessTopPlayers(args) {
+    const perfType = String(args.perfType ?? "bullet");
+    const validTypes = [
+        "ultraBullet",
+        "bullet",
+        "blitz",
+        "rapid",
+        "classical",
+        "chess960",
+        "crazyhouse",
+        "antichess",
+        "atomic",
+        "horde",
+        "kingOfTheHill",
+        "racingKings",
+        "threeCheck",
+    ];
+    if (!validTypes.includes(perfType)) {
+        throw new Error(`perfType must be one of: ${validTypes.join(", ")}`);
+    }
+    const data = (await lichessFetch(`/player/top/10/${perfType}`));
+    const users = data.users ?? [];
+    return {
+        perf_type: perfType,
+        count: users.length,
+        players: users.map((u) => {
+            const perfs = u.perfs ?? {};
+            const perf = perfs[perfType] ?? {};
+            return {
+                id: u.id,
+                username: u.username,
+                title: u.title ?? null,
+                patron: u.patron ?? false,
+                rating: perf.rating ?? null,
+                progress: perf.progress ?? null,
+            };
+        }),
+    };
+}
+export async function lichessTournament(args) {
+    const id = String(args.id ?? "").trim();
+    if (!id)
+        throw new Error("id is required (Lichess tournament ID).");
+    const data = (await lichessFetch(`/tournament/${id}`));
+    const podium = data.podium ?? [];
+    return {
+        id: data.id,
+        full_name: data.fullName ?? data.id,
+        status: data.status ?? null,
+        starts_at: data.startsAt
+            ? new Date(Number(data.startsAt)).toISOString()
+            : null,
+        finished_at: data.finishesAt
+            ? new Date(Number(data.finishesAt)).toISOString()
+            : null,
+        nb_players: data.nbPlayers ?? null,
+        winner: podium[0]
+            ? {
+                username: podium[0].player?.name ?? null,
+                score: podium[0].score ?? null,
+            }
+            : null,
+        podium: podium.slice(0, 3).map((p) => ({
+            username: p.player?.name ?? null,
+            score: p.score ?? null,
+            nb: p.nb ?? null,
+        })),
+        url: `https://lichess.org/tournament/${id}`,
+    };
+}
+//# sourceMappingURL=lichess-tool.js.map

package/dist/lichess-tool.js.map

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

package/dist/meal-tool.d.ts

@@ -0,0 +1,8 @@
+export declare function searchMeals(args: Record<string, unknown>): Promise<unknown>;
+export declare function getRandomMeal(_args: Record<string, unknown>): Promise<unknown>;
+export declare function getMealById(args: Record<string, unknown>): Promise<unknown>;
+export declare function listMealCategories(_args: Record<string, unknown>): Promise<unknown>;
+export declare function filterMealsByCategory(args: Record<string, unknown>): Promise<unknown>;
+export declare function filterMealsByArea(args: Record<string, unknown>): Promise<unknown>;
+export declare function filterMealsByIngredient(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=meal-tool.d.ts.map

package/dist/meal-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meal-tool.d.ts","sourceRoot":"","sources":["../src/meal-tool.ts"],"names":[],"mappings":"AAwEA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAejF;AAID,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpF;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjF;AAID,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAYzF;AAID,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB3F;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBvF;AAID,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB7F"}

package/dist/meal-tool.js

@@ -0,0 +1,143 @@
+// TheMealDB recipe finder.
+// No API key required -- free public API.
+// Base URL: https://www.themealdb.com/api/json/v1/1/
+const MEALDB_BASE = "https://www.themealdb.com/api/json/v1/1";
+async function mealFetch(path) {
+    const res = await fetch(`${MEALDB_BASE}${path}`, {
+        headers: { "User-Agent": "UnClickMCP/1.0 (https://unclick.io)" },
+    });
+    if (!res.ok)
+        throw new Error(`TheMealDB HTTP ${res.status}`);
+    return res.json();
+}
+function extractIngredients(meal) {
+    const list = [];
+    for (let i = 1; i <= 20; i++) {
+        const ingredient = String(meal[`strIngredient${i}`] ?? "").trim();
+        const measure = String(meal[`strMeasure${i}`] ?? "").trim();
+        if (ingredient)
+            list.push({ ingredient, measure });
+    }
+    return list;
+}
+function normalizeMeal(meal) {
+    return {
+        id: meal.idMeal,
+        name: meal.strMeal,
+        category: meal.strCategory ?? null,
+        area: meal.strArea ?? null,
+        instructions: meal.strInstructions ?? null,
+        thumbnail: meal.strMealThumb ?? null,
+        tags: meal.strTags ? meal.strTags.split(",").map((t) => t.trim()).filter(Boolean) : [],
+        youtube: meal.strYoutube ?? null,
+        ingredients: extractIngredients(meal),
+    };
+}
+// ─── search_meals ─────────────────────────────────────────────────────────────
+export async function searchMeals(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        return { error: "query is required." };
+    const data = await mealFetch(`/search.php?s=${encodeURIComponent(query)}`);
+    if (!data.meals) {
+        return { query, count: 0, meals: [], message: `No meals found matching "${query}".` };
+    }
+    return {
+        query,
+        count: data.meals.length,
+        meals: data.meals.map(normalizeMeal),
+    };
+}
+// ─── get_random_meal ──────────────────────────────────────────────────────────
+export async function getRandomMeal(_args) {
+    const data = await mealFetch("/random.php");
+    if (!data.meals?.[0])
+        return { error: "No meal returned." };
+    return {
+        meal: normalizeMeal(data.meals[0]),
+    };
+}
+// ─── get_meal_by_id ───────────────────────────────────────────────────────────
+export async function getMealById(args) {
+    const id = String(args.id ?? "").trim();
+    if (!id)
+        return { error: "id is required (TheMealDB meal ID)." };
+    const data = await mealFetch(`/lookup.php?i=${encodeURIComponent(id)}`);
+    if (!data.meals?.[0])
+        return { error: `No meal found with id "${id}".` };
+    return { meal: normalizeMeal(data.meals[0]) };
+}
+// ─── list_meal_categories ─────────────────────────────────────────────────────
+export async function listMealCategories(_args) {
+    const data = await mealFetch("/categories.php");
+    return {
+        count: data.categories.length,
+        categories: data.categories.map((c) => ({
+            id: c.idCategory,
+            name: c.strCategory,
+            description: c.strCategoryDescription,
+            thumbnail: c.strCategoryThumb,
+        })),
+    };
+}
+// ─── filter_meals_by_category ─────────────────────────────────────────────────
+export async function filterMealsByCategory(args) {
+    const category = String(args.category ?? "").trim();
+    if (!category)
+        return { error: "category is required (e.g. Seafood, Dessert, Chicken)." };
+    const data = await mealFetch(`/filter.php?c=${encodeURIComponent(category)}`);
+    if (!data.meals) {
+        return { category, count: 0, meals: [], message: `No meals found for category "${category}".` };
+    }
+    return {
+        category,
+        count: data.meals.length,
+        meals: data.meals.map((m) => ({
+            id: m.idMeal,
+            name: m.strMeal,
+            thumbnail: m.strMealThumb ?? null,
+        })),
+        tip: "Use get_meal_by_id with any id above to get full recipe details.",
+    };
+}
+// ─── filter_meals_by_area ─────────────────────────────────────────────────────
+export async function filterMealsByArea(args) {
+    const area = String(args.area ?? "").trim();
+    if (!area)
+        return { error: "area is required (e.g. Australian, British, Chinese, Italian, Mexican)." };
+    const data = await mealFetch(`/filter.php?a=${encodeURIComponent(area)}`);
+    if (!data.meals) {
+        return { area, count: 0, meals: [], message: `No meals found for area "${area}".` };
+    }
+    return {
+        area,
+        count: data.meals.length,
+        meals: data.meals.map((m) => ({
+            id: m.idMeal,
+            name: m.strMeal,
+            thumbnail: m.strMealThumb ?? null,
+        })),
+        tip: "Use get_meal_by_id with any id above to get full recipe details.",
+    };
+}
+// ─── filter_meals_by_ingredient ───────────────────────────────────────────────
+export async function filterMealsByIngredient(args) {
+    const ingredient = String(args.ingredient ?? "").trim();
+    if (!ingredient)
+        return { error: "ingredient is required (e.g. chicken, garlic, tomato)." };
+    const data = await mealFetch(`/filter.php?i=${encodeURIComponent(ingredient)}`);
+    if (!data.meals) {
+        return { ingredient, count: 0, meals: [], message: `No meals found with ingredient "${ingredient}".` };
+    }
+    return {
+        ingredient,
+        count: data.meals.length,
+        meals: data.meals.map((m) => ({
+            id: m.idMeal,
+            name: m.strMeal,
+            thumbnail: m.strMealThumb ?? null,
+        })),
+        tip: "Use get_meal_by_id with any id above to get full recipe details.",
+    };
+}
+//# sourceMappingURL=meal-tool.js.map

package/dist/meal-tool.js.map

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

package/dist/monica-tool.d.ts

@@ -0,0 +1,2 @@
+export declare function monicaAction(action: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=monica-tool.d.ts.map

package/dist/monica-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monica-tool.d.ts","sourceRoot":"","sources":["../src/monica-tool.ts"],"names":[],"mappings":"AAyIA,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAwBlB"}

package/dist/monica-tool.js

@@ -0,0 +1,160 @@
+// ── Monica CRM API tool ────────────────────────────────────────────────────────
+// Wraps the Monica personal CRM REST API via fetch.
+// Default base: https://app.monicahq.com/api (override via MONICA_BASE_URL env var).
+// Auth: Bearer token (MONICA_API_KEY).
+//
+// Credentials are auto-resolved via vault-bridge:
+//   1. Inline args   (api_key passed directly)
+//   2. Env var       UNCLICK_MONICA_API_KEY
+//   3. Local vault   key "monica/api_key"
+//   4. Supabase      via UNCLICK_API_KEY + unclick.world/api/credentials
+//
+// No external dependencies.
+import { resolveCredentials } from "./vault-bridge.js";
+function monicaBase() {
+    return (process.env.MONICA_BASE_URL ?? "https://app.monicahq.com/api").replace(/\/$/, "");
+}
+// ── Shared fetch helper ────────────────────────────────────────────────────────
+async function monicaFetch(token, method, path, query, body) {
+    const url = new URL(`${monicaBase()}${path}`);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== "")
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const headers = {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/json",
+    };
+    if (body !== undefined)
+        headers["Content-Type"] = "application/json";
+    let response;
+    try {
+        response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+    }
+    catch (err) {
+        return { error: `Network error reaching Monica API: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 401)
+        return { error: "Monica API key is invalid. Check your MONICA_API_KEY.", status: 401 };
+    if (response.status === 404)
+        return { error: "Resource not found. Check the contact or note ID.", status: 404 };
+    if (response.status === 429)
+        return { error: "Monica rate limit exceeded. Please wait and retry.", status: 429 };
+    const text = await response.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        data = { raw: text };
+    }
+    if (!response.ok) {
+        const detail = data?.message ?? text;
+        return { error: `Monica API error ${response.status}: ${detail}`, status: response.status };
+    }
+    return data;
+}
+// ── Action implementations ─────────────────────────────────────────────────────
+async function getContacts(token, args) {
+    return monicaFetch(token, "GET", "/contacts", {
+        page: args.page ? Number(args.page) : 1,
+        limit: args.limit ? Number(args.limit) : 30,
+    });
+}
+async function searchContacts(token, args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        return { error: "query is required." };
+    return monicaFetch(token, "GET", "/contacts", { query, page: 1 });
+}
+async function getContact(token, args) {
+    const id = String(args.contact_id ?? "").trim();
+    if (!id)
+        return { error: "contact_id is required." };
+    return monicaFetch(token, "GET", `/contacts/${encodeURIComponent(id)}`);
+}
+async function createContact(token, args) {
+    const first_name = String(args.first_name ?? "").trim();
+    if (!first_name)
+        return { error: "first_name is required." };
+    const body = { first_name };
+    if (args.last_name)
+        body.last_name = String(args.last_name);
+    if (args.nickname)
+        body.nickname = String(args.nickname);
+    if (args.gender_id)
+        body.gender_id = Number(args.gender_id);
+    if (args.birthdate_day)
+        body.birthdate_day = Number(args.birthdate_day);
+    if (args.birthdate_month)
+        body.birthdate_month = Number(args.birthdate_month);
+    if (args.birthdate_year)
+        body.birthdate_year = Number(args.birthdate_year);
+    if (args.is_partial !== undefined)
+        body.is_partial = Boolean(args.is_partial);
+    return monicaFetch(token, "POST", "/contacts", undefined, body);
+}
+async function getReminders(token, args) {
+    const id = String(args.contact_id ?? "").trim();
+    if (!id)
+        return { error: "contact_id is required." };
+    return monicaFetch(token, "GET", `/contacts/${encodeURIComponent(id)}/reminders`);
+}
+async function getActivities(token, args) {
+    const id = String(args.contact_id ?? "").trim();
+    if (!id)
+        return { error: "contact_id is required." };
+    return monicaFetch(token, "GET", `/contacts/${encodeURIComponent(id)}/activities`, {
+        page: args.page ? Number(args.page) : 1,
+        limit: args.limit ? Number(args.limit) : 20,
+    });
+}
+async function addNote(token, args) {
+    const contact_id = String(args.contact_id ?? "").trim();
+    const body_text = String(args.body ?? "").trim();
+    if (!contact_id)
+        return { error: "contact_id is required." };
+    if (!body_text)
+        return { error: "body is required." };
+    const payload = {
+        contact_id: Number(contact_id),
+        body: body_text,
+    };
+    if (args.is_favorited !== undefined)
+        payload.is_favorited = Boolean(args.is_favorited);
+    return monicaFetch(token, "POST", "/notes", undefined, payload);
+}
+// ── Public dispatcher ──────────────────────────────────────────────────────────
+export async function monicaAction(action, args) {
+    const resolved = await resolveCredentials("monica", args);
+    if ("error" in resolved)
+        return resolved;
+    const token = String(resolved.api_key ?? "").trim();
+    if (!token)
+        return { error: "Monica api_key could not be resolved." };
+    try {
+        switch (action) {
+            case "get_contacts": return getContacts(token, args);
+            case "search_contacts": return searchContacts(token, args);
+            case "get_contact": return getContact(token, args);
+            case "create_contact": return createContact(token, args);
+            case "get_contact_reminders": return getReminders(token, args);
+            case "get_activities": return getActivities(token, args);
+            case "add_note": return addNote(token, args);
+            default:
+                return {
+                    error: `Unknown Monica action: "${action}". Valid actions: get_contacts, search_contacts, get_contact, create_contact, get_contact_reminders, get_activities, add_note.`,
+                };
+        }
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=monica-tool.js.map

package/dist/monica-tool.js.map

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

package/dist/musicbrainz-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function mbSearchArtists(args: Record<string, unknown>): Promise<unknown>;
+export declare function mbSearchReleases(args: Record<string, unknown>): Promise<unknown>;
+export declare function mbSearchRecordings(args: Record<string, unknown>): Promise<unknown>;
+export declare function mbGetArtist(args: Record<string, unknown>): Promise<unknown>;
+export declare function mbGetRelease(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=musicbrainz-tool.d.ts.map

package/dist/musicbrainz-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"musicbrainz-tool.d.ts","sourceRoot":"","sources":["../src/musicbrainz-tool.ts"],"names":[],"mappings":"AAmCA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAKrF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWtF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWxF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAIlF"}

package/dist/musicbrainz-tool.js

@@ -0,0 +1,65 @@
+// MusicBrainz API integration for the UnClick MCP server.
+// Uses the MusicBrainz REST API via fetch - no external dependencies.
+// No auth required. Identifies with a User-Agent header as required by MusicBrainz policy.
+const MB_BASE = "https://musicbrainz.org/ws/2";
+const MB_USER_AGENT = "UnClick/1.0 (creativelead@malamutemayhem.com)";
+// ─── API helper ───────────────────────────────────────────────────────────────
+async function mbCall(path, params = {}) {
+    const url = new URL(`${MB_BASE}${path}`);
+    url.searchParams.set("fmt", "json");
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "" && k !== "fmt") {
+            url.searchParams.set(k, String(v));
+        }
+    }
+    const response = await fetch(url.toString(), {
+        headers: { "User-Agent": MB_USER_AGENT },
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from MusicBrainz API`);
+    }
+    return response.json();
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export async function mbSearchArtists(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        throw new Error("query is required.");
+    const limit = args.limit !== undefined ? Number(args.limit) : undefined;
+    return mbCall("/artist", { query, limit });
+}
+export async function mbSearchReleases(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        throw new Error("query is required.");
+    const limit = args.limit !== undefined ? Number(args.limit) : undefined;
+    let fullQuery = query;
+    if (args.artist) {
+        fullQuery = `${query} artist:${args.artist}`;
+    }
+    return mbCall("/release", { query: fullQuery, limit });
+}
+export async function mbSearchRecordings(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        throw new Error("query is required.");
+    const limit = args.limit !== undefined ? Number(args.limit) : undefined;
+    let fullQuery = query;
+    if (args.artist) {
+        fullQuery = `${query} artist:${args.artist}`;
+    }
+    return mbCall("/recording", { query: fullQuery, limit });
+}
+export async function mbGetArtist(args) {
+    const mbid = String(args.mbid ?? "").trim();
+    if (!mbid)
+        throw new Error("mbid is required.");
+    return mbCall(`/artist/${mbid}`, { inc: "releases" });
+}
+export async function mbGetRelease(args) {
+    const mbid = String(args.mbid ?? "").trim();
+    if (!mbid)
+        throw new Error("mbid is required.");
+    return mbCall(`/release/${mbid}`, { inc: "recordings" });
+}
+//# sourceMappingURL=musicbrainz-tool.js.map