freshcontext-mcp 0.3.16 → 0.3.17

package/.env.example

@@ -4,5 +4,8 @@
 # Optional: GitHub Personal Access Token (increases rate limits for GitHub API fallback)
 GITHUB_TOKEN=
 
+# Optional: Product Hunt developer token (enables GraphQL path; scraper fallback works without it)
+PH_TOKEN=
+
 # Optional: Proxy URL if needed for certain extractions
 # PROXY_URL=http://user:pass@host:port

package/README.md

@@ -41,7 +41,7 @@ R_t = R_0 · e^(−λt)
 
 That's the whole fix. No model swap. No re-embedding. No re-indexing. The layer drops onto whatever retrieval pipeline you already have.
 
-**The layer is the product.** The 20 adapters shipped with this repo are reference implementations demonstrating compatibility — useful, but commodity. The DAR engine, the freshness envelope, and the FreshContext Specification are the moat.
+**The layer is the product.** The 21 tools shipped with this repo are reference implementations demonstrating compatibility — useful, but commodity. The DAR engine, the freshness envelope, and the FreshContext Specification are the moat.
 
 ---
 
@@ -82,7 +82,7 @@ Production endpoint: `https://freshcontext-mcp.gimmanuel73.workers.dev`
 
 ## Reference adapters
 
-The repo ships 20 adapters demonstrating how to make any data source FreshContext-compatible. Useful as drop-in tools, but the value is the layer above them.
+The repo ships 21 tools demonstrating how to make any data source FreshContext-compatible. Useful as drop-in tools, but the value is the layer above them.
 
 ### Intelligence
 | Adapter | What it returns |
@@ -104,7 +104,7 @@ The repo ships 20 adapters demonstrating how to make any data source FreshContex
 ### Market data
 | Adapter | What it returns |
 |---|---|
-| `extract_finance` | Live stock data — price, market cap, P/E, 52w range. Up to 5 tickers. |
+| `extract_finance` | No-key Stooq quote data — close, OHLC, volume, quote timestamp, source. Up to 5 tickers. |
 | `search_jobs` | Remote job listings from Remotive, RemoteOK, HN "Who is Hiring" |
 
 ### Composites — multiple sources, one call
@@ -153,7 +153,7 @@ Restart Claude. Done.
 
 ### Local (full Playwright)
 
-**Requires:** Node.js 18+ ([nodejs.org](https://nodejs.org))
+**Requires:** Node.js 20+ ([nodejs.org](https://nodejs.org))
 
 ```bash
 git clone https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
@@ -259,12 +259,12 @@ Production: `https://freshcontext-mcp.gimmanuel73.workers.dev`
 ## Roadmap
 
 - [x] FreshContext Specification v1.1 published (MIT, open standard)
-- [x] DAR engine with proprietary λ constants (v0.3.15)
+- [x] DAR engine with proprietary λ constants (v0.3.17)
 - [x] Ha-Pri audit signatures on every signal
 - [x] Semantic deduplication via fingerprinting
 - [x] Live before/after demo at `/demo`
 - [x] METHODOLOGY.md — formal IP and engineering documentation
-- [x] 20 reference adapters across intelligence, competitive research, market data, and composites
+- [x] 21 reference tools across intelligence, competitive research, market data, and composites
 - [x] Cloudflare Workers deployment — global edge, KV cache, KV rate limiting
 - [x] Listed on official MCP Registry, Apify Store, npm
 - [x] GitHub Actions CI/CD — auto-publish on every push

package/dist/adapters/finance.js

@@ -1,117 +1,103 @@
-function formatMarketCap(cap) {
-    if (!cap)
-        return "N/A";
-    if (cap >= 1e12)
-        return `$${(cap / 1e12).toFixed(2)}T`;
-    if (cap >= 1e9)
-        return `$${(cap / 1e9).toFixed(2)}B`;
-    if (cap >= 1e6)
-        return `$${(cap / 1e6).toFixed(2)}M`;
-    return `$${cap.toLocaleString()}`;
+function toStooqSymbol(ticker) {
+    const clean = ticker.trim().toUpperCase().replace(/[^A-Z0-9.^=-]/g, "");
+    if (!clean)
+        throw new Error("Ticker cannot be empty");
+    if (clean.includes(".") || clean.startsWith("^") || clean.includes("="))
+        return clean;
+    return `${clean}.US`;
 }
-function formatChange(change, pct) {
-    if (change === undefined || pct === undefined)
-        return "N/A";
-    const sign = change >= 0 ? "+" : "";
-    return `${sign}${change.toFixed(2)} (${sign}${pct.toFixed(2)}%)`;
+function toNumber(value) {
+    if (value === undefined || value === "N/D")
+        return null;
+    const n = typeof value === "number" ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+function normalizeQuoteTimestamp(date, time) {
+    if (!date || date === "N/D")
+        throw new Error("Quote date unavailable");
+    const clock = time && time !== "N/D" ? time : "00:00:00";
+    const parsed = new Date(`${date}T${clock}Z`);
+    if (Number.isNaN(parsed.getTime()))
+        throw new Error(`Invalid quote timestamp: ${date} ${time}`);
+    return parsed.toISOString();
+}
+function formatNumber(value, prefix = "") {
+    const n = toNumber(value);
+    return n === null ? "N/A" : `${prefix}${n.toLocaleString(undefined, { maximumFractionDigits: 4 })}`;
+}
+async function fetchStooqQuote(ticker) {
+    const stooqSymbol = toStooqSymbol(ticker);
+    const url = `https://stooq.com/q/l/?s=${encodeURIComponent(stooqSymbol.toLowerCase())}&f=sd2t2ohlcv&h&e=json`;
+    const res = await fetch(url, {
+        headers: {
+            "User-Agent": "freshcontext-mcp/0.3.17",
+            "Accept": "application/json",
+        },
+    });
+    if (!res.ok)
+        throw new Error(`Stooq quote API error: ${res.status}`);
+    const data = await res.json();
+    const quote = data.symbols?.[0];
+    if (!quote)
+        throw new Error(`No quote returned for ${ticker}`);
+    if (quote.close === "N/D" || quote.date === "N/D") {
+        throw new Error(`No Stooq quote data found for ${ticker}`);
+    }
+    return {
+        requested: ticker,
+        stooqSymbol,
+        quote,
+        timestamp: normalizeQuoteTimestamp(quote.date, quote.time),
+    };
+}
+function formatQuote(result) {
+    const q = result.quote;
+    return [
+        `${result.requested.toUpperCase()} — ${q.symbol}`,
+        `source: stooq`,
+        `Quote timestamp: ${result.timestamp}`,
+        "",
+        `Close:  ${formatNumber(q.close, "$")}`,
+        `Open:   ${formatNumber(q.open, "$")}`,
+        `High:   ${formatNumber(q.high, "$")}`,
+        `Low:    ${formatNumber(q.low, "$")}`,
+        `Volume: ${formatNumber(q.volume)}`,
+    ].join("\n");
 }
 export async function financeAdapter(options) {
     const input = options.url.trim();
-    // Support comma-separated tickers
     const rawTickers = input
         .split(",")
-        .map((t) => t.trim().toUpperCase())
+        .map((t) => t.trim())
         .filter(Boolean)
-        .slice(0, 5); // max 5 at once
-    const results = [];
-    let latestTimestamp = null;
+        .slice(0, 5);
+    if (!rawTickers.length)
+        throw new Error("At least one ticker is required");
+    const successes = [];
+    const failures = [];
     for (const ticker of rawTickers) {
         try {
-            const quoteData = await fetchQuote(ticker);
-            if (quoteData) {
-                results.push(formatQuote(quoteData));
-                if (quoteData.regularMarketTime) {
-                    latestTimestamp = Math.max(latestTimestamp ?? 0, quoteData.regularMarketTime);
-                }
-            }
+            successes.push(await fetchStooqQuote(ticker));
         }
         catch (err) {
-            results.push(`[${ticker}] Error: ${err instanceof Error ? err.message : String(err)}`);
+            failures.push(`[${ticker.toUpperCase()}] ${err instanceof Error ? err.message : String(err)}`);
         }
     }
-    const raw = results.join("\n\n─────────────────────────────\n\n").slice(0, options.maxLength ?? 5000);
-    const content_date = latestTimestamp
-        ? new Date(latestTimestamp * 1000).toISOString()
-        : new Date().toISOString();
-    return { raw, content_date, freshness_confidence: "high" };
-}
-async function fetchQuote(ticker) {
-    // v7 quote endpoint — public, no auth
-    const quoteUrl = `https://query1.finance.yahoo.com/v7/finance/quote?symbols=${encodeURIComponent(ticker)}&fields=shortName,longName,regularMarketPrice,regularMarketChange,regularMarketChangePercent,marketCap,regularMarketVolume,fiftyTwoWeekHigh,fiftyTwoWeekLow,trailingPE,dividendYield,currency,exchangeName,regularMarketTime`;
-    const quoteRes = await fetch(quoteUrl, {
-        headers: {
-            "User-Agent": "Mozilla/5.0 (compatible; freshcontext-mcp/0.1.5)",
-            "Accept": "application/json",
-        },
-    });
-    if (!quoteRes.ok)
-        throw new Error(`Yahoo Finance API error: ${quoteRes.status}`);
-    const quoteJson = await quoteRes.json();
-    const quote = quoteJson?.quoteResponse?.result?.[0];
-    if (!quote)
-        throw new Error(`No data found for ticker: ${ticker}`);
-    // Optionally fetch company summary (v11 quoteSummary)
-    try {
-        const summaryUrl = `https://query1.finance.yahoo.com/v11/finance/quoteSummary/${encodeURIComponent(ticker)}?modules=assetProfile`;
-        const summaryRes = await fetch(summaryUrl, {
-            headers: { "User-Agent": "Mozilla/5.0 (compatible; freshcontext-mcp/0.1.5)" },
-        });
-        if (summaryRes.ok) {
-            const summaryJson = await summaryRes.json();
-            const profile = summaryJson?.quoteSummary?.result?.[0]?.assetProfile;
-            if (profile) {
-                Object.assign(quote, {
-                    longBusinessSummary: profile.longBusinessSummary,
-                    sector: profile.sector,
-                    industry: profile.industry,
-                    fullTimeEmployees: profile.fullTimeEmployees,
-                    website: profile.website,
-                });
-            }
-        }
-    }
-    catch {
-        // Summary is optional — continue without it
-    }
-    return quote;
-}
-function formatQuote(q) {
-    const lines = [
-        `${q.symbol} — ${q.longName ?? q.shortName ?? "Unknown"}`,
-        `Exchange: ${q.exchangeName ?? "N/A"} · Currency: ${q.currency ?? "USD"}`,
-        "",
-        `Price:       ${q.regularMarketPrice !== undefined ? `$${q.regularMarketPrice.toFixed(2)}` : "N/A"}`,
-        `Change:      ${formatChange(q.regularMarketChange, q.regularMarketChangePercent)}`,
-        `Market Cap:  ${formatMarketCap(q.marketCap)}`,
-        `Volume:      ${q.regularMarketVolume?.toLocaleString() ?? "N/A"}`,
-        `52w High:    ${q.fiftyTwoWeekHigh !== undefined ? `$${q.fiftyTwoWeekHigh.toFixed(2)}` : "N/A"}`,
-        `52w Low:     ${q.fiftyTwoWeekLow !== undefined ? `$${q.fiftyTwoWeekLow.toFixed(2)}` : "N/A"}`,
-        `P/E Ratio:   ${q.trailingPE !== undefined ? q.trailingPE.toFixed(2) : "N/A"}`,
-        `Div Yield:   ${q.dividendYield !== undefined ? `${(q.dividendYield * 100).toFixed(2)}%` : "N/A"}`,
-    ];
-    if (q.sector || q.industry) {
-        lines.push("");
-        if (q.sector)
-            lines.push(`Sector:      ${q.sector}`);
-        if (q.industry)
-            lines.push(`Industry:    ${q.industry}`);
-        if (q.fullTimeEmployees)
-            lines.push(`Employees:   ${q.fullTimeEmployees.toLocaleString()}`);
-        if (q.website)
-            lines.push(`Website:     ${q.website}`);
+    if (!successes.length) {
+        throw new Error(`Finance quote lookup failed for all tickers via source=stooq. ${failures.join("; ")}`);
     }
-    if (q.longBusinessSummary) {
-        lines.push("", "About:", q.longBusinessSummary.slice(0, 500) + (q.longBusinessSummary.length > 500 ? "…" : ""));
+    const sections = successes.map(formatQuote);
+    if (failures.length) {
+        sections.push(["Partial failures:", ...failures.map((f) => `- ${f}`)].join("\n"));
     }
-    return lines.join("\n");
+    const raw = sections.join("\n\n-----------------------------\n\n").slice(0, options.maxLength ?? 5000);
+    const content_date = successes
+        .map((s) => s.timestamp)
+        .sort()
+        .reverse()[0] ?? null;
+    return {
+        raw,
+        content_date,
+        freshness_confidence: failures.length ? "medium" : "high",
+    };
 }

package/dist/adapters/gdelt.js

@@ -11,7 +11,7 @@
  */
 const HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "freshcontext-mcp/1.0 contact@freshcontext.dev",
+    "User-Agent": "freshcontext-mcp/0.3.17 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
 };
 function parseGdeltDate(raw) {
     if (!raw)

package/dist/adapters/gebiz.js

@@ -20,7 +20,7 @@ const DATASET_ID = "d_acde1106003906a75c3fa052592f2fcb";
 const BASE_URL = "https://data.gov.sg/api/action/datastore_search";
 const HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "freshcontext-mcp/1.0 contact@freshcontext.dev",
+    "User-Agent": "freshcontext-mcp/0.3.17 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
 };
 function formatDate(raw) {
     if (!raw)

package/dist/adapters/hackernews.js

@@ -1,9 +1,29 @@
 import { chromium } from "playwright";
 import { validateUrl } from "../security.js";
+function isUrl(input) {
+    try {
+        new URL(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeHnDate(raw) {
+    if (!raw)
+        return null;
+    const match = raw.match(/\b\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z?\b/);
+    if (!match)
+        return null;
+    const isoLike = match[0].endsWith("Z") ? match[0] : `${match[0]}Z`;
+    const parsed = new Date(isoLike);
+    return Number.isNaN(parsed.getTime()) ? null : parsed.toISOString();
+}
 export async function hackerNewsAdapter(options) {
-    // Validate URL — allow both HN and Algolia domains
-    validateUrl(options.url, "hackernews");
-    const url = options.url;
+    const input = options.url.trim();
+    if (!input)
+        throw new Error("HN URL or search query is required");
+    const url = isUrl(input) ? validateUrl(input, "hackernews") : `hn-search:${input}`;
     if (url.includes("hn.algolia.com/api/") || url.startsWith("hn-search:")) {
         const query = url.startsWith("hn-search:")
             ? url.replace("hn-search:", "").trim()
@@ -20,14 +40,17 @@ export async function hackerNewsAdapter(options) {
             `[${i + 1}] ${r.title ?? "Untitled"}`,
             `URL: ${r.url ?? `https://news.ycombinator.com/item?id=${r.objectID}`}`,
             `Score: ${r.points} points | ${r.num_comments} comments`,
-            `Author: ${r.author} | Posted: ${r.created_at}`,
+            `Author: ${r.author} | Posted: ${normalizeHnDate(r.created_at) ?? r.created_at}`,
         ].join("\n"))
             .join("\n\n")
             .slice(0, options.maxLength ?? 4000);
-        const newest = data.hits.map((r) => r.created_at).sort().reverse()[0] ?? null;
+        const newest = data.hits
+            .map((r) => normalizeHnDate(r.created_at))
+            .filter((d) => Boolean(d))
+            .sort()
+            .reverse()[0] ?? null;
         return { raw, content_date: newest, freshness_confidence: newest ? "high" : "medium" };
     }
-    // Default: browser-based scrape for HN front page or search pages
     const browser = await chromium.launch({ headless: true });
     const page = await browser.newPage();
     await page.goto(url, { waitUntil: "domcontentloaded", timeout: 20000 });
@@ -51,14 +74,21 @@ export async function hackerNewsAdapter(options) {
     await browser.close();
     const typedData = data;
     const raw = typedData
-        .map((r, i) => [
-        `[${i + 1}] ${r.title ?? "Untitled"}`,
-        `URL: ${r.link ?? "N/A"}`,
-        `Score: ${r.score ?? "N/A"} | ${r.commentLink ?? ""}`,
-        `Posted: ${r.age ?? "unknown"}`,
-    ].join("\n"))
+        .map((r, i) => {
+        const date = normalizeHnDate(r.age);
+        return [
+            `[${i + 1}] ${r.title ?? "Untitled"}`,
+            `URL: ${r.link ?? "N/A"}`,
+            `Score: ${r.score ?? "N/A"} | ${r.commentLink ?? ""}`,
+            `Posted: ${date ?? "unknown"}`,
+        ].join("\n");
+    })
         .join("\n\n");
-    const newestDate = typedData.map((r) => r.age).filter(Boolean).sort().reverse()[0] ?? null;
+    const newestDate = typedData
+        .map((r) => normalizeHnDate(r.age))
+        .filter((d) => Boolean(d))
+        .sort()
+        .reverse()[0] ?? null;
     return {
         raw,
         content_date: newestDate,

package/dist/adapters/productHunt.js

@@ -1,5 +1,10 @@
+import { validateUrl } from "../security.js";
 export async function productHuntAdapter(options) {
-    // PH GraphQL API — public, no auth for published posts
+    const token = process.env.PH_TOKEN?.trim() || process.env.PRODUCTHUNT_TOKEN?.trim();
+    if (!token)
+        return scrapeProductHunt(options);
+    // Product Hunt GraphQL API requires a bearer token. Keep it in env/secrets,
+    // never in source.
     const query = options.url.startsWith("http")
         ? null
         : options.url;
@@ -28,8 +33,7 @@ export async function productHuntAdapter(options) {
         method: "POST",
         headers: {
             "Content-Type": "application/json",
-            // Public access token (read-only, rate-limited but usable)
-            "Authorization": "Bearer irgTzMNAz-S-p1P8H5pFCxzU4TEF7GIJZ8vZZi0gLJg",
+            "Authorization": `Bearer ${token}`,
         },
         body: JSON.stringify({ query: gql }),
     });
@@ -68,7 +72,7 @@ export async function productHuntAdapter(options) {
 async function scrapeProductHunt(options) {
     const { chromium } = await import("playwright");
     const url = options.url.startsWith("http")
-        ? options.url
+        ? validateUrl(options.url, "productHunt")
         : `https://www.producthunt.com/search?q=${encodeURIComponent(options.url)}`;
     const browser = await chromium.launch({ headless: true });
     const page = await browser.newPage();

package/dist/adapters/repoSearch.js

@@ -22,7 +22,7 @@ export async function repoSearchAdapter(options) {
     const res = await fetch(apiUrl, {
         headers: {
             Accept: "application/vnd.github.v3+json",
-            "User-Agent": "freshcontext-mcp/0.1.0",
+            "User-Agent": "freshcontext-mcp/0.3.17 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
         },
     });
     if (!res.ok) {

package/dist/adapters/secFilings.js

@@ -12,7 +12,7 @@
  */
 const HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "freshcontext-mcp/1.0 contact@freshcontext.dev",
+    "User-Agent": "freshcontext-mcp/0.3.17 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
 };
 async function fetchSecFilings(query, maxResults = 10) {
     const today = new Date().toISOString().slice(0, 10);

package/dist/security.js

@@ -11,7 +11,7 @@ export const ALLOWED_DOMAINS = {
     repoSearch: [], // uses GitHub API directly, no browser
     packageTrends: [], // uses npm/PyPI APIs directly, no browser
     reddit: [], // uses public Reddit JSON API, no browser
-    finance: [], // uses Yahoo Finance API, no browser
+    finance: [], // uses Stooq quote API, no browser
     productHunt: ["www.producthunt.com", "producthunt.com"],
 };
 // ─── Blocked IP ranges and internal hostnames ────────────────────────────────

package/dist/server.js

@@ -22,7 +22,7 @@ import { stampFreshness, formatForLLM } from "./tools/freshnessStamp.js";
 import { formatSecurityError } from "./security.js";
 const server = new McpServer({
     name: "freshcontext-mcp",
-    version: "0.1.0",
+    version: "0.3.17",
 });
 // ─── Tool: extract_github ────────────────────────────────────────────────────
 server.registerTool("extract_github", {
@@ -62,9 +62,9 @@ server.registerTool("extract_scholar", {
 });
 // ─── Tool: extract_hackernews ────────────────────────────────────────────────
 server.registerTool("extract_hackernews", {
-    description: "Extract top stories or search results from Hacker News. Real-time dev/tech community sentiment with post timestamps.",
+    description: "Extract top stories or search results from Hacker News. Accepts an HN/Algolia URL or a plain search query while preserving the url field for compatibility.",
     inputSchema: z.object({
-        url: z.string().url().describe("HN URL e.g. https://news.ycombinator.com or https://hn.algolia.com/?q=..."),
+        url: z.string().min(1).describe("HN URL e.g. https://news.ycombinator.com/news, Algolia API URL, or search query e.g. 'browser agents'"),
         max_length: z.number().optional().default(4000),
     }),
     annotations: { readOnlyHint: true, openWorldHint: true },
@@ -152,7 +152,7 @@ server.registerTool("extract_arxiv", {
 });
 // ─── Tool: extract_finance ───────────────────────────────────────────────────
 server.registerTool("extract_finance", {
-    description: "Live stock data via Yahoo Finance — price, change, market cap, P/E, 52w range, sector, business summary. Accepts up to 5 comma-separated tickers. Returns timestamped freshcontext.",
+    description: "No-key stock quote data via Stooq — close, open, high, low, volume, quote timestamp, and source. Accepts up to 5 comma-separated tickers. Returns timestamped freshcontext only for successful observations.",
     inputSchema: z.object({
         url: z.string().describe("Ticker symbol(s) e.g. 'AAPL' or 'MSFT,GOOG,PLTR'"),
         max_length: z.number().optional().default(5000),
@@ -355,7 +355,7 @@ server.registerTool("extract_gov_landscape", {
 // community sentiment, repo ecosystem size, and product release velocity.
 // Unique: Bloomberg Terminal doesn't read commit history as a company health signal.
 server.registerTool("extract_finance_landscape", {
-    description: "Composite financial intelligence tool for developers. Given one or more ticker symbols, simultaneously queries: (1) Yahoo Finance for live price/market data, (2) Hacker News for developer community sentiment, (3) Reddit for investor and tech community discussion, (4) GitHub for repo ecosystem activity around the company's tech, and (5) their product changelog for release velocity as a company health signal. Answers: What's the price? What are developers saying? Is the company actually shipping? Returns a unified 5-source timestamped report. Bloomberg Terminal doesn't give you this.",
+    description: "Composite financial intelligence tool for developers. Given one or more ticker symbols, simultaneously queries: (1) Stooq for no-key quote data, (2) Hacker News for developer community sentiment, (3) Reddit for investor and tech community discussion, (4) GitHub for repo ecosystem activity around the company's tech, and (5) their product changelog for release velocity as a company health signal. Answers: What's the price? What are developers saying? Is the company actually shipping? Returns a unified 5-source timestamped report.",
     inputSchema: z.object({
         tickers: z.string().describe("One or more ticker symbols e.g. 'PLTR' or 'PLTR,MSFT,GOOG'. Up to 5 tickers."),
         company_name: z.string().optional().describe("Company name for HN/Reddit/GitHub searches e.g. 'Palantir'. If omitted, derived from the ticker."),
@@ -381,10 +381,10 @@ server.registerTool("extract_finance_landscape", {
     const combined = [
         `# Finance + Developer Intelligence: "${tickers}"${company_name ? ` (${company_name})` : ""}`,
         `Generated: ${new Date().toISOString()}`,
-        `Sources: Yahoo Finance · Hacker News · Reddit · GitHub · Changelog`,
+        `Sources: Stooq · Hacker News · Reddit · GitHub · Changelog`,
         min_freshness_score ? `min_freshness_score: ${min_freshness_score}` : null,
         "",
-        sectionWithFreshnessCheck("📈 Market Data (Yahoo Finance)", priceResult, "finance", min_freshness_score),
+        sectionWithFreshnessCheck("📈 Market Data (Stooq)", priceResult, "finance", min_freshness_score),
         sectionWithFreshnessCheck("💬 Developer Sentiment (Hacker News)", hnResult, "hackernews", min_freshness_score),
         sectionWithFreshnessCheck("🗣️ Community Discussion (Reddit)", redditResult, "reddit", min_freshness_score),
         sectionWithFreshnessCheck("📦 Repo Ecosystem (GitHub)", repoResult, "reposearch", min_freshness_score),
@@ -442,7 +442,7 @@ server.registerTool("extract_gdelt", {
 // global news intelligence + product release velocity + market pricing.
 // Unique: this combination exists nowhere else.
 server.registerTool("extract_company_landscape", {
-    description: "Composite company intelligence tool. The most complete single-call company analysis available. Simultaneously queries 5 unique sources: (1) SEC EDGAR for 8-K material event filings — what the company legally just disclosed, (2) USASpending.gov for federal contract footprint — who is giving them government money, (3) GDELT for global news intelligence — what the world is saying about them right now, (4) their product changelog — are they actually shipping, (5) Yahoo Finance — what the market is pricing in. Returns a unified 5-source timestamped report. Unique: this combination is not available in any other MCP server.",
+    description: "Composite company intelligence tool. The most complete single-call company analysis available. Simultaneously queries 5 unique sources: (1) SEC EDGAR for 8-K material event filings — what the company legally just disclosed, (2) USASpending.gov for federal contract footprint — who is giving them government money, (3) GDELT for global news intelligence — what the world is saying about them right now, (4) their product changelog — are they actually shipping, (5) Stooq quote data — what the market is pricing in. Returns a unified 5-source timestamped report. Unique: this combination is not available in any other MCP server.",
     inputSchema: z.object({
         company: z.string().describe("Company name e.g. 'Palantir', 'Anthropic', 'OpenAI'"),
         ticker: z.string().optional().describe("Stock ticker for finance data e.g. 'PLTR'. Leave blank for private companies."),
@@ -464,14 +464,14 @@ server.registerTool("extract_company_landscape", {
     const combined = [
         `# Company Intelligence Landscape: "${company}"${ticker ? ` (${ticker})` : ""}`,
         `Generated: ${new Date().toISOString()}`,
-        `Sources: SEC EDGAR · USASpending.gov · GDELT · Changelog · Yahoo Finance`,
+        `Sources: SEC EDGAR · USASpending.gov · GDELT · Changelog · Stooq`,
         min_freshness_score ? `min_freshness_score: ${min_freshness_score}` : null,
         "",
         sectionWithFreshnessCheck("📋 SEC 8-K Filings — Legal Disclosures", secResult, "sec_filings", min_freshness_score),
         sectionWithFreshnessCheck("🏛️ Federal Contract Awards (USASpending.gov)", contractsResult, "govcontracts", min_freshness_score),
         sectionWithFreshnessCheck("🌍 Global News Intelligence (GDELT)", gdeltResult, "gdelt", min_freshness_score),
         sectionWithFreshnessCheck("🔄 Product Release Velocity (Changelog)", changelogResult, "changelog", min_freshness_score),
-        sectionWithFreshnessCheck("📈 Market Data (Yahoo Finance)", financeResult, "finance", min_freshness_score),
+        sectionWithFreshnessCheck("📈 Market Data (Stooq)", financeResult, "finance", min_freshness_score),
     ].filter(Boolean).join("\n\n");
     return { content: [{ type: "text", text: combined }] };
 });

package/dist/tools/freshnessStamp.js

@@ -54,16 +54,36 @@ function scoreLabel(score) {
         return "verify before acting";
     return "use with caution";
 }
+function looksLikeFailedAdapterContent(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return true;
+    if (/^\[(?:error|security)\]/i.test(trimmed))
+        return true;
+    if (/^(?:error|failed|upstream|timeout)\b/i.test(trimmed))
+        return true;
+    const meaningful = trimmed
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (!meaningful.length)
+        return true;
+    const failureLines = meaningful.filter((line) => /\b(?:error|failed|failure|timeout|401|403|404|429|5\d\d)\b/i.test(line));
+    return failureLines.length === meaningful.length;
+}
 // ─── Main stamp function ──────────────────────────────────────────────────────
 export function stampFreshness(result, options, adapter) {
     const retrieved_at = new Date().toISOString();
-    const freshness_score = calculateFreshnessScore(result.content_date, retrieved_at, adapter);
+    const failedContent = looksLikeFailedAdapterContent(result.raw);
+    const content_date = failedContent ? null : result.content_date;
+    const freshness_confidence = failedContent ? "low" : result.freshness_confidence;
+    const freshness_score = calculateFreshnessScore(content_date, retrieved_at, adapter);
     return {
         content: result.raw.slice(0, options.maxLength ?? 8000),
         source_url: options.url,
-        content_date: result.content_date,
+        content_date,
         retrieved_at,
-        freshness_confidence: result.freshness_confidence,
+        freshness_confidence,
         freshness_score,
         adapter,
     };

package/freshcontext.schema.json

@@ -36,7 +36,7 @@
           "type": ["number", "null"],
           "minimum": 0,
           "maximum": 100,
-          "description": "Optional numeric freshness score 0-100. Calculated as: max(0, 100 - (days_since_retrieved * decay_rate)). Null if content_date is unknown.",
+          "description": "Optional numeric freshness score 0-100. Calculated with source-specific exponential temporal decay. Null if content_date is unknown.",
           "examples": [94, 72, 45, null]
         },
         "adapter": {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "freshcontext-mcp",
   "mcpName": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "version": "0.3.16",
-  "description": "Real-time web intelligence for AI agents. 20 tools, no API keys. Every result timestamped with a freshness score.",
+  "version": "0.3.17",
+  "description": "Real-time web intelligence for AI agents. 21 tools, no required API keys. Every result timestamped with a freshness score.",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -24,6 +24,9 @@
   },
   "license": "MIT",
   "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "dist/server.js",
   "bin": {
     "freshcontext-mcp": "dist/server.js"
@@ -33,20 +36,24 @@
     "dev": "tsx watch src/server.ts",
     "start": "node dist/server.js",
     "inspect": "npx @modelcontextprotocol/inspector tsx src/server.ts",
+    "smoke:stdio": "node scripts/smoke-stdio.mjs",
     "test": "jest"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "apify": "^3.0.0",
+    "dotenv": "^16.4.0",
     "playwright": "^1.44.0",
-    "zod": "^3.23.0",
-    "dotenv": "^16.4.0"
+    "zod": "^3.23.0"
   },
   "devDependencies": {
+    "@types/jest": "^29.0.0",
     "@types/node": "^20.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.4.0",
     "jest": "^29.0.0",
-    "@types/jest": "^29.0.0"
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0"
+  },
+  "overrides": {
+    "file-type": "21.3.4"
   }
 }

package/server.json

@@ -1,19 +1,19 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
   "name": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "description": "Real-time web intelligence for AI agents. 20 tools, no API keys. GitHub, HN, Reddit, arXiv, SEC filings, US gov contracts, GDELT global news, Singapore GeBIZ, changelog & more — every result timestamped with a freshness score.",
+  "description": "Real-time web intelligence for AI agents. 21 tools, no required API keys. GitHub, HN, Reddit, arXiv, SEC filings, US gov contracts, GDELT global news, Singapore GeBIZ, changelog & more — every result timestamped with a freshness score.",
   "repository": {
     "url": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
     "source": "github"
   },
-  "version": "0.3.15",
+  "version": "0.3.17",
   "website_url": "https://freshcontext-site.pages.dev",
   "packages": [
     {
       "registry_type": "npm",
       "registry_base_url": "https://registry.npmjs.org",
       "identifier": "freshcontext-mcp",
-      "version": "0.3.15",
+      "version": "0.3.17",
       "transport": {
         "type": "stdio"
       }