@unclick/mcp-server 0.1.0 → 0.2.0

package/dist/nvd-tool.js

@@ -0,0 +1,150 @@
+// NIST National Vulnerability Database (NVD) integration.
+// CVE data, CVSS scores, and vulnerability details. Free API.
+// NVD_API_KEY is optional but recommended for higher rate limits (50 req/30s vs 5 req/30s).
+// Docs: https://nvd.nist.gov/developers/vulnerabilities
+// Base URL: https://services.nvd.nist.gov/rest/json/cves/2.0
+const NVD_BASE = "https://services.nvd.nist.gov/rest/json/cves/2.0";
+async function nvdGet(params, apiKey) {
+    const qs = new URLSearchParams(params);
+    const headers = {
+        "User-Agent": "UnClickMCP/1.0 (https://unclick.io)",
+    };
+    if (apiKey)
+        headers["apiKey"] = apiKey;
+    const res = await fetch(`${NVD_BASE}?${qs}`, { headers });
+    if (res.status === 403)
+        throw new Error("Invalid NVD API key.");
+    if (res.status === 404)
+        throw new Error("CVE not found.");
+    if (res.status === 429)
+        throw new Error("NVD API rate limit exceeded. Consider providing an NVD_API_KEY for higher limits.");
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`NVD API HTTP ${res.status}${body ? `: ${body.slice(0, 200)}` : ""}`);
+    }
+    return res.json();
+}
+function getOptionalKey(args) {
+    const key = String(args.api_key ?? process.env.NVD_API_KEY ?? "").trim();
+    return key || undefined;
+}
+function formatCve(cve) {
+    const cveData = cve["cve"] ?? cve;
+    const id = cveData["id"] ?? cveData["CVE_data_meta"];
+    const metrics = cveData["metrics"];
+    const cvssV31 = metrics?.["cvssMetricV31"]?.[0];
+    const cvssV30 = metrics?.["cvssMetricV30"]?.[0];
+    const cvssV2 = metrics?.["cvssMetricV2"]?.[0];
+    const cvss = cvssV31 ?? cvssV30 ?? cvssV2;
+    const cvssData = cvss?.["cvssData"];
+    const descriptions = cveData["descriptions"];
+    const enDesc = descriptions?.find((d) => d["lang"] === "en");
+    const weaknesses = cveData["weaknesses"];
+    const cwes = weaknesses?.flatMap((w) => w["description"]?.map((d) => d["value"]));
+    const refs = cveData["references"];
+    return {
+        id,
+        status: cveData["vulnStatus"],
+        description: enDesc?.["value"] ?? null,
+        published: cveData["published"],
+        last_modified: cveData["lastModified"],
+        cvss_version: cvssData?.["version"],
+        cvss_score: cvssData?.["baseScore"],
+        cvss_severity: cvss?.["baseSeverity"] ?? cvssData?.["baseSeverity"],
+        cvss_vector: cvssData?.["vectorString"],
+        cwe: cwes?.filter(Boolean) ?? [],
+        references: refs?.slice(0, 5).map((r) => ({ url: r["url"], tags: r["tags"] })) ?? [],
+    };
+}
+// ─── get_cve_detail ───────────────────────────────────────────────────────────
+export async function getCveDetail(args) {
+    try {
+        const cveId = String(args.cve_id ?? "").trim().toUpperCase();
+        if (!cveId)
+            return { error: "cve_id is required (e.g. CVE-2024-1234)." };
+        if (!/^CVE-\d{4}-\d{4,}$/.test(cveId))
+            return { error: "cve_id must be in format CVE-YYYY-NNNNN." };
+        const apiKey = getOptionalKey(args);
+        const data = await nvdGet({ cveId }, apiKey);
+        const vulns = data["vulnerabilities"];
+        if (!vulns?.length)
+            return { error: `CVE "${cveId}" not found.`, cve_id: cveId };
+        return formatCve(vulns[0]);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── search_cve ───────────────────────────────────────────────────────────────
+export async function searchCve(args) {
+    try {
+        const apiKey = getOptionalKey(args);
+        const params = {
+            resultsPerPage: String(Math.min(50, Number(args.limit ?? 10))),
+            startIndex: String(Number(args.offset ?? 0)),
+        };
+        if (args.keyword)
+            params["keywordSearch"] = String(args.keyword);
+        if (args.severity) {
+            const sev = String(args.severity).toUpperCase();
+            const valid = ["CRITICAL", "HIGH", "MEDIUM", "LOW", "NONE"];
+            if (!valid.includes(sev))
+                return { error: `severity must be one of: ${valid.join(", ")}` };
+            params["cvssV3Severity"] = sev;
+        }
+        if (args.date_from)
+            params["pubStartDate"] = String(args.date_from);
+        if (args.date_to)
+            params["pubEndDate"] = String(args.date_to);
+        if (args.cpe_name)
+            params["cpeName"] = String(args.cpe_name);
+        if (args.has_cert_alerts)
+            params["hasCertAlerts"] = "";
+        if (args.is_kev)
+            params["isVulnerable"] = "";
+        const data = await nvdGet(params, apiKey);
+        const vulns = data["vulnerabilities"] ?? [];
+        return {
+            total_results: data["totalResults"],
+            results_per_page: data["resultsPerPage"],
+            start_index: data["startIndex"],
+            vulnerabilities: vulns.map(formatCve),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── get_recent_cves ──────────────────────────────────────────────────────────
+export async function getRecentCves(args) {
+    try {
+        const apiKey = getOptionalKey(args);
+        const limit = Math.min(20, Number(args.limit ?? 10));
+        const daysBack = Math.min(120, Number(args.days ?? 7));
+        const pubEndDate = new Date().toISOString().replace("T", " ").slice(0, 19) + ".000";
+        const pubStartDate = new Date(Date.now() - daysBack * 86400 * 1000)
+            .toISOString()
+            .replace("T", " ")
+            .slice(0, 19) + ".000";
+        const params = {
+            pubStartDate,
+            pubEndDate,
+            resultsPerPage: String(limit),
+            startIndex: "0",
+        };
+        if (args.severity)
+            params["cvssV3Severity"] = String(args.severity).toUpperCase();
+        const data = await nvdGet(params, apiKey);
+        const vulns = data["vulnerabilities"] ?? [];
+        return {
+            days_back: daysBack,
+            total_results: data["totalResults"],
+            showing: vulns.length,
+            vulnerabilities: vulns.map(formatCve),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=nvd-tool.js.map

package/dist/nvd-tool.js.map

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

package/dist/omdb-tool.d.ts

@@ -0,0 +1,4 @@
+export declare function omdbSearch(args: Record<string, unknown>): Promise<unknown>;
+export declare function omdbGetByTitle(args: Record<string, unknown>): Promise<unknown>;
+export declare function omdbGetById(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=omdb-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omdb-tool.d.ts","sourceRoot":"","sources":["../src/omdb-tool.ts"],"names":[],"mappings":"AAyCA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjF"}

package/dist/omdb-tool.js

@@ -0,0 +1,62 @@
+// OMDB (Open Movie Database) API integration for the UnClick MCP server.
+// Uses the OMDB REST API via fetch - no external dependencies.
+// Requires OMDB_API_KEY environment variable.
+const OMDB_BASE = "http://www.omdbapi.com/";
+// ─── API helper ───────────────────────────────────────────────────────────────
+function requireApiKey() {
+    const key = process.env.OMDB_API_KEY?.trim() ?? "";
+    if (!key)
+        throw new Error("OMDB_API_KEY environment variable is not set.");
+    return key;
+}
+async function omdbCall(params) {
+    const apiKey = requireApiKey();
+    const url = new URL(OMDB_BASE);
+    url.searchParams.set("apikey", apiKey);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "") {
+            url.searchParams.set(k, String(v));
+        }
+    }
+    const response = await fetch(url.toString());
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from OMDB API`);
+    }
+    const data = (await response.json());
+    if (data.Response === "False") {
+        throw new Error(`OMDB API error: ${data.Error ?? "Unknown error"}`);
+    }
+    return data;
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export async function omdbSearch(args) {
+    const s = String(args.s ?? "").trim();
+    if (!s)
+        throw new Error("s (search query) is required.");
+    const params = { s };
+    if (args.type)
+        params.type = String(args.type);
+    if (args.y)
+        params.y = String(args.y);
+    if (args.page)
+        params.page = Number(args.page);
+    return omdbCall(params);
+}
+export async function omdbGetByTitle(args) {
+    const t = String(args.t ?? "").trim();
+    if (!t)
+        throw new Error("t (title) is required.");
+    const params = { t };
+    if (args.type)
+        params.type = String(args.type);
+    if (args.y)
+        params.y = String(args.y);
+    return omdbCall(params);
+}
+export async function omdbGetById(args) {
+    const i = String(args.i ?? "").trim();
+    if (!i)
+        throw new Error("i (IMDb ID) is required.");
+    return omdbCall({ i });
+}
+//# sourceMappingURL=omdb-tool.js.map

package/dist/omdb-tool.js.map

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

package/dist/openaq-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function getAirQuality(args: Record<string, unknown>): Promise<unknown>;
+export declare function getAirMeasurements(args: Record<string, unknown>): Promise<unknown>;
+export declare function getAqCountries(args: Record<string, unknown>): Promise<unknown>;
+export declare function openaqAction(action: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=openaq-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openaq-tool.d.ts","sourceRoot":"","sources":["../src/openaq-tool.ts"],"names":[],"mappings":"AAqCA,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAgDlB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAID,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/openaq-tool.js

@@ -0,0 +1,141 @@
+// ─── OpenAQ Air Quality Data ──────────────────────────────────────────────────
+// OpenAQ v3 API for real-time and historical air quality measurements.
+// Auth: OPENAQ_API_KEY env or api_key arg (X-API-Key header).
+// Docs: https://docs.openaq.io/
+const OPENAQ_BASE = "https://api.openaq.io/v3";
+// ─── API helper ──────────────────────────────────────────────────────────────
+function getKey(args) {
+    return String(args.api_key ?? process.env.OPENAQ_API_KEY ?? "").trim();
+}
+async function openaqFetch(path, params, apiKey) {
+    const url = new URL(`${OPENAQ_BASE}${path}`);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            url.searchParams.set(k, v);
+    }
+    const headers = { "Accept": "application/json" };
+    if (apiKey)
+        headers["X-API-Key"] = apiKey;
+    const res = await fetch(url.toString(), { headers });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        const msg = body.detail ?? body.message ?? `HTTP ${res.status}`;
+        throw new Error(`OpenAQ API error: ${String(msg)}`);
+    }
+    return res.json();
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function getAirQuality(args) {
+    const apiKey = getKey(args);
+    const city = String(args.city ?? "").trim();
+    const lat = args.lat !== undefined ? Number(args.lat) : null;
+    const lon = args.lon !== undefined ? Number(args.lon) : null;
+    const limit = String(Math.min(100, Math.max(1, Number(args.limit ?? 10))));
+    const params = { limit };
+    if (lat !== null && lon !== null && Number.isFinite(lat) && Number.isFinite(lon)) {
+        params.coordinates = `${lat},${lon}`;
+        params.radius = String(args.radius ?? 25000);
+    }
+    else if (city) {
+        params.city = city;
+    }
+    else {
+        throw new Error("Either city or lat+lon is required.");
+    }
+    const data = await openaqFetch("/locations", params, apiKey);
+    return {
+        count: data.meta?.found ?? data.results.length,
+        locations: data.results.map((loc) => ({
+            id: loc.id,
+            name: loc.name,
+            city: loc.city ?? null,
+            country: loc.country?.code ?? loc.country ?? null,
+            lat: loc.coordinates?.latitude ?? null,
+            lon: loc.coordinates?.longitude ?? null,
+            is_mobile: loc.isMobile ?? false,
+            is_monitor: loc.isMonitor ?? false,
+            sensors: Array.isArray(loc.sensors)
+                ? loc.sensors.map((s) => ({
+                    id: s.id,
+                    parameter: s.parameter?.name ?? s.parameter,
+                    unit: s.parameter?.units ?? null,
+                }))
+                : [],
+            last_updated: loc.datetimeLast
+                ? loc.datetimeLast.utc ?? null
+                : null,
+        })),
+    };
+}
+export async function getAirMeasurements(args) {
+    const apiKey = getKey(args);
+    const locationId = String(args.location_id ?? "").trim();
+    if (!locationId)
+        throw new Error("location_id is required.");
+    const parameter = String(args.parameter ?? "").toLowerCase().trim();
+    const limit = String(Math.min(1000, Math.max(1, Number(args.limit ?? 100))));
+    const params = { limit };
+    if (parameter)
+        params.parameters_id = parameter;
+    // Get sensors for this location, then measurements
+    const sensors = await openaqFetch(`/locations/${locationId}/sensors`, {}, apiKey);
+    // Filter by parameter if provided
+    let filteredSensors = sensors.results;
+    if (parameter) {
+        filteredSensors = filteredSensors.filter((s) => {
+            const paramName = String(s.parameter?.name ?? "").toLowerCase();
+            return paramName.includes(parameter);
+        });
+    }
+    const measurements = [];
+    for (const sensor of filteredSensors.slice(0, 5)) {
+        const sensorId = String(sensor.id);
+        const mData = await openaqFetch(`/sensors/${sensorId}/measurements`, { limit: String(Math.min(50, Number(limit))) }, apiKey);
+        for (const m of mData.results) {
+            measurements.push({
+                sensor_id: sensorId,
+                parameter: sensor.parameter?.name ?? null,
+                unit: sensor.parameter?.units ?? null,
+                value: m.value?.value ?? m.value,
+                date: m.period?.datetimeFrom
+                    ? m.period.datetimeFrom?.utc
+                    : null,
+            });
+        }
+    }
+    return {
+        location_id: locationId,
+        parameter: parameter || "all",
+        count: measurements.length,
+        measurements,
+    };
+}
+export async function getAqCountries(args) {
+    const apiKey = getKey(args);
+    const limit = String(Math.min(200, Math.max(1, Number(args.limit ?? 100))));
+    const data = await openaqFetch("/countries", { limit }, apiKey);
+    return {
+        count: data.meta?.found ?? data.results.length,
+        countries: data.results.map((c) => ({
+            code: c.code,
+            name: c.name,
+            locations: c.locationsCount ?? null,
+            first_updated: c.firstUpdated ?? null,
+            last_updated: c.lastUpdated ?? null,
+        })),
+    };
+}
+// ─── Public dispatcher ────────────────────────────────────────────────────────
+export async function openaqAction(action, args) {
+    switch (action) {
+        case "get_air_quality": return getAirQuality(args);
+        case "get_air_measurements": return getAirMeasurements(args);
+        case "get_aq_countries": return getAqCountries(args);
+        default:
+            return {
+                error: `Unknown OpenAQ action: "${action}". ` +
+                    "Valid: get_air_quality, get_air_measurements, get_aq_countries.",
+            };
+    }
+}
+//# sourceMappingURL=openaq-tool.js.map

package/dist/openaq-tool.js.map

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

package/dist/openexchangerates-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function forexLatest(args: Record<string, unknown>): Promise<unknown>;
+export declare function forexHistorical(args: Record<string, unknown>): Promise<unknown>;
+export declare function forexCurrencies(_args: Record<string, unknown>): Promise<unknown>;
+export declare function forexConvert(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=openexchangerates-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openexchangerates-tool.d.ts","sourceRoot":"","sources":["../src/openexchangerates-tool.ts"],"names":[],"mappings":"AAqCA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBjF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBrF;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBlF"}

package/dist/openexchangerates-tool.js

@@ -0,0 +1,101 @@
+// Open Exchange Rates integration for the UnClick MCP server.
+// Uses the Open Exchange Rates REST API via fetch - no external dependencies.
+// Users must register at openexchangerates.org to get a free App ID.
+const OXR_BASE = "https://openexchangerates.org/api";
+// --- API helper ---
+function requireAppId() {
+    const id = (process.env.OPENEXCHANGERATES_APP_ID ?? "").trim();
+    if (!id)
+        throw new Error("OPENEXCHANGERATES_APP_ID environment variable is required.");
+    return id;
+}
+async function oxrFetch(path, params = {}) {
+    const app_id = requireAppId();
+    const url = new URL(`${OXR_BASE}${path}`);
+    url.searchParams.set("app_id", app_id);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    const response = await fetch(url.toString());
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`HTTP ${response.status} from Open Exchange Rates API${text ? `: ${text}` : ""}`);
+    }
+    const data = await response.json();
+    if (data.error) {
+        throw new Error(`Open Exchange Rates error: ${data.description ?? data.message ?? "Unknown error"}`);
+    }
+    return data;
+}
+// --- Operations ---
+export async function forexLatest(args) {
+    const params = {};
+    const base = String(args.base ?? "").trim().toUpperCase();
+    const symbols = String(args.symbols ?? "").trim().toUpperCase();
+    // Note: changing base currency requires a paid plan
+    if (base)
+        params.base = base;
+    if (symbols)
+        params.symbols = symbols;
+    const data = await oxrFetch("/latest.json", params);
+    return {
+        base: data.base,
+        timestamp: data.timestamp,
+        date: new Date(Number(data.timestamp) * 1000).toISOString().split("T")[0],
+        rates: data.rates,
+    };
+}
+export async function forexHistorical(args) {
+    const date = String(args.date ?? "").trim();
+    if (!date || !/^\d{4}-\d{2}-\d{2}$/.test(date)) {
+        throw new Error("date is required in YYYY-MM-DD format.");
+    }
+    const params = {};
+    const base = String(args.base ?? "").trim().toUpperCase();
+    const symbols = String(args.symbols ?? "").trim().toUpperCase();
+    if (base)
+        params.base = base;
+    if (symbols)
+        params.symbols = symbols;
+    const data = await oxrFetch(`/historical/${date}.json`, params);
+    return {
+        base: data.base,
+        date: data.date ?? date,
+        timestamp: data.timestamp,
+        rates: data.rates,
+    };
+}
+export async function forexCurrencies(_args) {
+    const data = await oxrFetch("/currencies.json");
+    const currencies = data;
+    return {
+        count: Object.keys(currencies).length,
+        currencies,
+    };
+}
+export async function forexConvert(args) {
+    const value = Number(args.value);
+    if (!value || isNaN(value))
+        throw new Error("value is required and must be a number.");
+    const from = String(args.from ?? "").trim().toUpperCase();
+    const to = String(args.to ?? "").trim().toUpperCase();
+    if (!from)
+        throw new Error("from currency is required.");
+    if (!to)
+        throw new Error("to currency is required.");
+    const params = {};
+    const date = String(args.date ?? "").trim();
+    if (date)
+        params.date = date;
+    const data = await oxrFetch(`/convert/${value}/${from}/${to}`, params);
+    const meta = data.meta;
+    const response = data.response;
+    return {
+        from,
+        to,
+        value,
+        result: response?.value ?? data.response,
+        rate: meta?.rate ?? null,
+        timestamp: meta?.timestamp ?? null,
+    };
+}
+//# sourceMappingURL=openexchangerates-tool.js.map

package/dist/openexchangerates-tool.js.map

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

package/dist/openf1-tool.d.ts

@@ -0,0 +1,9 @@
+export declare function f1Sessions(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1Drivers(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1Positions(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1Laps(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1PitStops(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1CarData(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1TeamRadio(args: Record<string, unknown>): Promise<unknown>;
+export declare function f1Weather(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=openf1-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openf1-tool.d.ts","sourceRoot":"","sources":["../src/openf1-tool.ts"],"names":[],"mappings":"AA4BA,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAoBlB"}