@unclick/mcp-server 0.1.1 → 0.2.1

package/dist/chessdotcom-tool.js

@@ -0,0 +1,183 @@
+// Chess.com Public API integration for the UnClick MCP server.
+// Uses the Chess.com Published-Data API via fetch - no external dependencies, no API key required.
+// Documentation: https://www.chess.com/news/view/published-data-api
+const CHESS_BASE = "https://api.chess.com/pub";
+// ─── API helper ──────────────────────────────────────────────────────────────
+async function chessFetch(path) {
+    const res = await fetch(`${CHESS_BASE}${path}`, {
+        headers: {
+            "User-Agent": "UnClick MCP Server",
+            Accept: "application/json",
+        },
+    });
+    if (!res.ok) {
+        if (res.status === 404) {
+            throw new Error(`Not found (HTTP 404). Check the username or resource exists.`);
+        }
+        throw new Error(`Chess.com API HTTP ${res.status}`);
+    }
+    return res.json();
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function chessPlayer(args) {
+    const username = String(args.username ?? "").trim().toLowerCase();
+    if (!username)
+        throw new Error("username is required.");
+    const data = (await chessFetch(`/player/${username}`));
+    return {
+        username: data.username,
+        name: data.name ?? null,
+        title: data.title ?? null,
+        country: data.country ?? null,
+        location: data.location ?? null,
+        joined: data.joined ? new Date(Number(data.joined) * 1000).toISOString() : null,
+        last_online: data.last_online
+            ? new Date(Number(data.last_online) * 1000).toISOString()
+            : null,
+        followers: data.followers ?? 0,
+        is_streamer: data.is_streamer ?? false,
+        verified: data.verified ?? false,
+        url: data.url ?? null,
+        avatar: data.avatar ?? null,
+    };
+}
+export async function chessPlayerStats(args) {
+    const username = String(args.username ?? "").trim().toLowerCase();
+    if (!username)
+        throw new Error("username is required.");
+    const data = (await chessFetch(`/player/${username}/stats`));
+    const extractRating = (gameType) => {
+        if (!gameType || typeof gameType !== "object")
+            return null;
+        const gt = gameType;
+        const last = gt.last ?? {};
+        const best = gt.best ?? {};
+        const record = gt.record ?? {};
+        return {
+            rating: last.rating ?? null,
+            best_rating: best.rating ?? null,
+            wins: record.win ?? 0,
+            losses: record.loss ?? 0,
+            draws: record.draw ?? 0,
+        };
+    };
+    return {
+        username,
+        chess_rapid: extractRating(data.chess_rapid),
+        chess_blitz: extractRating(data.chess_blitz),
+        chess_bullet: extractRating(data.chess_bullet),
+        chess_daily: extractRating(data.chess_daily),
+        tactics: data.tactics
+            ? {
+                highest: data.tactics.highest ?? null,
+                lowest: data.tactics.lowest ?? null,
+            }
+            : null,
+        puzzle_rush: data.puzzle_rush ?? null,
+    };
+}
+export async function chessPlayerGames(args) {
+    const username = String(args.username ?? "").trim().toLowerCase();
+    if (!username)
+        throw new Error("username is required.");
+    const year = String(args.year ?? "").trim();
+    const month = String(args.month ?? "").trim().padStart(2, "0");
+    if (!year)
+        throw new Error("year is required (e.g. 2024).");
+    if (!args.month)
+        throw new Error("month is required (e.g. 1 for January).");
+    const data = (await chessFetch(`/player/${username}/games/${year}/${month}`));
+    const games = data.games ?? [];
+    return {
+        username,
+        year,
+        month,
+        count: games.length,
+        games: games.slice(-20).map((g) => ({
+            url: g.url,
+            pgn_first_move: g.pgn
+                ? String(g.pgn).split("\n").filter((l) => !l.startsWith("[")).join(" ").trim().slice(0, 100)
+                : null,
+            time_class: g.time_class,
+            time_control: g.time_control,
+            rated: g.rated,
+            white: {
+                username: g.white?.username,
+                result: g.white?.result,
+                rating: g.white?.rating,
+            },
+            black: {
+                username: g.black?.username,
+                result: g.black?.result,
+                rating: g.black?.rating,
+            },
+            end_time: g.end_time
+                ? new Date(Number(g.end_time) * 1000).toISOString()
+                : null,
+        })),
+    };
+}
+export async function chessPuzzlesRandom(_args) {
+    const data = (await chessFetch("/puzzle/random"));
+    return {
+        title: data.title ?? null,
+        url: data.url ?? null,
+        publish_time: data.publish_time
+            ? new Date(Number(data.publish_time) * 1000).toISOString()
+            : null,
+        fen: data.fen ?? null,
+        pgn: data.pgn ?? null,
+        image: data.image ?? null,
+    };
+}
+export async function chessLeaderboards(args) {
+    const data = (await chessFetch("/leaderboards"));
+    const gameType = args.game_type ? String(args.game_type) : null;
+    const validTypes = [
+        "live_rapid",
+        "live_blitz",
+        "live_bullet",
+        "live_bughouse",
+        "live_blitz960",
+        "live_threecheck",
+        "live_crazyhouse",
+        "live_kingofthehill",
+        "tactics",
+        "lessons",
+        "puzzle_rush",
+        "daily",
+        "daily960",
+    ];
+    if (gameType) {
+        if (!validTypes.includes(gameType)) {
+            throw new Error(`game_type must be one of: ${validTypes.join(", ")}`);
+        }
+        const board = data[gameType] ?? [];
+        return {
+            game_type: gameType,
+            count: board.length,
+            players: board.slice(0, 20).map((p) => ({
+                rank: p.rank,
+                username: p.username,
+                score: p.score,
+                title: p.title ?? null,
+                country: p.country ?? null,
+            })),
+        };
+    }
+    const result = {};
+    for (const type of ["live_rapid", "live_blitz", "live_bullet", "daily"]) {
+        const board = data[type] ?? [];
+        result[type] = board.slice(0, 5).map((p) => ({
+            rank: p.rank,
+            username: p.username,
+            score: p.score,
+            title: p.title ?? null,
+        }));
+    }
+    return {
+        note: "Showing top 5 for rapid, blitz, bullet, and daily. Pass game_type for a full leaderboard.",
+        leaderboards: result,
+    };
+}
+//# sourceMappingURL=chessdotcom-tool.js.map

package/dist/chessdotcom-tool.js.map

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

package/dist/client.js

@@ -6,7 +6,7 @@ export class UnClickClient {
         this.baseUrl = config.baseUrl.replace(/\/$/, "");
     }
     async call(method, path, body) {
-        // Resolve path params - e.g. /v1/webhook/:id/requests with { id: "abc" }
+        // Resolve path params — e.g. /v1/webhook/:id/requests with { id: "abc" }
         // We handle this by substituting :param tokens from the body, then removing them from body
         let resolvedPath = path;
         const remainingBody = { ...body };

package/dist/clockify-tool.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"clockify-tool.d.ts","sourceRoot":"","sources":["../src/clockify-tool.ts"],"names":[],"mappings":"AA0IA,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/clockify-tool.js

@@ -0,0 +1,155 @@
+// ── Clockify API tool ──────────────────────────────────────────────────────────
+// Wraps the Clockify REST API (https://api.clockify.me/api/v1/) via fetch.
+// Auth: X-Api-Key header with CLOCKIFY_API_KEY.
+//
+// Credentials are auto-resolved via vault-bridge:
+//   1. Inline args   (api_key passed directly)
+//   2. Env var       UNCLICK_CLOCKIFY_API_KEY
+//   3. Local vault   key "clockify/api_key"
+//   4. Supabase      via UNCLICK_API_KEY + unclick.world/api/credentials
+//
+// No external dependencies.
+import { resolveCredentials } from "./vault-bridge.js";
+const CLOCKIFY_BASE = "https://api.clockify.me/api/v1";
+// ── Shared fetch helper ────────────────────────────────────────────────────────
+async function clockifyFetch(apiKey, method, path, query, body) {
+    const url = new URL(`${CLOCKIFY_BASE}${path}`);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== "")
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const headers = {
+        "X-Api-Key": apiKey,
+        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 Clockify API: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 401)
+        return { error: "Clockify API key is invalid. Check your CLOCKIFY_API_KEY.", status: 401 };
+    if (response.status === 404)
+        return { error: "Resource not found. Check the workspace or project ID.", status: 404 };
+    if (response.status === 429)
+        return { error: "Clockify 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: `Clockify API error ${response.status}: ${detail}`, status: response.status };
+    }
+    return data;
+}
+// ── Action implementations ─────────────────────────────────────────────────────
+async function getWorkspaces(key, _args) {
+    return clockifyFetch(key, "GET", "/workspaces");
+}
+async function getTimeEntries(key, args) {
+    const workspace_id = String(args.workspace_id ?? "").trim();
+    const user_id = String(args.user_id ?? "").trim();
+    if (!workspace_id)
+        return { error: "workspace_id is required." };
+    if (!user_id)
+        return { error: "user_id is required." };
+    return clockifyFetch(key, "GET", `/workspaces/${encodeURIComponent(workspace_id)}/user/${encodeURIComponent(user_id)}/time-entries`, {
+        start: args.start ? String(args.start) : undefined,
+        end: args.end ? String(args.end) : undefined,
+        project: args.project_id ? String(args.project_id) : undefined,
+        page: args.page ? Number(args.page) : 1,
+        "page-size": args.page_size ? Number(args.page_size) : 50,
+    });
+}
+async function createTimeEntry(key, args) {
+    const workspace_id = String(args.workspace_id ?? "").trim();
+    if (!workspace_id)
+        return { error: "workspace_id is required." };
+    const start = String(args.start ?? "").trim();
+    if (!start)
+        return { error: "start (ISO 8601 datetime) is required." };
+    const body = { start };
+    if (args.end)
+        body.end = String(args.end);
+    if (args.description)
+        body.description = String(args.description);
+    if (args.project_id)
+        body.projectId = String(args.project_id);
+    if (args.tag_ids)
+        body.tagIds = args.tag_ids;
+    if (args.billable !== undefined)
+        body.billable = Boolean(args.billable);
+    return clockifyFetch(key, "POST", `/workspaces/${encodeURIComponent(workspace_id)}/time-entries`, undefined, body);
+}
+async function getProjects(key, args) {
+    const workspace_id = String(args.workspace_id ?? "").trim();
+    if (!workspace_id)
+        return { error: "workspace_id is required." };
+    return clockifyFetch(key, "GET", `/workspaces/${encodeURIComponent(workspace_id)}/projects`, {
+        archived: args.archived !== undefined ? String(args.archived) : undefined,
+        "page-size": args.page_size ? Number(args.page_size) : 50,
+        page: args.page ? Number(args.page) : 1,
+        name: args.name ? String(args.name) : undefined,
+    });
+}
+async function getSummary(key, args) {
+    const workspace_id = String(args.workspace_id ?? "").trim();
+    if (!workspace_id)
+        return { error: "workspace_id is required." };
+    const date_range_start = String(args.date_range_start ?? "").trim();
+    const date_range_end = String(args.date_range_end ?? "").trim();
+    if (!date_range_start)
+        return { error: "date_range_start (ISO 8601) is required." };
+    if (!date_range_end)
+        return { error: "date_range_end (ISO 8601) is required." };
+    const body = {
+        dateRangeStart: date_range_start,
+        dateRangeEnd: date_range_end,
+        summaryFilter: {
+            groups: args.groups ?? ["PROJECT"],
+        },
+        exportType: "JSON",
+    };
+    return clockifyFetch(key, "POST", `/workspaces/${encodeURIComponent(workspace_id)}/reports/summary`, undefined, body);
+}
+// ── Public dispatcher ──────────────────────────────────────────────────────────
+export async function clockifyAction(action, args) {
+    const resolved = await resolveCredentials("clockify", args);
+    if ("error" in resolved)
+        return resolved;
+    const key = String(resolved.api_key ?? "").trim();
+    if (!key)
+        return { error: "Clockify api_key could not be resolved." };
+    try {
+        switch (action) {
+            case "get_clockify_workspaces": return getWorkspaces(key, args);
+            case "get_time_entries": return getTimeEntries(key, args);
+            case "create_time_entry": return createTimeEntry(key, args);
+            case "get_clockify_projects": return getProjects(key, args);
+            case "get_clockify_summary": return getSummary(key, args);
+            default:
+                return {
+                    error: `Unknown Clockify action: "${action}". Valid actions: get_clockify_workspaces, get_time_entries, create_time_entry, get_clockify_projects, get_clockify_summary.`,
+                };
+        }
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=clockify-tool.js.map

package/dist/clockify-tool.js.map

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

package/dist/cloudflare-worker.d.ts

@@ -0,0 +1,12 @@
+/**
+ * UnClick MCP Server — Cloudflare Workers entry point
+ *
+ * Wraps the UnClick MCP server in a Web-Standard HTTP transport so it can run
+ * as a stateless Cloudflare Worker.  Each request spins up a fresh server
+ * instance — no shared state between requests.
+ */
+declare const _default: {
+    fetch(request: Request): Promise<Response>;
+};
+export default _default;
+//# sourceMappingURL=cloudflare-worker.d.ts.map

package/dist/cloudflare-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-worker.d.ts","sourceRoot":"","sources":["../src/cloudflare-worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;mBAMoB,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADlD,wBA2CE"}

package/dist/cloudflare-worker.js

@@ -0,0 +1,50 @@
+/**
+ * UnClick MCP Server — Cloudflare Workers entry point
+ *
+ * Wraps the UnClick MCP server in a Web-Standard HTTP transport so it can run
+ * as a stateless Cloudflare Worker.  Each request spins up a fresh server
+ * instance — no shared state between requests.
+ */
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { createServer } from "./server.js";
+export default {
+    async fetch(request) {
+        // CORS preflight
+        if (request.method === "OPTIONS") {
+            return new Response(null, {
+                status: 204,
+                headers: {
+                    "Access-Control-Allow-Origin": "*",
+                    "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+                    "Access-Control-Allow-Headers": "Content-Type, Authorization, mcp-session-id",
+                },
+            });
+        }
+        const transport = new WebStandardStreamableHTTPServerTransport({
+            sessionIdGenerator: undefined, // stateless — one transport per request
+        });
+        const server = createServer();
+        try {
+            await server.connect(transport);
+            const response = await transport.handleRequest(request);
+            // Attach CORS headers to every response
+            const headers = new Headers(response.headers);
+            headers.set("Access-Control-Allow-Origin", "*");
+            headers.set("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+            headers.set("Access-Control-Allow-Headers", "Content-Type, Authorization, mcp-session-id");
+            return new Response(response.body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers,
+            });
+        }
+        catch (err) {
+            console.error("[unclick-worker] Unhandled error:", err);
+            return new Response(JSON.stringify({ error: "Internal server error" }), {
+                status: 500,
+                headers: { "Content-Type": "application/json" },
+            });
+        }
+    },
+};
+//# sourceMappingURL=cloudflare-worker.js.map

package/dist/cloudflare-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-worker.js","sourceRoot":"","sources":["../src/cloudflare-worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AACzH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAe;IACb,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC1B,iBAAiB;QACjB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;gBACxB,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE;oBACP,6BAA6B,EAAE,GAAG;oBAClC,8BAA8B,EAAE,4BAA4B;oBAC5D,8BAA8B,EAAE,6CAA6C;iBAC9E;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,wCAAwC,CAAC;YAC7D,kBAAkB,EAAE,SAAS,EAAE,wCAAwC;SACxE,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAExD,wCAAwC;YACxC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,4BAA4B,CAAC,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,6CAA6C,CAAC,CAAC;YAE3F,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;YACxD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,EAAE;gBACtE,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/coingecko-tool.d.ts

@@ -0,0 +1,7 @@
+export declare function cryptoPrice(args: Record<string, unknown>): Promise<unknown>;
+export declare function cryptoCoin(args: Record<string, unknown>): Promise<unknown>;
+export declare function cryptoSearch(args: Record<string, unknown>): Promise<unknown>;
+export declare function cryptoTrending(_args: Record<string, unknown>): Promise<unknown>;
+export declare function cryptoTopCoins(args: Record<string, unknown>): Promise<unknown>;
+export declare function cryptoCoinHistory(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=coingecko-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-tool.d.ts","sourceRoot":"","sources":["../src/coingecko-tool.ts"],"names":[],"mappings":"AA2BA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAejF;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA2ChF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBlF;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCpF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BvF"}

package/dist/coingecko-tool.js

@@ -0,0 +1,176 @@
+// CoinGecko crypto market data integration for the UnClick MCP server.
+// Free tier requires no API key. Set COINGECKO_API_KEY for higher rate limits.
+// Uses the CoinGecko public REST API via fetch - no external dependencies.
+const COINGECKO_BASE = "https://api.coingecko.com/api/v3";
+// --- API helper ---
+async function cgFetch(path, params = {}) {
+    const url = new URL(`${COINGECKO_BASE}${path}`);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    const headers = { "Accept": "application/json" };
+    const apiKey = (process.env.COINGECKO_API_KEY ?? "").trim();
+    if (apiKey)
+        headers["x-cg-demo-api-key"] = apiKey;
+    const response = await fetch(url.toString(), { headers });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`HTTP ${response.status} from CoinGecko API${text ? `: ${text}` : ""}`);
+    }
+    return response.json();
+}
+// --- Operations ---
+export async function cryptoPrice(args) {
+    const ids = String(args.ids ?? "").trim();
+    const vs_currencies = String(args.vs_currencies ?? "usd").trim();
+    if (!ids)
+        throw new Error("ids is required (comma-separated coin IDs, e.g. bitcoin,ethereum).");
+    const data = await cgFetch("/simple/price", {
+        ids,
+        vs_currencies,
+        include_market_cap: "true",
+        include_24hr_vol: "true",
+        include_24hr_change: "true",
+        include_last_updated_at: "true",
+    });
+    return { ids, vs_currencies, prices: data };
+}
+export async function cryptoCoin(args) {
+    const id = String(args.id ?? "").trim().toLowerCase();
+    if (!id)
+        throw new Error("id is required (e.g. bitcoin, ethereum).");
+    const data = await cgFetch(`/coins/${encodeURIComponent(id)}`, {
+        localization: "false",
+        tickers: "false",
+        community_data: "false",
+        developer_data: "false",
+        sparkline: "false",
+    });
+    const market = data.market_data;
+    return {
+        id: data.id,
+        symbol: data.symbol,
+        name: data.name,
+        description: data.description?.en?.slice(0, 500) ?? null,
+        homepage: data.links?.homepage ?? null,
+        image: data.image?.large ?? null,
+        categories: data.categories,
+        genesis_date: data.genesis_date,
+        market_cap_rank: data.market_cap_rank,
+        coingecko_score: data.coingecko_score,
+        market_data: market
+            ? {
+                current_price: market.current_price ?? null,
+                market_cap: market.market_cap ?? null,
+                total_volume: market.total_volume ?? null,
+                price_change_24h: market.price_change_24h ?? null,
+                price_change_percentage_24h: market.price_change_percentage_24h ?? null,
+                price_change_percentage_7d: market.price_change_percentage_7d ?? null,
+                price_change_percentage_30d: market.price_change_percentage_30d ?? null,
+                ath: market.ath ?? null,
+                atl: market.atl ?? null,
+                circulating_supply: market.circulating_supply ?? null,
+                total_supply: market.total_supply ?? null,
+                max_supply: market.max_supply ?? null,
+            }
+            : null,
+        last_updated: data.last_updated,
+    };
+}
+export async function cryptoSearch(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        throw new Error("query is required.");
+    const data = await cgFetch("/search", { query });
+    return {
+        query,
+        coins: (data.coins ?? []).slice(0, 20).map((c) => ({
+            id: c.id,
+            name: c.name,
+            symbol: c.symbol,
+            market_cap_rank: c.market_cap_rank,
+            thumb: c.thumb,
+        })),
+        exchanges: (data.exchanges ?? []).slice(0, 5).map((e) => ({
+            id: e.id,
+            name: e.name,
+            thumb: e.thumb,
+        })),
+    };
+}
+export async function cryptoTrending(_args) {
+    const data = await cgFetch("/search/trending");
+    const coins = data.coins ?? [];
+    return {
+        trending_coins: coins.map(({ item }) => ({
+            id: item.id,
+            name: item.name,
+            symbol: item.symbol,
+            market_cap_rank: item.market_cap_rank,
+            score: item.score,
+            price_btc: item.price_btc,
+            data: item.data ?? null,
+        })),
+    };
+}
+export async function cryptoTopCoins(args) {
+    const vs_currency = String(args.vs_currency ?? "usd").trim().toLowerCase();
+    const order = String(args.order ?? "market_cap_desc");
+    const per_page = String(Math.min(250, Math.max(1, Number(args.per_page ?? 50))));
+    const page = String(Math.max(1, Number(args.page ?? 1)));
+    const data = await cgFetch("/coins/markets", {
+        vs_currency,
+        order,
+        per_page,
+        page,
+        sparkline: "false",
+    });
+    return {
+        vs_currency,
+        order,
+        page: Number(page),
+        per_page: Number(per_page),
+        coins: data.map((c) => ({
+            id: c.id,
+            symbol: c.symbol,
+            name: c.name,
+            image: c.image,
+            current_price: c.current_price,
+            market_cap: c.market_cap,
+            market_cap_rank: c.market_cap_rank,
+            total_volume: c.total_volume,
+            price_change_24h: c.price_change_24h,
+            price_change_percentage_24h: c.price_change_percentage_24h,
+            circulating_supply: c.circulating_supply,
+            ath: c.ath,
+            atl: c.atl,
+            last_updated: c.last_updated,
+        })),
+    };
+}
+export async function cryptoCoinHistory(args) {
+    const id = String(args.id ?? "").trim().toLowerCase();
+    const date = String(args.date ?? "").trim();
+    if (!id)
+        throw new Error("id is required (e.g. bitcoin).");
+    if (!date)
+        throw new Error("date is required in DD-MM-YYYY format.");
+    const data = await cgFetch(`/coins/${encodeURIComponent(id)}/history`, {
+        date,
+        localization: "false",
+    });
+    const market = data.market_data;
+    return {
+        id: data.id,
+        symbol: data.symbol,
+        name: data.name,
+        date,
+        market_data: market
+            ? {
+                current_price: market.current_price,
+                market_cap: market.market_cap,
+                total_volume: market.total_volume,
+            }
+            : null,
+    };
+}
+//# sourceMappingURL=coingecko-tool.js.map