freshcontext-mcp 0.1.4 → 0.1.6

package/README.md

@@ -21,14 +21,14 @@ Every piece of data extracted by `freshcontext-mcp` is wrapped in a structured e
 [FRESHCONTEXT]
 Source: https://github.com/owner/repo
 Published: 2024-11-03
-Retrieved: 2026-03-03T10:14:00Z
+Retrieved: 2026-03-04T10:14:00Z
 Confidence: high
 ---
 ... content ...
 [/FRESHCONTEXT]
 ```
 
-The AI agent always knows **when it's looking at data**, not just what the data says. This is the difference between a hallucinated recency claim and a verifiable one.
+The AI agent always knows **when it's looking at data**, not just what the data says.
 
 ---
 
@@ -60,13 +60,33 @@ The AI agent always knows **when it's looking at data**, not just what the data
 
 ## Quick Start
 
-### Install via npm
+### Option A — Cloud (no install, works immediately)
 
-```bash
-npx freshcontext-mcp
+No Node, no Playwright, nothing to install. Just add this to your Claude Desktop config and restart.
+
+**Mac:** open `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** open `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "freshcontext": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"]
+    }
+  }
+}
 ```
 
-### Or clone and run locally
+Restart Claude Desktop. The freshcontext tools will appear in your session.
+
+> **Note:** If `claude_desktop_config.json` doesn't exist yet, create it with the content above.
+
+---
+
+### Option B — Local (full Playwright, faster for heavy use)
+
+**Prerequisites:** Node.js 18+ ([nodejs.org](https://nodejs.org))
 
 ```bash
 git clone https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
@@ -76,39 +96,56 @@ npx playwright install chromium
 npm run build
 ```
 
-### Connect to Claude Desktop
-
-Add to your `claude_desktop_config.json`:
-
-**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`  
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+Then add to your Claude Desktop config:
 
+**Mac** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 ```json
 {
   "mcpServers": {
-    "freshcontext-local": {
+    "freshcontext": {
       "command": "node",
-      "args": ["/absolute/path/to/freshcontext-mcp/dist/server.js"]
+      "args": ["/Users/YOUR_USERNAME/path/to/freshcontext-mcp/dist/server.js"]
     }
   }
 }
 ```
 
-Restart Claude Desktop. You'll see the freshcontext tools available in your session.
-
-### Or use the Cloudflare edge deployment (no install needed)
-
+**Windows** (`%APPDATA%\Claude\claude_desktop_config.json`):
 ```json
 {
   "mcpServers": {
-    "freshcontext-cloud": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://freshcontext-worker.gimmanuel73.workers.dev/mcp"]
+    "freshcontext": {
+      "command": "node",
+      "args": ["C:\\Users\\YOUR_USERNAME\\path\\to\\freshcontext-mcp\\dist\\server.js"]
     }
   }
 }
 ```
 
+Restart Claude Desktop.
+
+---
+
+### Troubleshooting (Mac)
+
+**"command not found: node"** — Node isn't on your PATH inside Claude Desktop's environment. Use the full path:
+```bash
+which node   # copy this output
+```
+Then replace `"command": "node"` with `"command": "/usr/local/bin/node"` (or whatever `which node` returned).
+
+**"npx: command not found"** — Same issue. Run `which npx` and use the full path for Option A:
+```json
+"command": "/usr/local/bin/npx"
+```
+
+**Config file doesn't exist** — Create it. On Mac:
+```bash
+mkdir -p ~/Library/Application\ Support/Claude
+touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
+```
+Then paste the config JSON above into it.
+
 ---
 
 ## Usage Examples
@@ -162,12 +199,12 @@ This makes freshness **verifiable**, not assumed.
 Uses headless Chromium via Playwright. Full browser rendering for JavaScript-heavy sites.
 
 ### Cloud (Cloudflare Workers)
-The `worker/` directory contains a Cloudflare Workers deployment using the Browser Rendering REST API. No Playwright dependency — runs at the edge globally.
+The `worker/` directory contains a Cloudflare Workers deployment. No Playwright dependency — runs at the edge globally.
 
 ```bash
 cd worker
 npm install
-npx wrangler secret put CF_API_TOKEN
+npx wrangler secret put API_KEY
 npx wrangler deploy
 ```
 
@@ -180,15 +217,16 @@ freshcontext-mcp/
 ├── src/
 │   ├── server.ts              # MCP server, all tool registrations
 │   ├── types.ts               # FreshContext interfaces
+│   ├── security.ts            # Input validation, domain allowlists
 │   ├── adapters/
-│   │   ├── github.ts          # GitHub repo extraction
-│   │   ├── hackernews.ts      # HN front page + Algolia API
-│   │   ├── scholar.ts         # Google Scholar scraping
-│   │   ├── yc.ts              # YC company directory
-│   │   ├── repoSearch.ts      # GitHub Search API
-│   │   └── packageTrends.ts   # npm + PyPI registries
+│   │   ├── github.ts
+│   │   ├── hackernews.ts
+│   │   ├── scholar.ts
+│   │   ├── yc.ts
+│   │   ├── repoSearch.ts
+│   │   └── packageTrends.ts
 │   └── tools/
-│       └── freshnessStamp.ts  # FreshContext envelope builder
+│       └── freshnessStamp.ts
 └── worker/                    # Cloudflare Workers deployment
     └── src/worker.ts
 ```
@@ -205,17 +243,17 @@ freshcontext-mcp/
 - [x] npm/PyPI package trends
 - [x] `extract_landscape` composite tool
 - [x] Cloudflare Workers deployment
+- [x] Worker auth + rate limiting + domain allowlists
 - [ ] Product Hunt launches adapter
-- [ ] Crunchbase/funding signals adapter
+- [ ] Finance/market data adapter
 - [ ] TTL-based caching layer
 - [ ] `freshness_score` numeric metric
-- [ ] Webhook support for real-time updates
 
 ---
 
 ## Contributing
 
-PRs welcome. New adapters are the highest-value contribution — see the existing adapters in `src/adapters/` for the pattern. Each adapter returns `{ raw, content_date, freshness_confidence }`.
+PRs welcome. New adapters are the highest-value contribution — see `src/adapters/` for the pattern. Each adapter returns `{ raw, content_date, freshness_confidence }`.
 
 ---
 

package/dist/adapters/finance.js

@@ -0,0 +1,117 @@
+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 formatChange(change, pct) {
+    if (change === undefined || pct === undefined)
+        return "N/A";
+    const sign = change >= 0 ? "+" : "";
+    return `${sign}${change.toFixed(2)} (${sign}${pct.toFixed(2)}%)`;
+}
+export async function financeAdapter(options) {
+    const input = options.url.trim();
+    // Support comma-separated tickers
+    const rawTickers = input
+        .split(",")
+        .map((t) => t.trim().toUpperCase())
+        .filter(Boolean)
+        .slice(0, 5); // max 5 at once
+    const results = [];
+    let latestTimestamp = null;
+    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);
+                }
+            }
+        }
+        catch (err) {
+            results.push(`[${ticker}] Error: ${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 (q.longBusinessSummary) {
+        lines.push("", "About:", q.longBusinessSummary.slice(0, 500) + (q.longBusinessSummary.length > 500 ? "…" : ""));
+    }
+    return lines.join("\n");
+}

package/dist/adapters/productHunt.js

@@ -0,0 +1,100 @@
+export async function productHuntAdapter(options) {
+    // PH GraphQL API — public, no auth for published posts
+    const query = options.url.startsWith("http")
+        ? null
+        : options.url;
+    const gql = query
+        ? `{
+        posts(first: 20, order: VOTES, search: ${JSON.stringify(query)}) {
+          edges {
+            node {
+              name tagline url votesCount commentsCount createdAt
+              topics { edges { node { name } } }
+            }
+          }
+        }
+      }`
+        : `{
+        posts(first: 20, order: VOTES, postedAfter: "${new Date(Date.now() - 7 * 86400000).toISOString()}") {
+          edges {
+            node {
+              name tagline url votesCount commentsCount createdAt
+              topics { edges { node { name } } }
+            }
+          }
+        }
+      }`;
+    const res = await fetch("https://api.producthunt.com/v2/api/graphql", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            // Public access token (read-only, rate-limited but usable)
+            "Authorization": "Bearer irgTzMNAz-S-p1P8H5pFCxzU4TEF7GIJZ8vZZi0gLJg",
+        },
+        body: JSON.stringify({ query: gql }),
+    });
+    // Fallback: scrape the HTML if the API fails
+    if (!res.ok) {
+        return scrapeProductHunt(options);
+    }
+    const data = await res.json();
+    if (data.errors?.length || !data.data?.posts?.edges?.length) {
+        return scrapeProductHunt(options);
+    }
+    const posts = data.data.posts.edges;
+    const raw = posts
+        .map((edge, i) => {
+        const p = edge.node;
+        const topics = p.topics?.edges?.map((t) => t.node.name).join(", ") ?? "";
+        return [
+            `[${i + 1}] ${p.name}`,
+            `"${p.tagline}"`,
+            `↑ ${p.votesCount} upvotes · ${p.commentsCount} comments`,
+            topics ? `Topics: ${topics}` : null,
+            `Launched: ${p.createdAt?.slice(0, 10) ?? "unknown"}`,
+            `Link: ${p.url}`,
+        ].filter(Boolean).join("\n");
+    })
+        .join("\n\n")
+        .slice(0, options.maxLength ?? 6000);
+    const newest = posts
+        .map((e) => e.node.createdAt)
+        .filter(Boolean)
+        .sort()
+        .reverse()[0] ?? null;
+    return { raw, content_date: newest, freshness_confidence: newest ? "high" : "medium" };
+}
+// ─── Fallback scraper ─────────────────────────────────────────────────────────
+async function scrapeProductHunt(options) {
+    const { chromium } = await import("playwright");
+    const url = options.url.startsWith("http")
+        ? options.url
+        : `https://www.producthunt.com/search?q=${encodeURIComponent(options.url)}`;
+    const browser = await chromium.launch({ headless: true });
+    const page = await browser.newPage();
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 25000 });
+    await page.waitForTimeout(1500);
+    const posts = await page.evaluate(`(function() {
+    var items = document.querySelectorAll('[data-test="post-item"], .styles_item__Pf8AC');
+    if (!items.length) items = document.querySelectorAll('li[class*="post"]');
+    return Array.from(items).slice(0, 20).map(function(el) {
+      var name = el.querySelector('h3, [class*="title"]')?.textContent?.trim() ?? null;
+      var tagline = el.querySelector('p, [class*="tagline"]')?.textContent?.trim() ?? null;
+      var votes = el.querySelector('[class*="vote"], [data-test*="vote"]')?.textContent?.trim() ?? null;
+      var link = el.querySelector('a')?.href ?? null;
+      return { name, tagline, votes, link };
+    }).filter(function(p) { return p.name; });
+  })()`);
+    await browser.close();
+    const typedPosts = posts;
+    const raw = typedPosts
+        .map((p, i) => [
+        `[${i + 1}] ${p.name ?? "Untitled"}`,
+        p.tagline ? `"${p.tagline}"` : null,
+        p.votes ? `↑ ${p.votes}` : null,
+        p.link ? `Link: ${p.link}` : null,
+    ].filter(Boolean).join("\n"))
+        .join("\n\n")
+        .slice(0, options.maxLength ?? 6000);
+    return { raw, content_date: new Date().toISOString(), freshness_confidence: "medium" };
+}

package/dist/adapters/reddit.js

@@ -0,0 +1,59 @@
+/**
+ * Reddit adapter — public JSON API, no auth required.
+ * Accepts subreddit URLs or search queries.
+ * e.g. https://www.reddit.com/r/MachineLearning/.json
+ *      https://www.reddit.com/search.json?q=mcp+server&sort=hot
+ */
+export async function redditAdapter(options) {
+    let apiUrl = options.url;
+    // If they pass a plain subreddit name like "r/MachineLearning", build the URL
+    if (!apiUrl.startsWith("http")) {
+        const clean = apiUrl.replace(/^r\//, "");
+        apiUrl = `https://www.reddit.com/r/${clean}/.json?limit=25&sort=hot`;
+    }
+    // Ensure we hit the JSON endpoint
+    if (!apiUrl.includes(".json")) {
+        apiUrl = apiUrl.replace(/\/?$/, ".json");
+    }
+    // Add limit if not present
+    if (!apiUrl.includes("limit=")) {
+        apiUrl += (apiUrl.includes("?") ? "&" : "?") + "limit=25";
+    }
+    const res = await fetch(apiUrl, {
+        headers: {
+            "User-Agent": "freshcontext-mcp/0.1.5 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+            "Accept": "application/json",
+        },
+    });
+    if (!res.ok)
+        throw new Error(`Reddit API error: ${res.status} ${res.statusText}`);
+    const data = await res.json();
+    const posts = data?.data?.children ?? [];
+    if (posts.length === 0)
+        throw new Error("No posts found — check the subreddit or search URL.");
+    const raw = posts
+        .slice(0, 20)
+        .map((child, i) => {
+        const p = child.data;
+        const date = new Date(p.created_utc * 1000).toISOString();
+        const lines = [
+            `[${i + 1}] ${p.title}`,
+            `r/${p.subreddit} · u/${p.author} · ${date.slice(0, 10)}`,
+            `↑ ${p.score} upvotes · ${p.num_comments} comments`,
+            `Link: https://reddit.com${p.permalink}`,
+        ];
+        if (p.is_self && p.selftext) {
+            lines.push(`Preview: ${p.selftext.slice(0, 200).replace(/\n/g, " ")}…`);
+        }
+        return lines.join("\n");
+    })
+        .join("\n\n")
+        .slice(0, options.maxLength ?? 6000);
+    const newest = posts
+        .map((c) => c.data.created_utc)
+        .sort((a, b) => b - a)[0];
+    const content_date = newest
+        ? new Date(newest * 1000).toISOString()
+        : null;
+    return { raw, content_date, freshness_confidence: content_date ? "high" : "medium" };
+}

package/dist/security.js

@@ -10,6 +10,9 @@ export const ALLOWED_DOMAINS = {
     yc: ["www.ycombinator.com", "ycombinator.com"],
     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
+    productHunt: ["www.producthunt.com", "producthunt.com"],
 };
 // ─── Blocked IP ranges and internal hostnames ────────────────────────────────
 const BLOCKED_PATTERNS = [

package/dist/server.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freshcontext-mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Real-time web extraction MCP server with freshness timestamps for AI agents",
   "keywords": [
     "mcp",
@@ -24,6 +24,9 @@
   "license": "MIT",
   "type": "module",
   "main": "dist/server.js",
+  "bin": {
+    "freshcontext-mcp": "dist/server.js"
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsx watch src/server.ts",
@@ -45,3 +48,4 @@
     "@types/jest": "^29.0.0"
   }
 }
+

package/src/adapters/finance.ts

@@ -0,0 +1,159 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+
+/**
+ * Finance adapter — Yahoo Finance public API, no auth required.
+ * Accepts:
+ *   - A ticker symbol e.g. "AAPL" or "MSFT,GOOG"
+ *   - A company name e.g. "Apple" (will search for ticker first)
+ *   - Comma-separated tickers for comparison
+ */
+
+interface YahooQuote {
+  symbol: string;
+  shortName?: string;
+  longName?: string;
+  regularMarketPrice?: number;
+  regularMarketChange?: number;
+  regularMarketChangePercent?: number;
+  marketCap?: number;
+  regularMarketVolume?: number;
+  fiftyTwoWeekHigh?: number;
+  fiftyTwoWeekLow?: number;
+  trailingPE?: number;
+  dividendYield?: number;
+  currency?: string;
+  exchangeName?: string;
+  regularMarketTime?: number;
+  longBusinessSummary?: string;
+  sector?: string;
+  industry?: string;
+  fullTimeEmployees?: number;
+  website?: string;
+}
+
+function formatMarketCap(cap: number | undefined): string {
+  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 formatChange(change: number | undefined, pct: number | undefined): string {
+  if (change === undefined || pct === undefined) return "N/A";
+  const sign = change >= 0 ? "+" : "";
+  return `${sign}${change.toFixed(2)} (${sign}${pct.toFixed(2)}%)`;
+}
+
+export async function financeAdapter(options: ExtractOptions): Promise<AdapterResult> {
+  const input = options.url.trim();
+
+  // Support comma-separated tickers
+  const rawTickers = input
+    .split(",")
+    .map((t) => t.trim().toUpperCase())
+    .filter(Boolean)
+    .slice(0, 5); // max 5 at once
+
+  const results: string[] = [];
+  let latestTimestamp: number | null = null;
+
+  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);
+        }
+      }
+    } catch (err) {
+      results.push(`[${ticker}] Error: ${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: string): Promise<YahooQuote | null> {
+  // 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() as {
+    quoteResponse?: { result?: YahooQuote[] };
+  };
+
+  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() as {
+        quoteSummary?: { result?: Array<{ assetProfile?: YahooQuote }> };
+      };
+      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: YahooQuote): string {
+  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 (q.longBusinessSummary) {
+    lines.push("", "About:", q.longBusinessSummary.slice(0, 500) + (q.longBusinessSummary.length > 500 ? "…" : ""));
+  }
+
+  return lines.join("\n");
+}

package/src/adapters/productHunt.ts

@@ -0,0 +1,144 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+
+/**
+ * Product Hunt adapter — scrapes today's/recent launches.
+ * Uses PH's unofficial JSON feed (no auth needed for public data).
+ * Accepts:
+ *   - A search query string e.g. "mcp ai agents"
+ *   - A PH URL e.g. https://www.producthunt.com/topics/developer-tools
+ */
+
+interface PHPost {
+  node: {
+    name: string;
+    tagline: string;
+    url: string;
+    votesCount: number;
+    commentsCount: number;
+    createdAt: string;
+    topics: { edges: Array<{ node: { name: string } }> };
+    maker?: { name: string };
+  };
+}
+
+export async function productHuntAdapter(options: ExtractOptions): Promise<AdapterResult> {
+  // PH GraphQL API — public, no auth for published posts
+  const query = options.url.startsWith("http")
+    ? null
+    : options.url;
+
+  const gql = query
+    ? `{
+        posts(first: 20, order: VOTES, search: ${JSON.stringify(query)}) {
+          edges {
+            node {
+              name tagline url votesCount commentsCount createdAt
+              topics { edges { node { name } } }
+            }
+          }
+        }
+      }`
+    : `{
+        posts(first: 20, order: VOTES, postedAfter: "${new Date(Date.now() - 7 * 86400000).toISOString()}") {
+          edges {
+            node {
+              name tagline url votesCount commentsCount createdAt
+              topics { edges { node { name } } }
+            }
+          }
+        }
+      }`;
+
+  const res = await fetch("https://api.producthunt.com/v2/api/graphql", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      // Public access token (read-only, rate-limited but usable)
+      "Authorization": "Bearer irgTzMNAz-S-p1P8H5pFCxzU4TEF7GIJZ8vZZi0gLJg",
+    },
+    body: JSON.stringify({ query: gql }),
+  });
+
+  // Fallback: scrape the HTML if the API fails
+  if (!res.ok) {
+    return scrapeProductHunt(options);
+  }
+
+  const data = await res.json() as {
+    data?: { posts?: { edges: PHPost[] } };
+    errors?: Array<{ message: string }>;
+  };
+
+  if (data.errors?.length || !data.data?.posts?.edges?.length) {
+    return scrapeProductHunt(options);
+  }
+
+  const posts = data.data.posts.edges;
+
+  const raw = posts
+    .map((edge, i) => {
+      const p = edge.node;
+      const topics = p.topics?.edges?.map((t) => t.node.name).join(", ") ?? "";
+      return [
+        `[${i + 1}] ${p.name}`,
+        `"${p.tagline}"`,
+        `↑ ${p.votesCount} upvotes · ${p.commentsCount} comments`,
+        topics ? `Topics: ${topics}` : null,
+        `Launched: ${p.createdAt?.slice(0, 10) ?? "unknown"}`,
+        `Link: ${p.url}`,
+      ].filter(Boolean).join("\n");
+    })
+    .join("\n\n")
+    .slice(0, options.maxLength ?? 6000);
+
+  const newest = posts
+    .map((e) => e.node.createdAt)
+    .filter(Boolean)
+    .sort()
+    .reverse()[0] ?? null;
+
+  return { raw, content_date: newest, freshness_confidence: newest ? "high" : "medium" };
+}
+
+// ─── Fallback scraper ─────────────────────────────────────────────────────────
+async function scrapeProductHunt(options: ExtractOptions): Promise<AdapterResult> {
+  const { chromium } = await import("playwright");
+
+  const url = options.url.startsWith("http")
+    ? options.url
+    : `https://www.producthunt.com/search?q=${encodeURIComponent(options.url)}`;
+
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage();
+
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout: 25000 });
+  await page.waitForTimeout(1500);
+
+  const posts = await page.evaluate(`(function() {
+    var items = document.querySelectorAll('[data-test="post-item"], .styles_item__Pf8AC');
+    if (!items.length) items = document.querySelectorAll('li[class*="post"]');
+    return Array.from(items).slice(0, 20).map(function(el) {
+      var name = el.querySelector('h3, [class*="title"]')?.textContent?.trim() ?? null;
+      var tagline = el.querySelector('p, [class*="tagline"]')?.textContent?.trim() ?? null;
+      var votes = el.querySelector('[class*="vote"], [data-test*="vote"]')?.textContent?.trim() ?? null;
+      var link = el.querySelector('a')?.href ?? null;
+      return { name, tagline, votes, link };
+    }).filter(function(p) { return p.name; });
+  })()`);
+
+  await browser.close();
+
+  const typedPosts = posts as Array<{ name: string | null; tagline: string | null; votes: string | null; link: string | null }>;
+
+  const raw = typedPosts
+    .map((p, i) => [
+      `[${i + 1}] ${p.name ?? "Untitled"}`,
+      p.tagline ? `"${p.tagline}"` : null,
+      p.votes ? `↑ ${p.votes}` : null,
+      p.link ? `Link: ${p.link}` : null,
+    ].filter(Boolean).join("\n"))
+    .join("\n\n")
+    .slice(0, options.maxLength ?? 6000);
+
+  return { raw, content_date: new Date().toISOString(), freshness_confidence: "medium" };
+}

package/src/adapters/reddit.ts

@@ -0,0 +1,87 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+
+/**
+ * Reddit adapter — public JSON API, no auth required.
+ * Accepts subreddit URLs or search queries.
+ * e.g. https://www.reddit.com/r/MachineLearning/.json
+ *      https://www.reddit.com/search.json?q=mcp+server&sort=hot
+ */
+export async function redditAdapter(options: ExtractOptions): Promise<AdapterResult> {
+  let apiUrl = options.url;
+
+  // If they pass a plain subreddit name like "r/MachineLearning", build the URL
+  if (!apiUrl.startsWith("http")) {
+    const clean = apiUrl.replace(/^r\//, "");
+    apiUrl = `https://www.reddit.com/r/${clean}/.json?limit=25&sort=hot`;
+  }
+
+  // Ensure we hit the JSON endpoint
+  if (!apiUrl.includes(".json")) {
+    apiUrl = apiUrl.replace(/\/?$/, ".json");
+  }
+
+  // Add limit if not present
+  if (!apiUrl.includes("limit=")) {
+    apiUrl += (apiUrl.includes("?") ? "&" : "?") + "limit=25";
+  }
+
+  const res = await fetch(apiUrl, {
+    headers: {
+      "User-Agent": "freshcontext-mcp/0.1.5 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+      "Accept": "application/json",
+    },
+  });
+
+  if (!res.ok) throw new Error(`Reddit API error: ${res.status} ${res.statusText}`);
+
+  const data = await res.json() as {
+    data: {
+      children: Array<{
+        data: {
+          title: string;
+          url: string;
+          permalink: string;
+          score: number;
+          num_comments: number;
+          author: string;
+          created_utc: number;
+          selftext: string;
+          subreddit: string;
+          is_self: boolean;
+        };
+      }>;
+    };
+  };
+
+  const posts = data?.data?.children ?? [];
+  if (posts.length === 0) throw new Error("No posts found — check the subreddit or search URL.");
+
+  const raw = posts
+    .slice(0, 20)
+    .map((child, i) => {
+      const p = child.data;
+      const date = new Date(p.created_utc * 1000).toISOString();
+      const lines = [
+        `[${i + 1}] ${p.title}`,
+        `r/${p.subreddit} · u/${p.author} · ${date.slice(0, 10)}`,
+        `↑ ${p.score} upvotes · ${p.num_comments} comments`,
+        `Link: https://reddit.com${p.permalink}`,
+      ];
+      if (p.is_self && p.selftext) {
+        lines.push(`Preview: ${p.selftext.slice(0, 200).replace(/\n/g, " ")}…`);
+      }
+      return lines.join("\n");
+    })
+    .join("\n\n")
+    .slice(0, options.maxLength ?? 6000);
+
+  const newest = posts
+    .map((c) => c.data.created_utc)
+    .sort((a, b) => b - a)[0];
+
+  const content_date = newest
+    ? new Date(newest * 1000).toISOString()
+    : null;
+
+  return { raw, content_date, freshness_confidence: content_date ? "high" : "medium" };
+}

package/src/security.ts

@@ -10,8 +10,11 @@ export const ALLOWED_DOMAINS: Record<string, string[]> = {
   scholar: ["scholar.google.com"],
   hackernews: ["news.ycombinator.com", "hn.algolia.com"],
   yc: ["www.ycombinator.com", "ycombinator.com"],
-  repoSearch: [], // uses GitHub API directly, no browser
+  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
+  productHunt: ["www.producthunt.com", "producthunt.com"],
 };
 
 // ─── Blocked IP ranges and internal hostnames ────────────────────────────────
@@ -159,3 +162,4 @@ export function formatSecurityError(err: unknown): string {
   }
   return "[Error] Unknown error occurred";
 }
+

package/src/server.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -7,6 +8,9 @@ import { hackerNewsAdapter } from "./adapters/hackernews.js";
 import { ycAdapter } from "./adapters/yc.js";
 import { repoSearchAdapter } from "./adapters/repoSearch.js";
 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 { stampFreshness, formatForLLM } from "./tools/freshnessStamp.js";
 import { SecurityError, formatSecurityError } from "./security.js";
 
@@ -202,3 +206,6 @@ async function main() {
 }
 
 main().catch(console.error);
+
+
+

package/src/server.ts.bak

@@ -0,0 +1,204 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { githubAdapter } from "./adapters/github.js";
+import { scholarAdapter } from "./adapters/scholar.js";
+import { hackerNewsAdapter } from "./adapters/hackernews.js";
+import { ycAdapter } from "./adapters/yc.js";
+import { repoSearchAdapter } from "./adapters/repoSearch.js";
+import { packageTrendsAdapter } from "./adapters/packageTrends.js";
+import { stampFreshness, formatForLLM } from "./tools/freshnessStamp.js";
+import { SecurityError, formatSecurityError } from "./security.js";
+
+const server = new McpServer({
+  name: "freshcontext-mcp",
+  version: "0.1.0",
+});
+
+// ─── Tool: extract_github ────────────────────────────────────────────────────
+server.registerTool(
+  "extract_github",
+  {
+    description:
+      "Extract real-time data from a GitHub repository — README, stars, forks, language, topics, last commit. Returns timestamped freshcontext.",
+    inputSchema: z.object({
+      url: z.string().url().describe("Full GitHub repo URL e.g. https://github.com/owner/repo"),
+      max_length: z.number().optional().default(6000).describe("Max content length"),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  async ({ url, max_length }) => {
+    try {
+      const result = await githubAdapter({ url, maxLength: max_length });
+      const ctx = stampFreshness(result, { url, maxLength: max_length }, "github");
+      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+  }
+);
+
+// ─── Tool: extract_scholar ───────────────────────────────────────────────────
+server.registerTool(
+  "extract_scholar",
+  {
+    description:
+      "Extract research results from a Google Scholar search URL. Returns titles, authors, publication years, and snippets — all timestamped.",
+    inputSchema: z.object({
+      url: z.string().url().describe("Google Scholar search URL e.g. https://scholar.google.com/scholar?q=..."),
+      max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  async ({ url, max_length }) => {
+    try {
+      const result = await scholarAdapter({ url, maxLength: max_length });
+      const ctx = stampFreshness(result, { url, maxLength: max_length }, "google_scholar");
+      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+  }
+);
+
+// ─── 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.",
+    inputSchema: z.object({
+      url: z.string().url().describe("HN URL e.g. https://news.ycombinator.com or https://hn.algolia.com/?q=..."),
+      max_length: z.number().optional().default(4000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  async ({ url, max_length }) => {
+    try {
+      const result = await hackerNewsAdapter({ url, maxLength: max_length });
+      const ctx = stampFreshness(result, { url, maxLength: max_length }, "hackernews");
+      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+  }
+);
+
+// ─── Tool: extract_yc ──────────────────────────────────────────────────────────
+server.registerTool(
+  "extract_yc",
+  {
+    description:
+      "Scrape YC company listings. Use https://www.ycombinator.com/companies?query=KEYWORD to find startups in a space. Returns name, batch, tags, description per company with freshness timestamp.",
+    inputSchema: z.object({
+      url: z.string().url().describe("YC companies URL e.g. https://www.ycombinator.com/companies?query=mcp"),
+      max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  async ({ url, max_length }) => {
+    try {
+      const result = await ycAdapter({ url, maxLength: max_length });
+      const ctx = stampFreshness(result, { url, maxLength: max_length }, "ycombinator");
+      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+  }
+);
+
+// ─── Tool: search_repos ──────────────────────────────────────────────────────
+server.registerTool(
+  "search_repos",
+  {
+    description:
+      "Search GitHub for repositories matching a keyword or topic. Returns top results by stars with activity signals. Use to find competitors, similar tools, or related projects.",
+    inputSchema: z.object({
+      query: z.string().describe("Search query e.g. 'mcp server typescript' or 'cashflow prediction python'"),
+      max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  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");
+      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+  }
+);
+
+// ─── Tool: package_trends ────────────────────────────────────────────────────
+server.registerTool(
+  "package_trends",
+  {
+    description:
+      "Look up npm and PyPI package metadata — version history, release cadence, last updated. Use to gauge ecosystem activity around a tool or dependency. Supports comma-separated list of packages.",
+    inputSchema: z.object({
+      packages: z.string().describe("Package name(s) e.g. 'langchain' or 'npm:zod,pypi:fastapi'"),
+      max_length: z.number().optional().default(5000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  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");
+      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+  }
+);
+
+// ─── Tool: extract_landscape ─────────────────────────────────────────────────
+server.registerTool(
+  "extract_landscape",
+  {
+    description:
+      "Composite intelligence tool. Given a project idea or keyword, simultaneously queries YC startups, GitHub repos, HN sentiment, and package activity to answer: Who is building this? Is it funded? What's getting traction? Returns a unified timestamped landscape report.",
+    inputSchema: z.object({
+      topic: z.string().describe("Your project idea or keyword e.g. 'mcp server' or 'cashflow prediction'"),
+      max_length: z.number().optional().default(8000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+  },
+  async ({ topic, max_length }) => {
+    const perSection = Math.floor((max_length ?? 8000) / 4);
+
+    const [ycResult, repoResult, hnResult, pkgResult] = await Promise.allSettled([
+      ycAdapter({ url: `https://www.ycombinator.com/companies?query=${encodeURIComponent(topic)}`, maxLength: perSection }),
+      repoSearchAdapter({ url: topic, maxLength: perSection }),
+      hackerNewsAdapter({ url: `https://hn.algolia.com/api/v1/search?query=${encodeURIComponent(topic)}&tags=story&hitsPerPage=15`, maxLength: perSection }),
+      packageTrendsAdapter({ url: topic, maxLength: perSection }),
+    ]);
+
+    const section = (label: string, result: PromiseSettledResult<{ raw: string; content_date: string | null; freshness_confidence: string }>) =>
+      result.status === "fulfilled"
+        ? `## ${label}\n${result.value.raw}`
+        : `## ${label}\n[Error: ${(result as PromiseRejectedResult).reason}]`;
+
+    const combined = [
+      `# Landscape Report: "${topic}"`,
+      `Generated: ${new Date().toISOString()}`,
+      "",
+      section("🚀 YC Startups in this space", ycResult),
+      section("📦 Top GitHub repos", repoResult),
+      section("💬 HN sentiment (last month)", hnResult),
+      section("📊 Package ecosystem", pkgResult),
+    ].join("\n\n");
+
+    return { content: [{ type: "text", text: combined }] };
+  }
+);
+
+// ─── Start ───────────────────────────────────────────────────────────────────
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("freshcontext-mcp running on stdio");
+}
+
+main().catch(console.error);