data-aggregator-mcp 1.0.0

package/dist/tools/stocks.js

@@ -0,0 +1,172 @@
+/**
+ * query_stocks - Fetch stock and crypto market data.
+ *
+ * Free data sources:
+ *   - CoinGecko API (crypto, no key required)
+ *   - Yahoo Finance v8 unofficial API (stocks, no key required)
+ *   - Alpha Vantage (stocks, optional key via ALPHA_VANTAGE_KEY env)
+ */
+import { cache, TTL } from "../utils/cache.js";
+import { rateLimiter } from "../utils/rate-limiter.js";
+import { httpGetJson, formatError } from "../utils/http.js";
+// ─── CoinGecko ID mapping for common crypto symbols ────────────────────────
+const CRYPTO_MAP = {
+    btc: "bitcoin",
+    eth: "ethereum",
+    sol: "solana",
+    ada: "cardano",
+    dot: "polkadot",
+    matic: "matic-network",
+    avax: "avalanche-2",
+    link: "chainlink",
+    doge: "dogecoin",
+    shib: "shiba-inu",
+    xrp: "ripple",
+    bnb: "binancecoin",
+    ltc: "litecoin",
+    uni: "uniswap",
+    atom: "cosmos",
+    near: "near",
+    apt: "aptos",
+    arb: "arbitrum",
+    op: "optimism",
+    sui: "sui",
+};
+function isCrypto(symbol) {
+    return symbol.toLowerCase() in CRYPTO_MAP;
+}
+function coingeckoId(symbol) {
+    return CRYPTO_MAP[symbol.toLowerCase()] ?? symbol.toLowerCase();
+}
+// ─── Crypto via CoinGecko ──────────────────────────────────────────────────
+async function fetchCryptoQuote(symbol, vsCurrency = "usd") {
+    const id = coingeckoId(symbol);
+    const url = `https://api.coingecko.com/api/v3/coins/${id}` +
+        `?localization=false&tickers=false&community_data=false&developer_data=false`;
+    await rateLimiter.acquire("coingecko");
+    const data = await httpGetJson(url);
+    const md = data.market_data;
+    return {
+        symbol: data.symbol.toUpperCase(),
+        name: data.name,
+        price: md.current_price[vsCurrency] ?? md.current_price.usd,
+        currency: vsCurrency.toUpperCase(),
+        change24h: md.price_change_24h ?? 0,
+        changePercent24h: md.price_change_percentage_24h ?? 0,
+        volume24h: md.total_volume[vsCurrency] ?? md.total_volume.usd ?? 0,
+        marketCap: md.market_cap[vsCurrency] ?? md.market_cap.usd ?? 0,
+        high24h: md.high_24h?.[vsCurrency],
+        low24h: md.low_24h?.[vsCurrency],
+        timestamp: new Date().toISOString(),
+        source: "CoinGecko",
+    };
+}
+// ─── Stocks via Yahoo Finance (unofficial v8 endpoint) ─────────────────────
+async function fetchStockQuoteYahoo(symbol) {
+    const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(symbol)}?range=1d&interval=1d`;
+    await rateLimiter.acquire("generic");
+    const data = await httpGetJson(url, { rotateUserAgent: true });
+    const result = data?.chart?.result?.[0];
+    if (!result)
+        throw new Error(`No data found for symbol "${symbol}"`);
+    const meta = result.meta;
+    const price = meta.regularMarketPrice ?? meta.previousClose;
+    const prevClose = meta.chartPreviousClose ?? meta.previousClose ?? price;
+    return {
+        symbol: meta.symbol ?? symbol.toUpperCase(),
+        price,
+        currency: (meta.currency ?? "USD").toUpperCase(),
+        change: +(price - prevClose).toFixed(4),
+        changePercent: prevClose ? +(((price - prevClose) / prevClose) * 100).toFixed(4) : 0,
+        volume: meta.regularMarketVolume,
+        high: meta.regularMarketDayHigh,
+        low: meta.regularMarketDayLow,
+        open: meta.regularMarketOpen ?? meta.openPrice,
+        previousClose: prevClose,
+        timestamp: new Date().toISOString(),
+        source: "Yahoo Finance",
+    };
+}
+// ─── Stocks via Alpha Vantage (if key is available) ────────────────────────
+async function fetchStockQuoteAlphaVantage(symbol, apiKey) {
+    const url = `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${encodeURIComponent(symbol)}&apikey=${apiKey}`;
+    await rateLimiter.acquire("generic");
+    const data = await httpGetJson(url);
+    const q = data["Global Quote"];
+    if (!q || !q["05. price"]) {
+        throw new Error(`Alpha Vantage returned no data for "${symbol}"`);
+    }
+    const price = parseFloat(q["05. price"]);
+    const prevClose = parseFloat(q["08. previous close"]);
+    return {
+        symbol: q["01. symbol"] ?? symbol.toUpperCase(),
+        price,
+        currency: "USD",
+        change: parseFloat(q["09. change"]) || 0,
+        changePercent: parseFloat(q["10. change percent"]?.replace("%", "")) || 0,
+        volume: parseInt(q["06. volume"], 10) || undefined,
+        high: parseFloat(q["03. high"]) || undefined,
+        low: parseFloat(q["04. low"]) || undefined,
+        open: parseFloat(q["02. open"]) || undefined,
+        previousClose: prevClose || undefined,
+        timestamp: new Date().toISOString(),
+        source: "Alpha Vantage",
+    };
+}
+// ─── Public handler ────────────────────────────────────────────────────────
+export async function queryStocks(args) {
+    try {
+        const symbol = args.symbol.trim();
+        const assetType = args.type === "crypto" || (args.type !== "stock" && isCrypto(symbol))
+            ? "crypto"
+            : "stock";
+        const cacheKey = `stocks:${assetType}:${symbol.toLowerCase()}`;
+        // Check cache
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ ...cached, cached: true }, null, 2),
+                    },
+                ],
+            };
+        }
+        let result;
+        if (assetType === "crypto") {
+            result = await fetchCryptoQuote(symbol);
+        }
+        else {
+            // Try Yahoo first; fall back to Alpha Vantage if a key is available
+            try {
+                result = await fetchStockQuoteYahoo(symbol);
+            }
+            catch (yahooErr) {
+                const avKey = process.env.ALPHA_VANTAGE_KEY;
+                if (avKey) {
+                    result = await fetchStockQuoteAlphaVantage(symbol, avKey);
+                }
+                else {
+                    throw yahooErr;
+                }
+            }
+        }
+        cache.set(cacheKey, result, TTL.MARKET);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error fetching market data: ${formatError(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=stocks.js.map

package/dist/tools/stocks.js.map

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

package/dist/tools/weather.d.ts

@@ -0,0 +1,15 @@
+/**
+ * query_weather - Weather data via Open-Meteo API.
+ *
+ * Open-Meteo is 100% free, no API key required.
+ * Provides current conditions + 7-day forecast.
+ * Accepts city name (geocoded) or direct lat/lon.
+ */
+import type { ToolResult } from "../types.js";
+export declare function queryWeather(args: {
+    city?: string;
+    latitude?: number;
+    longitude?: number;
+    units?: "celsius" | "fahrenheit";
+}): Promise<ToolResult>;
+//# sourceMappingURL=weather.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"weather.d.ts","sourceRoot":"","sources":["../../src/tools/weather.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAA8C,UAAU,EAAE,MAAM,aAAa,CAAC;AA6I1F,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAClC,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DtB"}

package/dist/tools/weather.js

@@ -0,0 +1,172 @@
+/**
+ * query_weather - Weather data via Open-Meteo API.
+ *
+ * Open-Meteo is 100% free, no API key required.
+ * Provides current conditions + 7-day forecast.
+ * Accepts city name (geocoded) or direct lat/lon.
+ */
+import { cache, TTL } from "../utils/cache.js";
+import { rateLimiter } from "../utils/rate-limiter.js";
+import { httpGetJson, formatError } from "../utils/http.js";
+// ─── WMO Weather Code Descriptions ────────────────────────────────────────
+const WMO_CODES = {
+    0: "Clear sky",
+    1: "Mainly clear",
+    2: "Partly cloudy",
+    3: "Overcast",
+    45: "Fog",
+    48: "Depositing rime fog",
+    51: "Light drizzle",
+    53: "Moderate drizzle",
+    55: "Dense drizzle",
+    56: "Light freezing drizzle",
+    57: "Dense freezing drizzle",
+    61: "Slight rain",
+    63: "Moderate rain",
+    65: "Heavy rain",
+    66: "Light freezing rain",
+    67: "Heavy freezing rain",
+    71: "Slight snowfall",
+    73: "Moderate snowfall",
+    75: "Heavy snowfall",
+    77: "Snow grains",
+    80: "Slight rain showers",
+    81: "Moderate rain showers",
+    82: "Violent rain showers",
+    85: "Slight snow showers",
+    86: "Heavy snow showers",
+    95: "Thunderstorm",
+    96: "Thunderstorm with slight hail",
+    99: "Thunderstorm with heavy hail",
+};
+function weatherDescription(code) {
+    return WMO_CODES[code] ?? `Unknown (code ${code})`;
+}
+async function geocodeCity(city) {
+    const url = `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(city)}&count=1&language=en&format=json`;
+    await rateLimiter.acquire("open-meteo");
+    const data = await httpGetJson(url);
+    if (!data.results || data.results.length === 0) {
+        throw new Error(`Could not find location "${city}". Try a different spelling or use latitude/longitude.`);
+    }
+    const r = data.results[0];
+    return {
+        name: [r.name, r.admin1, r.country].filter(Boolean).join(", "),
+        latitude: r.latitude,
+        longitude: r.longitude,
+        timezone: r.timezone ?? "UTC",
+    };
+}
+// ─── Weather fetch ─────────────────────────────────────────────────────────
+async function fetchWeather(lat, lon, locationName, timezone, units) {
+    const tempUnit = units === "fahrenheit" ? "fahrenheit" : "celsius";
+    const windUnit = units === "fahrenheit" ? "mph" : "kmh";
+    const params = new URLSearchParams({
+        latitude: String(lat),
+        longitude: String(lon),
+        timezone,
+        temperature_unit: tempUnit,
+        wind_speed_unit: windUnit,
+        current: "temperature_2m,relative_humidity_2m,apparent_temperature,precipitation,weather_code,wind_speed_10m,wind_direction_10m,is_day",
+        daily: "weather_code,temperature_2m_max,temperature_2m_min,precipitation_sum,precipitation_probability_max,wind_speed_10m_max,sunrise,sunset",
+        forecast_days: "7",
+    });
+    const url = `https://api.open-meteo.com/v1/forecast?${params.toString()}`;
+    await rateLimiter.acquire("open-meteo");
+    const data = await httpGetJson(url);
+    const c = data.current;
+    const current = {
+        temperature: c.temperature_2m,
+        feelsLike: c.apparent_temperature,
+        humidity: c.relative_humidity_2m,
+        windSpeed: c.wind_speed_10m,
+        windDirection: c.wind_direction_10m,
+        precipitation: c.precipitation,
+        weatherCode: c.weather_code,
+        weatherDescription: weatherDescription(c.weather_code),
+        isDay: c.is_day === 1,
+        timestamp: new Date().toISOString(),
+    };
+    const d = data.daily;
+    const forecast = [];
+    for (let i = 0; i < (d.time?.length ?? 0); i++) {
+        forecast.push({
+            date: d.time[i],
+            temperatureMax: d.temperature_2m_max[i],
+            temperatureMin: d.temperature_2m_min[i],
+            precipitationSum: d.precipitation_sum[i],
+            precipitationProbability: d.precipitation_probability_max[i],
+            windSpeedMax: d.wind_speed_10m_max[i],
+            weatherCode: d.weather_code[i],
+            weatherDescription: weatherDescription(d.weather_code[i]),
+            sunrise: d.sunrise[i],
+            sunset: d.sunset[i],
+        });
+    }
+    return {
+        location: locationName,
+        latitude: lat,
+        longitude: lon,
+        timezone,
+        current,
+        forecast,
+        source: "Open-Meteo",
+    };
+}
+// ─── Public handler ────────────────────────────────────────────────────────
+export async function queryWeather(args) {
+    try {
+        const { city, units = "celsius" } = args;
+        let { latitude, longitude } = args;
+        if (!city && (latitude === undefined || longitude === undefined)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: 'Please provide either a city name or both latitude and longitude.',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        let locationName;
+        let timezone;
+        if (city) {
+            const geo = await geocodeCity(city);
+            latitude = geo.latitude;
+            longitude = geo.longitude;
+            locationName = geo.name;
+            timezone = geo.timezone;
+        }
+        else {
+            locationName = `${latitude.toFixed(4)}, ${longitude.toFixed(4)}`;
+            timezone = "UTC";
+        }
+        const cacheKey = `weather:${latitude.toFixed(2)}:${longitude.toFixed(2)}:${units}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ ...cached, cached: true }, null, 2),
+                    },
+                ],
+            };
+        }
+        const weather = await fetchWeather(latitude, longitude, locationName, timezone, units);
+        cache.set(cacheKey, weather, TTL.WEATHER);
+        return {
+            content: [{ type: "text", text: JSON.stringify(weather, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                { type: "text", text: `Error fetching weather: ${formatError(err)}` },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=weather.js.map

package/dist/tools/weather.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.js","sourceRoot":"","sources":["../../src/tools/weather.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG5D,6EAA6E;AAE7E,MAAM,SAAS,GAA2B;IACxC,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,cAAc;IACjB,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,UAAU;IACb,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,kBAAkB;IACtB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,YAAY;IAChB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,iBAAiB;IACrB,EAAE,EAAE,mBAAmB;IACvB,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,uBAAuB;IAC3B,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,oBAAoB;IACxB,EAAE,EAAE,cAAc;IAClB,EAAE,EAAE,+BAA+B;IACnC,EAAE,EAAE,8BAA8B;CACnC,CAAC;AAEF,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,iBAAiB,IAAI,GAAG,CAAC;AACrD,CAAC;AAaD,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,uDAAuD,kBAAkB,CAAC,IAAI,CAAC,kCAAkC,CAAC;IAE9H,MAAM,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,IAAI,GAAQ,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,wDAAwD,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9D,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E,KAAK,UAAU,YAAY,CACzB,GAAW,EACX,GAAW,EACX,YAAoB,EACpB,QAAgB,EAChB,KAA+B;IAE/B,MAAM,QAAQ,GAAG,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,MAAM,QAAQ,GAAG,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAExD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;QACtB,QAAQ;QACR,gBAAgB,EAAE,QAAQ;QAC1B,eAAe,EAAE,QAAQ;QACzB,OAAO,EAAE,8HAA8H;QACvI,KAAK,EAAE,sIAAsI;QAC7I,aAAa,EAAE,GAAG;KACnB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,0CAA0C,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAE1E,MAAM,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,IAAI,GAAQ,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAEzC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;IACvB,MAAM,OAAO,GAAmB;QAC9B,WAAW,EAAE,CAAC,CAAC,cAAc;QAC7B,SAAS,EAAE,CAAC,CAAC,oBAAoB;QACjC,QAAQ,EAAE,CAAC,CAAC,oBAAoB;QAChC,SAAS,EAAE,CAAC,CAAC,cAAc;QAC3B,aAAa,EAAE,CAAC,CAAC,kBAAkB;QACnC,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC;QACtD,KAAK,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACf,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvC,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvC,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACxC,wBAAwB,EAAE,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC;YAC5D,YAAY,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACrC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9B,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACzD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,GAAG;QACd,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM,EAAE,YAAY;KACrB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAKlC;IACC,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;QACzC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAEnC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,EAAE,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mEAAmE;qBAC1E;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,YAAoB,CAAC;QACzB,IAAI,QAAgB,CAAC;QAErB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACpC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YACxB,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAC1B,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC;YACxB,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,GAAG,QAAS,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,QAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,SAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QACrF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAc,QAAQ,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC3D;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAS,EAAE,SAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE;aACtE;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,160 @@
+/** Generic API response wrapper */
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    cached?: boolean;
+    timestamp: string;
+}
+export interface StockQuote {
+    symbol: string;
+    name?: string;
+    price: number;
+    currency: string;
+    change: number;
+    changePercent: number;
+    volume?: number;
+    marketCap?: number;
+    high?: number;
+    low?: number;
+    open?: number;
+    previousClose?: number;
+    timestamp: string;
+    source: string;
+}
+export interface CryptoQuote {
+    symbol: string;
+    name: string;
+    price: number;
+    currency: string;
+    change24h: number;
+    changePercent24h: number;
+    volume24h: number;
+    marketCap: number;
+    high24h?: number;
+    low24h?: number;
+    timestamp: string;
+    source: string;
+}
+export interface CurrentWeather {
+    temperature: number;
+    feelsLike: number;
+    humidity: number;
+    windSpeed: number;
+    windDirection: number;
+    precipitation: number;
+    weatherCode: number;
+    weatherDescription: string;
+    isDay: boolean;
+    timestamp: string;
+}
+export interface DailyForecast {
+    date: string;
+    temperatureMax: number;
+    temperatureMin: number;
+    precipitationSum: number;
+    precipitationProbability: number;
+    windSpeedMax: number;
+    weatherCode: number;
+    weatherDescription: string;
+    sunrise: string;
+    sunset: string;
+}
+export interface WeatherData {
+    location: string;
+    latitude: number;
+    longitude: number;
+    timezone: string;
+    current: CurrentWeather;
+    forecast: DailyForecast[];
+    source: string;
+}
+export interface NewsArticle {
+    title: string;
+    description: string;
+    url: string;
+    source: string;
+    publishedAt: string;
+    author?: string;
+    imageUrl?: string;
+}
+export interface ExchangeRate {
+    base: string;
+    target: string;
+    rate: number;
+    timestamp: string;
+    source: string;
+}
+export interface CurrencyConversion {
+    from: string;
+    to: string;
+    amount: number;
+    convertedAmount: number;
+    rate: number;
+    timestamp: string;
+}
+export interface ScrapedPage {
+    url: string;
+    title: string;
+    metaDescription: string;
+    headings: {
+        level: number;
+        text: string;
+    }[];
+    mainContent: string;
+    links: {
+        text: string;
+        href: string;
+    }[];
+    selectedContent?: string;
+    timestamp: string;
+}
+export interface WikipediaSummary {
+    title: string;
+    extract: string;
+    url: string;
+    thumbnail?: string;
+    timestamp: string;
+}
+export interface IpGeolocation {
+    ip: string;
+    country: string;
+    countryCode: string;
+    region: string;
+    city: string;
+    latitude: number;
+    longitude: number;
+    timezone: string;
+    isp: string;
+}
+export interface DnsRecord {
+    domain: string;
+    type: string;
+    records: string[];
+    ttl?: number;
+}
+export interface UrlInfo {
+    originalUrl: string;
+    expandedUrl: string;
+    statusCode: number;
+    contentType?: string;
+}
+export interface CacheEntry<T> {
+    data: T;
+    expiresAt: number;
+    createdAt: number;
+}
+export interface RateLimitConfig {
+    maxRequests: number;
+    windowMs: number;
+    source: string;
+}
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Shared Types ──────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * In-memory cache with per-key TTL support.
+ *
+ * TTL defaults (in milliseconds):
+ *   - Market data:    5 minutes   (300_000)
+ *   - Exchange rates: 30 minutes  (1_800_000)
+ *   - Weather:        1 hour      (3_600_000)
+ *   - News:           15 minutes  (900_000)
+ *   - Web scraping:   10 minutes  (600_000)
+ *   - Public data:    1 hour      (3_600_000)
+ */
+export declare const TTL: {
+    readonly MARKET: number;
+    readonly EXCHANGE: number;
+    readonly WEATHER: number;
+    readonly NEWS: number;
+    readonly SCRAPE: number;
+    readonly PUBLIC: number;
+};
+export declare class Cache {
+    private store;
+    private cleanupInterval;
+    constructor(cleanupIntervalMs?: number);
+    /** Retrieve a cached value, or undefined if missing / expired. */
+    get<T>(key: string): T | undefined;
+    /** Store a value with a TTL (milliseconds). */
+    set<T>(key: string, data: T, ttlMs: number): void;
+    /** Check whether a non-expired entry exists. */
+    has(key: string): boolean;
+    /** Remove a single key. */
+    delete(key: string): void;
+    /** Remove all entries. */
+    clear(): void;
+    /** Number of entries (including possibly-expired ones until next sweep). */
+    get size(): number;
+    /** Build a deterministic cache key from parts. */
+    static key(...parts: (string | number | boolean | undefined | null)[]): string;
+    /** Remove all expired entries. */
+    private evictExpired;
+    /** Tear down the cleanup interval (for graceful shutdown). */
+    destroy(): void;
+}
+/** Singleton cache instance shared across the server. */
+export declare const cache: Cache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,GAAG;;;;;;;CAON,CAAC;AAEX,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,eAAe,CAAiC;gBAE5C,iBAAiB,SAAS;IAStC,kEAAkE;IAClE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAYlC,+CAA+C;IAC/C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQjD,gDAAgD;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,2BAA2B;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAIb,4EAA4E;IAC5E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,kDAAkD;IAClD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM;IAM9E,kCAAkC;IAClC,OAAO,CAAC,YAAY;IASpB,8DAA8D;IAC9D,OAAO,IAAI,IAAI;CAGhB;AAED,yDAAyD;AACzD,eAAO,MAAM,KAAK,OAAc,CAAC"}