freshcontext-mcp 0.3.15 → 0.3.17

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

@@ -11,6 +11,7 @@ import { packageTrendsAdapter } from "./adapters/packageTrends.js";
 import { redditAdapter } from "./adapters/reddit.js";
 import { productHuntAdapter } from "./adapters/productHunt.js";
 import { financeAdapter } from "./adapters/finance.js";
+import { arxivAdapter } from "./adapters/arxiv.js";
 import { jobsAdapter } from "./adapters/jobs.js";
 import { changelogAdapter } from "./adapters/changelog.js";
 import { govContractsAdapter } from "./adapters/govcontracts.js";
@@ -21,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", {
@@ -61,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 },
@@ -88,7 +89,7 @@ server.registerTool("extract_yc", {
 }, async ({ url, max_length }) => {
     try {
         const result = await ycAdapter({ url, maxLength: max_length });
-        const ctx = stampFreshness(result, { url, maxLength: max_length }, "ycombinator");
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "yc");
         return { content: [{ type: "text", text: formatForLLM(ctx) }] };
     }
     catch (err) {
@@ -106,7 +107,7 @@ server.registerTool("search_repos", {
 }, async ({ query, max_length }) => {
     try {
         const result = await repoSearchAdapter({ url: query, maxLength: max_length });
-        const ctx = stampFreshness(result, { url: query, maxLength: max_length }, "github_search");
+        const ctx = stampFreshness(result, { url: query, maxLength: max_length }, "reposearch");
         return { content: [{ type: "text", text: formatForLLM(ctx) }] };
     }
     catch (err) {
@@ -124,7 +125,79 @@ server.registerTool("package_trends", {
 }, async ({ packages, max_length }) => {
     try {
         const result = await packageTrendsAdapter({ url: packages, maxLength: max_length });
-        const ctx = stampFreshness(result, { url: packages, maxLength: max_length }, "package_registry");
+        const ctx = stampFreshness(result, { url: packages, maxLength: max_length }, "packagetrends");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_arxiv ─────────────────────────────────────────────────────
+server.registerTool("extract_arxiv", {
+    description: "Search arXiv for research papers via the official API. Pass a topic, keyword, or full arXiv API URL. Returns titles, authors, publication dates, primary category, and abstracts — all timestamped.",
+    inputSchema: z.object({
+        url: z.string().describe("Search query e.g. 'temporal retrieval', or a full arXiv API URL"),
+        max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await arxivAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "arxiv");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_finance ───────────────────────────────────────────────────
+server.registerTool("extract_finance", {
+    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),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await financeAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "finance");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_reddit ────────────────────────────────────────────────────
+server.registerTool("extract_reddit", {
+    description: "Extract posts and community sentiment from Reddit via the public JSON API. Accepts a subreddit URL (https://www.reddit.com/r/MachineLearning/.json), a search URL, or a subreddit shorthand ('r/MachineLearning'). Returns titles, authors, scores, comment counts, and per-post timestamps.",
+    inputSchema: z.object({
+        url: z.string().describe("Subreddit URL, search URL, or 'r/<subreddit>' shorthand"),
+        max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await redditAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "reddit");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_producthunt ───────────────────────────────────────────────
+server.registerTool("extract_producthunt", {
+    description: "Recent Product Hunt launches by keyword or topic. Uses the Product Hunt GraphQL API (with HTML scrape fallback). Returns names, taglines, vote counts, comment counts, topics, and launch dates — all timestamped.",
+    inputSchema: z.object({
+        url: z.string().describe("Search query e.g. 'mcp ai agents' or a Product Hunt topic URL"),
+        max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await productHuntAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "producthunt");
         return { content: [{ type: "text", text: formatForLLM(ctx) }] };
     }
     catch (err) {
@@ -271,7 +344,7 @@ server.registerTool("extract_gov_landscape", {
         "",
         sectionWithFreshnessCheck("🏛️ Federal Contract Awards (USASpending.gov)", contractsResult, "govcontracts", min_freshness_score),
         sectionWithFreshnessCheck("💬 Developer Community Awareness (Hacker News)", hnResult, "hackernews", min_freshness_score),
-        sectionWithFreshnessCheck("📦 GitHub Repository Activity", repoResult, "github_search", min_freshness_score),
+        sectionWithFreshnessCheck("📦 GitHub Repository Activity", repoResult, "reposearch", min_freshness_score),
         sectionWithFreshnessCheck("🔄 Product Release Velocity (Changelog)", changelogResult, "changelog", min_freshness_score),
     ].filter(Boolean).join("\n\n");
     return { content: [{ type: "text", text: combined }] };
@@ -282,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."),
@@ -308,13 +381,13 @@ 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, "github_search", min_freshness_score),
+        sectionWithFreshnessCheck("📦 Repo Ecosystem (GitHub)", repoResult, "reposearch", min_freshness_score),
         sectionWithFreshnessCheck("🔄 Product Release Velocity (Changelog)", changelogResult, "changelog", min_freshness_score),
     ].filter(Boolean).join("\n\n");
     return { content: [{ type: "text", text: combined }] };
@@ -369,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."),
@@ -391,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 }] };
 });
@@ -468,10 +541,10 @@ server.registerTool("extract_idea_landscape", {
         `Launch signal (Product Hunt): What just shipped — community reception and timing.`,
         "",
         sectionWithFreshnessCheck("🗣️ Pain Signal — Developer Discussions (Hacker News)", hnResult, "hackernews", min_freshness_score),
-        sectionWithFreshnessCheck("💰 Funding Signal — Backed Companies (YC)", ycResult, "ycombinator", min_freshness_score),
-        sectionWithFreshnessCheck("📦 Crowding Signal — Open Source Landscape (GitHub)", repoResult, "github_search", min_freshness_score),
+        sectionWithFreshnessCheck("💰 Funding Signal — Backed Companies (YC)", ycResult, "yc", min_freshness_score),
+        sectionWithFreshnessCheck("📦 Crowding Signal — Open Source Landscape (GitHub)", repoResult, "reposearch", min_freshness_score),
         sectionWithFreshnessCheck("💼 Market Signal — Hiring Activity (Job Listings)", jobsResult, "jobs", min_freshness_score),
-        sectionWithFreshnessCheck("🔧 Ecosystem Signal — Package Adoption (npm/PyPI)", pkgResult, "package_registry", min_freshness_score),
+        sectionWithFreshnessCheck("🔧 Ecosystem Signal — Package Adoption (npm/PyPI)", pkgResult, "packagetrends", min_freshness_score),
         sectionWithFreshnessCheck("🚀 Launch Signal — Recent Launches (Product Hunt)", phResult, "producthunt", min_freshness_score),
     ].filter(Boolean).join("\n\n");
     return { content: [{ type: "text", text: combined }] };

package/dist/tools/freshnessStamp.js

@@ -1,26 +1,34 @@
 // ─── Decay rates per adapter ──────────────────────────────────────────────────
-// From FreshContext Specification v1.0.
-// Higher decay = data goes stale faster. Half-life = 100 / (2 * decayRate) days.
-// finance=5.0 (half-life ~10d), jobs=3.0 (~17d), news/hn=2.0 (~25d),
-// github=1.0 (~50d), scholar/arxiv=0.3 (~167d), default=1.5 (~33d)
-const DECAY_RATES = {
-    finance: 5.0,
-    search_jobs: 3.0,
-    hackernews: 2.0,
-    reddit: 2.0,
-    producthunt: 2.0,
-    yc: 1.5,
-    govcontracts: 1.5,
-    github: 1.0,
-    repoSearch: 1.0,
-    packageTrends: 1.0,
-    changelog: 1.0,
-    scholar: 0.3,
-    arxiv: 0.3,
+// Spec-compliant exponential DAR model.
+// Higher lambda = data goes stale faster. Half-life formula: t½ = ln(2) / λ.
+// Lambda is measured per hour and mirrors the Worker/D1 intelligence engine.
+export const LAMBDA = {
+    hackernews: 0.050,
+    reddit: 0.010,
+    producthunt: 0.010,
+    jobs: 0.005,
+    finance: 0.001,
+    yc: 0.001,
+    packagetrends: 0.0005,
+    github: 0.0002,
+    reposearch: 0.0002,
+    google_scholar: 0.00005,
+    arxiv: 0.00005,
+    changelog: 0.0005,
+    gdelt: 0.020,
+    gebiz: 0.003,
+    govcontracts: 0.001,
+    sec_filings: 0.005,
+    landscape: 0.050,
+    gov_landscape: 0.001,
+    finance_landscape: 0.001,
+    company_landscape: 0.005,
+    idea_landscape: 0.050,
+    default: 0.001,
 };
 // ─── Score calculation ────────────────────────────────────────────────────────
 // Returns null when content_date is unknown — we can't calculate age without a date.
-// Returns 0 when the score would go negative (content is very old).
+// Returns a clamped 0-100 exponential freshness score.
 function calculateFreshnessScore(content_date, retrieved_at, adapter) {
     if (!content_date)
         return null;
@@ -29,9 +37,9 @@ function calculateFreshnessScore(content_date, retrieved_at, adapter) {
     // Guard against unparseable dates
     if (isNaN(published) || isNaN(retrieved))
         return null;
-    const daysSinceRetrieved = (retrieved - published) / (1000 * 60 * 60 * 24);
-    const decayRate = DECAY_RATES[adapter] ?? 1.5;
-    return Math.max(0, Math.round(100 - daysSinceRetrieved * decayRate));
+    const hoursSinceRetrieved = Math.max(0, (retrieved - published) / (1000 * 60 * 60));
+    const lambda = LAMBDA[adapter] ?? LAMBDA.default;
+    return Math.max(0, Math.round(100 * Math.exp(-lambda * hoursSinceRetrieved)));
 }
 // ─── Score label ──────────────────────────────────────────────────────────────
 // Human-readable interpretation alongside the number, per the spec.
@@ -46,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.15",
-  "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"
       }

package/.actor/Dockerfile

@@ -1,19 +0,0 @@
-FROM apify/actor-node-playwright-chrome:20
-
-# Copy package files first for better Docker layer caching
-COPY package*.json ./
-
-# Install dependencies
-RUN npm install --include=dev
-
-# Install Chromium matching the npm-installed Playwright version
-RUN npx playwright install chromium
-
-# Copy source and pre-built dist
-COPY . ./
-
-# Rebuild TypeScript
-RUN npm run build || echo "Build had warnings, using pre-compiled dist/"
-
-# Run the Actor entry point
-CMD ["node", "dist/apify.js"]

package/.actor/actor.json

@@ -1,9 +0,0 @@
-{
-  "actorSpecification": 1,
-  "name": "freshcontext-mcp",
-  "title": "FreshContext MCP",
-  "version": "0.21",
-  "input": "../input_schema.json",
-  "output": "./output_schema.json",
-  "dockerfile": "./Dockerfile"
-}

package/.actor/output_schema.json

@@ -1,13 +0,0 @@
-{
-  "actorOutputSchemaVersion": 1,
-  "title": "FreshContext MCP Output",
-  "description": "Timestamped web intelligence results wrapped in FreshContext envelopes.",
-  "properties": {
-    "results": {
-      "type": "string",
-      "title": "Results",
-      "description": "FreshContext envelopes with content, source URL, retrieval timestamp, and freshness confidence.",
-      "template": "{{links.apiDefaultDatasetUrl}}/items"
-    }
-  }
-}

package/.github/workflows/publish.yml

@@ -1,32 +0,0 @@
-name: Build and Publish
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  build-and-publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Node.js 18
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build
-        run: npm run build
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        continue-on-error: true