freshcontext-mcp 0.3.12 → 0.3.14

package/.actor/Dockerfile

@@ -1,16 +1,16 @@
-FROM apify/actor-node:20
+FROM apify/actor-node-playwright-chrome:20
 
 # Copy package files first for better Docker layer caching
 COPY package*.json ./
 
-# Install all dependencies including apify SDK
+# Install dependencies — Playwright and Chromium already in base image
 RUN npm install --include=dev
 
 # Copy source and pre-built dist
 COPY . ./
 
-# Rebuild TypeScript (dist/ from repo is fallback if this fails)
+# Rebuild TypeScript
 RUN npm run build || echo "Build had warnings, using pre-compiled dist/"
 
-# Tell Apify to run the Actor entry point, not the MCP server
+# Run the Actor entry point
 CMD ["node", "dist/apify.js"]

package/README.md

@@ -30,7 +30,7 @@ Claude now knows the difference between something from this morning and somethin
 
 ---
 
-## 13 tools. No API keys.
+## 19 tools. No API keys.
 
 ### Intelligence
 | Tool | What it gets you |
@@ -52,22 +52,51 @@ Claude now knows the difference between something from this morning and somethin
 ### Market data
 | Tool | What it gets you |
 |---|---|
-| `extract_finance` | Live stock data — price, market cap, P/E, 52w range |
+| `extract_finance` | Live stock data — price, market cap, P/E, 52w range. Up to 5 tickers. |
+| `search_jobs` | Remote job listings from Remotive + HN "Who is Hiring" — every listing dated |
+
+### Composites — multiple sources, one call
+| Tool | Sources | What it gets you |
+|---|---|---|
+| `extract_landscape` | 6 | YC + GitHub + HN + Reddit + Product Hunt + npm in parallel |
+| `extract_gov_landscape` | 4 | Gov contracts + HN + GitHub repos + changelog |
+| `extract_finance_landscape` | 5 | Finance + HN + Reddit + GitHub + changelog |
+| `extract_company_landscape` | 5 | **The full picture on any company** — see below |
+
+### Unique — not available in any other MCP server
+| Tool | Source | What it gets you |
+|---|---|---|
+| `extract_changelog` | GitHub Releases API / npm / auto-discover | Update history from any repo, package, or website |
+| `extract_govcontracts` | USASpending.gov | US federal contract awards — company, amount, agency, period |
+| `extract_sec_filings` | SEC EDGAR | 8-K filings — legally mandated material event disclosures |
+| `extract_gdelt` | GDELT Project | Global news intelligence — 100+ languages, every country, 15-min updates |
+| `extract_gebiz` | data.gov.sg | Singapore Government procurement tenders — open dataset, no auth |
 
-### Composite
-| Tool | What it gets you |
-|---|---|
-| `extract_landscape` | One call. YC + GitHub + HN + Reddit + Product Hunt + npm in parallel. Full timestamped picture. |
+---
 
-### Update intelligence — unique to FreshContext
-| Tool | What it gets you |
-|---|---|
-| `extract_changelog` | Update history from any GitHub repo, npm package, or website. Accepts a GitHub URL (uses the Releases API), an npm package name, or any website URL — auto-discovers `/changelog`, `/releases`, and `CHANGELOG.md`. Returns version numbers, release dates, and entry content, all timestamped. Use this to check if a dependency is still actively maintained, or to find out exactly when a feature shipped before referencing it. |
+## extract_company_landscape
 
-### Government intelligence — unique to FreshContext
-| Tool | What it gets you |
-|---|---|
-| `extract_govcontracts` | US federal contract awards pulled live from USASpending.gov — the official US Treasury database, updated daily. Search by company name, keyword, or NAICS code. Returns award amounts, awarding agency, period of performance, and contract description, all timestamped. A company that just won a $10M DoD contract is actively hiring and spending — that is a buying intent signal no other MCP server surfaces. |
+The most complete single-call company analysis available in any MCP server. Five sources fired in parallel:
+
+1. **SEC EDGAR** — what did they legally just disclose (8-K filings)
+2. **USASpending.gov** — who is giving them government money
+3. **GDELT** — what is global news saying right now
+4. **Changelog** — are they actually shipping product
+5. **Yahoo Finance** — what is the market pricing in
+
+```
+Use extract_company_landscape with company "Palantir" and ticker "PLTR"
+```
+
+Real output from March 26, 2026:
+
+> **Q4 2025:** Revenue $1.407B (+70% YoY). US commercial +137%. Rule of 40 score: **127%**.
+> **Federal contracts:** $292.7M Army Maven Smart System · $252.5M CDAO · $145M ICE · $130M Air Force · more
+> **SEC filing:** Q4 earnings 8-K filed Feb 3, 2026 — GAAP net income $609M, 43% margin
+> **GDELT:** ICE/Medicaid data controversy, UK MoD security warning, NHS opposition — all timestamped
+> **PLTR:** ~$154–157 · Market cap ~$370B · P/E 244x · 52w range $66 → $207
+
+Bloomberg Terminal doesn't read commit history as a company health signal. This does.
 
 ---
 
@@ -160,17 +189,35 @@ Use extract_landscape with topic "cashflow prediction saas"
 ```
 Returns who's funded, what's trending, what repos exist, what packages are moving — all timestamped.
 
-**What's the community actually saying right now?**
+**Full company intelligence in one call:**
 ```
-Use extract_reddit on r/MachineLearning
-Use extract_hackernews to search "mcp server 2026"
+Use extract_company_landscape with company "Palantir" and ticker "PLTR"
+```
+SEC filings + federal contracts + global news + changelog + market data. The complete picture.
+
+**What's Singapore's government procuring right now?**
+```
+Use extract_gebiz with url "artificial intelligence"
+```
+Returns live tenders from the Ministry of Finance open dataset — agency, amount, closing date, all timestamped.
+
+**Did that company just disclose something material?**
+```
+Use extract_sec_filings with url "Palantir Technologies"
 ```
+8-K filings are legally mandated within 4 business days of any material event — CEO change, acquisition, breach, major contract.
 
-**Did that company actually ship recently?**
+**What is global news saying about a company?**
+```
+Use extract_gdelt with url "Palantir"
+```
+100+ languages, every country, updated every 15 minutes. Surfaces what Western sources miss.
+
+**What's the community actually saying right now?**
 ```
-Use extract_github on https://github.com/some-org/some-repo
+Use extract_reddit on r/MachineLearning
+Use extract_hackernews to search "mcp server 2026"
 ```
-Check `Published` vs `Retrieved`. If the gap is 18 months, Claude will tell you.
 
 **Is this dependency still actively maintained?**
 ```
@@ -182,7 +229,7 @@ Returns the last 8 releases with exact dates. If the last release was 18 months
 ```
 Use extract_govcontracts with url "artificial intelligence"
 ```
-Returns the largest recent federal contract awards matching that keyword — company name, amount, agency, and award date. Pure buying intent signal.
+Largest recent federal contract awards matching that keyword — company, amount, agency, award date.
 
 ---
 
@@ -195,10 +242,15 @@ freshcontext treats **retrieval time as first-class metadata**. Every adapter re
 - `retrieved_at` — exact ISO timestamp of the fetch
 - `content_date` — best estimate of when the content was originally published
 - `freshness_confidence` — `high`, `medium`, or `low` based on signal quality
+- `freshness_score` — numeric 0–100 score with domain-specific decay rates
 - `adapter` — which source the data came from
 
 When confidence is `high`, the date came from a structured field (API, metadata). When it's `medium` or `low`, freshcontext tells you why.
 
+The FreshContext Specification v1.0 is published as an open standard under MIT license. Any tool or agent that wraps retrieved data in the `[FRESHCONTEXT]` envelope is FreshContext-compatible.
+
+→ [Read the spec](./FRESHCONTEXT_SPEC.md)
+
 ---
 
 ## Security
@@ -212,28 +264,41 @@ When confidence is `high`, the date came from a structured field (API, metadata)
 
 ## Roadmap
 
-- [x] GitHub, HN, Scholar, YC, Reddit, Product Hunt, Finance, arXiv adapters
+- [x] GitHub, HN, Scholar, YC, Reddit, Product Hunt, Finance, arXiv, Jobs adapters
 - [x] `extract_landscape` — 6-source composite tool
-- [x] Cloudflare Workers deployment
-- [x] KV-backed global rate limiting
-- [x] Listed on official MCP Registry
 - [x] `extract_changelog` — update cadence from any repo, package, or website
 - [x] `extract_govcontracts` — US federal contract intelligence via USASpending.gov
+- [x] `extract_sec_filings` — SEC EDGAR 8-K material event filings
+- [x] `extract_gdelt` — GDELT global news intelligence (100+ languages)
+- [x] `extract_gebiz` — Singapore Government procurement via data.gov.sg
+- [x] `extract_gov_landscape` — gov contracts + HN + GitHub + changelog composite
+- [x] `extract_finance_landscape` — finance + HN + Reddit + GitHub + changelog composite
+- [x] `extract_company_landscape` — 5-source company intelligence composite
+- [x] `freshness_score` numeric metric (0–100) with domain-specific decay rates
+- [x] Cloudflare Workers deployment — global edge with KV caching
+- [x] D1 database — 18 watched queries running on 6-hour cron
+- [x] Listed on official MCP Registry
 - [x] Listed on Apify Store
 - [x] FreshContext Specification v1.0 published
+- [x] GitHub Actions CI/CD — auto-publish to npm on every push
+- [ ] GKG upgrade for `extract_gdelt` — tone scores, goldstein scale, event codes
 - [ ] TTL-based caching layer
-- [ ] `freshness_score` numeric metric (0–100)
-- [ ] `extract_devto` — developer article sentiment
-- [ ] `extract_npm_releases` — package release velocity
+- [ ] Dashboard — React frontend for the D1 intelligence pipeline
+- [ ] Synthesis endpoint — `/briefing/now` AI-generated intelligence briefings
 
 ---
 
 ## Contributing
 
-PRs welcome. New adapters are the highest-value contribution — see `src/adapters/` for the pattern.
+PRs welcome. New adapters are the highest-value contribution — see `src/adapters/` for the pattern and `FRESHCONTEXT_SPEC.md` for the contract any adapter must fulfill.
 
 ---
 
 ## License
 
 MIT
+
+---
+
+*Built by Prince Gabriel — Grootfontein, Namibia 🇳🇦*
+*"The work isn't gone. It's just waiting to be continued."*

package/SESSION_SAVE_V5.md

@@ -0,0 +1,121 @@
+# FreshContext — Session Save V5
+**Date:** 2026-03-27
+**npm:** freshcontext-mcp@0.3.13
+**Tools:** 19 live
+
+---
+
+## What Was Done This Session
+
+- npm tokens renewed: freshcontext-publish + NPM_TOKEN (both renewed, NPM_TOKEN updated in GitHub secrets)
+- GitHub granular token renewed
+- v0.3.13 pushed — extract_gebiz added (Singapore GeBIZ procurement via data.gov.sg)
+- README fully rewritten — 19 tools, company landscape section with PLTR demo, all unique adapters documented
+- GovTech Singapore follow-up sent (delivered on commitment: GeBIZ tool built and live)
+- Palantir follow-up sent (references PLTR company landscape report, $1.1B contracts, Rule of 40 127%)
+- 10 follow-up drafts created in Gmail (PatSnap, Mistral, HF, Klarna, SAP, Moonshot, MiniMax, Apify, Cloudflare, Sea)
+- PLTR company landscape report confirmed working — full intelligence output documented
+- Apify rebuild needed for v0.3.13 (manual trigger required)
+
+---
+
+## Current Tool Count: 19
+
+**Standard (11):** extract_github, extract_hackernews, extract_scholar, extract_arxiv,
+extract_reddit, extract_yc, extract_producthunt, search_repos, package_trends,
+extract_finance, search_jobs
+
+**Composite landscapes (4):**
+- extract_landscape — YC + GitHub + HN + Reddit + Product Hunt + npm
+- extract_gov_landscape — govcontracts + HN + GitHub + changelog
+- extract_finance_landscape — finance + HN + Reddit + GitHub + changelog
+- extract_company_landscape — SEC + govcontracts + GDELT + changelog + finance
+
+**Unique — not in any other MCP server (4 + GeBIZ):**
+- extract_changelog — release history from any repo/package/site
+- extract_govcontracts — US federal contract awards (USASpending.gov)
+- extract_sec_filings — 8-K material event disclosures (SEC EDGAR)
+- extract_gdelt — global news events (GDELT Project, 100+ languages)
+- extract_gebiz — Singapore Government procurement (data.gov.sg) ← NEW
+
+---
+
+## Outreach Status
+
+**Active threads:**
+- GovTech Singapore — delivered GeBIZ tool, awaiting response
+- Palantir — follow-up sent with PLTR company landscape report
+
+**Follow-up drafts sitting in Gmail (10):**
+- PatSnap — contact@patsnap.com
+- Mistral AI — contact@mistral.ai
+- Hugging Face — api-enterprise@huggingface.co
+- Klarna — partnerships@klarna.com
+- SAP Startups — startups@sap.com
+- Moonshot AI — support@moonshot.cn
+- MiniMax — contact@minimax.io
+- Apify / Jan — jan@apify.com
+- Cloudflare Startups — startups@cloudflare.com
+- Sea / Shopee — ir@sea.com
+
+**Bounced — need correct addresses (9):**
+- Revolut — bd@revolut.com + press@revolut.com both dead
+- Zalando — partnerships@zalando.de + tech@zalando.de both dead
+- Celonis — partnerships@celonis.com dead
+- Grab — partnerships@grab.com + developer@grab.com both dead
+- Sea Limited — partnerships@sea.com dead (ir@sea.com delivered but wrong team)
+- Zhipu AI — bd@zhipuai.cn + contact@zhipuai.cn both dead
+- MiniMax — bd@minimaxi.com dead (contact@minimax.io delivered)
+- Moonshot AI — business@moonshot.cn dead (support@moonshot.cn delivered)
+- Apollo — hello@apollo.io dead
+
+**New targets identified (not yet contacted):**
+- IMDA Singapore (Infocomm Media Development Authority)
+- Australian Digital Transformation Agency
+- UK Government Digital Service (GDS)
+- LangChain / LangSmith
+- LlamaIndex
+- CrewAI
+- Vercel AI SDK
+- FactSet
+- Morningstar
+
+**Correct addresses to find for bounced:**
+- Revolut → try partnerships@revolut.com
+- Grab → try business@grab.com
+- Celonis → try hello@celonis.com
+- Apollo.io → try partnerships@apollo.io
+- Zhipu AI → LinkedIn outreach (email dead)
+
+---
+
+## Pending Items
+
+- Send 10 follow-up drafts from Gmail Drafts folder
+- Trigger Apify rebuild for v0.3.13
+- Find correct addresses for 9 bounced companies
+- Contact new targets: IMDA, GDS, LangChain, LlamaIndex, CrewAI, FactSet
+- GKG upgrade for extract_gdelt (tone scores, goldstein scale) — deferred
+- Agnost AI analytics integration — sign up at app.agnost.ai, one line in server.ts
+- Synthesis endpoint (/briefing/now) — needs ANTHROPIC_KEY + $5 credits
+
+---
+
+## Demo Assets
+1. intelligence-report.html — Anthropic/OpenAI/Palantir government intelligence report
+2. PLTR company landscape — Q4 2025 earnings, $1.1B contracts, Rule of 40 127%
+
+Both are best-in-class product demos. Use these in outreach.
+
+---
+
+## Resume Prompt
+"I'm building freshcontext-mcp — 19 tools live at v0.3.13. Last session: built extract_gebiz
+(Singapore GeBIZ), sent GovTech and Palantir follow-ups, drafted 10 follow-up emails.
+Next: send the 10 drafts, fix bounced email addresses, contact new targets.
+See SESSION_SAVE_V5.md."
+
+---
+
+*"The work isn't gone. It's just waiting to be continued."*
+*— Prince Gabriel, Grootfontein, Namibia 🇳🇦*

package/dist/adapters/gdelt.js

@@ -4,8 +4,8 @@
  * No other MCP server has this. GDELT monitors broadcast, print, and web news
  * from every country in 100+ languages, updated every 15 minutes. Free, no auth.
  *
- * Returns structured geopolitical intelligence — not just headlines, but event codes,
- * actor tags, tone scores, goldstein scale (impact measure), location, timestamp.
+ * Returns structured global news articles with source country, language, domain, and
+ * timestamp. Covers every country, 100+ languages, updated every 15 minutes.
  *
  * API: https://api.gdeltproject.org/api/v2/doc/doc
  */

package/dist/adapters/gebiz.js

@@ -0,0 +1,139 @@
+/**
+ * GeBIZ adapter — fetches Singapore Government procurement opportunities
+ * from data.gov.sg (Ministry of Finance official open dataset)
+ *
+ * No other MCP server has this. GeBIZ is Singapore's One-Stop E-Procurement
+ * Portal. All open tenders from government agencies since FY2020 are published
+ * here as structured open data.
+ *
+ * Free, no auth, updated continuously.
+ *
+ * API: https://data.gov.sg/api/action/datastore_search
+ * Dataset: d_acde1106003906a75c3fa052592f2fcb
+ *
+ * Accepts:
+ *   - Keyword search: "AI", "software", "data analytics"
+ *   - Agency name: "GovTech", "MOH", "MAS"
+ *   - Empty string: returns latest tenders across all agencies
+ */
+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",
+};
+function formatDate(raw) {
+    if (!raw)
+        return "N/A";
+    // Dates come as DD/MM/YYYY or ISO
+    return raw.slice(0, 10);
+}
+function formatAmt(raw) {
+    if (!raw || raw === "NA" || raw === "")
+        return "N/A";
+    const n = parseFloat(raw.replace(/[^0-9.]/g, ""));
+    if (isNaN(n))
+        return raw;
+    if (n >= 1_000_000)
+        return `S$${(n / 1_000_000).toFixed(2)}M`;
+    if (n >= 1_000)
+        return `S$${(n / 1_000).toFixed(1)}K`;
+    return `S$${n.toFixed(0)}`;
+}
+async function fetchGeBIZ(query, limit = 15) {
+    const params = new URLSearchParams({
+        resource_id: DATASET_ID,
+        limit: String(limit),
+        sort: "_id desc", // most recent first
+    });
+    // Add full-text search if query provided
+    if (query.trim()) {
+        params.set("q", query.trim());
+    }
+    const url = `${BASE_URL}?${params}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 20000);
+    try {
+        const res = await fetch(url, {
+            headers: HEADERS,
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`GeBIZ API HTTP ${res.status}: ${text.slice(0, 200)}`);
+        }
+        return await res.json();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function formatRecords(data, query, maxLength) {
+    const records = data.result?.records ?? [];
+    const total = data.result?.total ?? 0;
+    if (!records.length) {
+        return {
+            raw: `No GeBIZ tenders found for "${query}".\n\nTips:\n- Try a broader keyword: "software" or "data"\n- Try an agency name: "GovTech" or "MOH"\n- Leave query empty to see all recent tenders`,
+            content_date: null,
+            freshness_confidence: "high",
+        };
+    }
+    const lines = [
+        `GeBIZ Singapore Government Procurement — ${query || "All Recent Tenders"}`,
+        `${total.toLocaleString()} total records found (showing ${records.length})`,
+        `Source: data.gov.sg — Ministry of Finance open dataset`,
+        "",
+    ];
+    let latestDate = null;
+    records.forEach((r, i) => {
+        const awardDate = formatDate(r.awarded_date);
+        const closeDate = formatDate(r.tender_close_date);
+        const dateStr = r.awarded_date ?? r.tender_close_date ?? null;
+        if (dateStr && dateStr !== "NA") {
+            // Parse DD/MM/YYYY
+            const parts = dateStr.split("/");
+            let iso = null;
+            if (parts.length === 3) {
+                iso = `${parts[2]}-${parts[1]}-${parts[0]}`;
+            }
+            else if (dateStr.length >= 10) {
+                iso = dateStr.slice(0, 10);
+            }
+            if (iso && (!latestDate || iso > latestDate))
+                latestDate = iso;
+        }
+        const desc = (r.description ?? "No description").slice(0, 300);
+        const agency = r.agency ?? "N/A";
+        const tenderNo = r.tender_no ?? "N/A";
+        const status = r.tender_detail_status ?? "N/A";
+        const category = r.procurement_category ?? "N/A";
+        const supplier = r.supplier_name ?? "N/A";
+        const amount = formatAmt(r.awarded_amt);
+        lines.push(`[${i + 1}] ${desc}`);
+        lines.push(`    Agency:     ${agency}`);
+        lines.push(`    Tender No:  ${tenderNo}`);
+        lines.push(`    Category:   ${category}`);
+        lines.push(`    Status:     ${status}`);
+        if (supplier !== "N/A")
+            lines.push(`    Supplier:   ${supplier}`);
+        if (amount !== "N/A")
+            lines.push(`    Amount:     ${amount}`);
+        lines.push(`    Close Date: ${closeDate}`);
+        if (awardDate !== "N/A")
+            lines.push(`    Awarded:    ${awardDate}`);
+        lines.push("");
+    });
+    lines.push(`Full dataset: https://data.gov.sg/datasets/d_acde1106003906a75c3fa052592f2fcb/view`);
+    lines.push(`Register as supplier: https://www.gebiz.gov.sg/cmw/content/getstart.html`);
+    return {
+        raw: lines.join("\n").slice(0, maxLength),
+        content_date: latestDate,
+        freshness_confidence: "high",
+    };
+}
+export async function gebizAdapter(options) {
+    const query = (options.url ?? "").trim();
+    const maxLength = options.maxLength ?? 6000;
+    const data = await fetchGeBIZ(query);
+    return formatRecords(data, query, maxLength);
+}

package/dist/apify.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * Apify Actor entry point — FreshContext MCP v0.3.13
+ *
+ * Reads Actor input, calls the appropriate adapter, pushes to dataset, exits.
+ * All 19 tools supported. Robust error handling throughout.
+ */
+import { Actor } from "apify";
+import { githubAdapter } from "./adapters/github.js";
+import { hackerNewsAdapter } from "./adapters/hackernews.js";
+import { scholarAdapter } from "./adapters/scholar.js";
+import { arxivAdapter } from "./adapters/arxiv.js";
+import { redditAdapter } from "./adapters/reddit.js";
+import { ycAdapter } from "./adapters/yc.js";
+import { productHuntAdapter } from "./adapters/productHunt.js";
+import { repoSearchAdapter } from "./adapters/repoSearch.js";
+import { packageTrendsAdapter } from "./adapters/packageTrends.js";
+import { financeAdapter } from "./adapters/finance.js";
+import { jobsAdapter } from "./adapters/jobs.js";
+import { changelogAdapter } from "./adapters/changelog.js";
+import { govContractsAdapter } from "./adapters/govcontracts.js";
+import { secFilingsAdapter } from "./adapters/secFilings.js";
+import { gdeltAdapter } from "./adapters/gdelt.js";
+import { gebizAdapter } from "./adapters/gebiz.js";
+import { stampFreshness } from "./tools/freshnessStamp.js";
+async function main() {
+    await Actor.init();
+    let input;
+    try {
+        const raw = await Actor.getInput();
+        if (!raw || !raw.tool) {
+            await Actor.fail("Missing input. Provide a 'tool' field. E.g. { \"tool\": \"extract_hackernews\", \"url\": \"https://news.ycombinator.com\" }");
+            return;
+        }
+        input = raw;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        await Actor.fail(`Failed to read input: ${msg}`);
+        return;
+    }
+    // Resolve the primary string input — different tools use different field names
+    const url = input.url ?? input.query ?? input.topic ?? input.company ?? input.tickers ?? "";
+    const maxLength = input.max_length ?? 8000;
+    console.log(`FreshContext Actor | tool: ${input.tool} | input: "${url}"`);
+    try {
+        let result;
+        switch (input.tool) {
+            // ── Standard tools ────────────────────────────────────────────
+            case "extract_github":
+                result = await githubAdapter({ url, maxLength });
+                break;
+            case "extract_hackernews":
+                result = await hackerNewsAdapter({ url, maxLength });
+                break;
+            case "extract_scholar":
+                result = await scholarAdapter({ url, maxLength });
+                break;
+            case "extract_arxiv":
+                result = await arxivAdapter({ url, maxLength });
+                break;
+            case "extract_reddit":
+                result = await redditAdapter({ url, maxLength });
+                break;
+            case "extract_yc":
+                result = await ycAdapter({ url, maxLength });
+                break;
+            case "extract_producthunt":
+                result = await productHuntAdapter({ url, maxLength });
+                break;
+            case "search_repos":
+                result = await repoSearchAdapter({ url, maxLength });
+                break;
+            case "package_trends":
+                result = await packageTrendsAdapter({ url, maxLength });
+                break;
+            case "extract_finance":
+                result = await financeAdapter({ url, maxLength });
+                break;
+            case "search_jobs":
+                result = await jobsAdapter({ url, maxLength });
+                break;
+            case "extract_changelog":
+                result = await changelogAdapter({ url, maxLength });
+                break;
+            // ── Unique tools ──────────────────────────────────────────────
+            case "extract_govcontracts":
+                result = await govContractsAdapter({ url, maxLength });
+                break;
+            case "extract_sec_filings":
+                result = await secFilingsAdapter({ url, maxLength });
+                break;
+            case "extract_gdelt":
+                result = await gdeltAdapter({ url, maxLength });
+                break;
+            case "extract_gebiz":
+                result = await gebizAdapter({ url, maxLength });
+                break;
+            default:
+                await Actor.fail(`Unknown tool: "${input.tool}". Valid tools: ` +
+                    "extract_github, extract_hackernews, extract_scholar, extract_arxiv, " +
+                    "extract_reddit, extract_yc, extract_producthunt, search_repos, " +
+                    "package_trends, extract_finance, search_jobs, extract_changelog, " +
+                    "extract_govcontracts, extract_sec_filings, extract_gdelt, extract_gebiz");
+                return;
+        }
+        const ctx = stampFreshness(result, { url, maxLength }, input.tool);
+        await Actor.pushData({
+            tool: ctx.adapter,
+            source_url: ctx.source_url,
+            content: ctx.content,
+            retrieved_at: ctx.retrieved_at,
+            content_date: ctx.content_date ?? null,
+            freshness_confidence: ctx.freshness_confidence,
+        });
+        console.log(`✓ Done | retrieved: ${ctx.retrieved_at} | confidence: ${ctx.freshness_confidence}`);
+        await Actor.exit();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`FreshContext error: ${message}`);
+        await Actor.fail(message);
+    }
+}
+main().catch(async (err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Fatal error: ${message}`);
+    try {
+        await Actor.fail(message);
+    }
+    catch { /* ignore */ }
+    process.exit(1);
+});

package/dist/server.js

@@ -9,12 +9,14 @@ 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 { jobsAdapter } from "./adapters/jobs.js";
 import { changelogAdapter } from "./adapters/changelog.js";
 import { govContractsAdapter } from "./adapters/govcontracts.js";
 import { secFilingsAdapter } from "./adapters/secFilings.js";
 import { gdeltAdapter } from "./adapters/gdelt.js";
+import { gebizAdapter } from "./adapters/gebiz.js";
 import { stampFreshness, formatForLLM } from "./tools/freshnessStamp.js";
 import { formatSecurityError } from "./security.js";
 const server = new McpServer({
@@ -347,7 +349,7 @@ server.registerTool("extract_sec_filings", {
 // codes, actor tags, tone scores, goldstein scale (impact), location, timestamp.
 // Unique: no other MCP server has this.
 server.registerTool("extract_gdelt", {
-    description: "Fetch global news intelligence from the GDELT Project. GDELT monitors broadcast, print, and web news from every country in 100+ languages, updated every 15 minutes. Returns structured articles with source country, language, and publication date. Free, no auth. Pass any company name, topic, or keyword. Unique: not available in any other MCP server.",
+    description: "Fetch global news intelligence from the GDELT Project. GDELT monitors broadcast, print, and web news from every country in 100+ languages, updated every 15 minutes. Returns articles with title, source domain, country of origin, language, and publication date — covering news worldwide that Western sources miss. Free, no auth. Pass any company name, topic, or keyword. Unique: not available in any other MCP server.",
     inputSchema: z.object({
         url: z.string().describe("Query: company name, topic, or keyword e.g. 'Palantir', 'artificial intelligence', 'MCP server'"),
         max_length: z.number().optional().default(6000),
@@ -408,6 +410,87 @@ server.registerTool("extract_company_landscape", {
     ].join("\n\n");
     return { content: [{ type: "text", text: combined }] };
 });
+// ─── Tool: extract_gebiz ────────────────────────────────────────────────────
+// Singapore Government procurement tenders via data.gov.sg open API.
+// Ministry of Finance official dataset — all open tenders since FY2020.
+// Free, no auth, structured. Unique: no other MCP server has this.
+server.registerTool("extract_gebiz", {
+    description: "Fetch Singapore Government procurement opportunities from GeBIZ via the data.gov.sg open API (Ministry of Finance official dataset). Returns open tenders, awarded contracts, agencies, amounts, and closing dates. Search by keyword (e.g. 'software', 'AI', 'data analytics'), agency name (e.g. 'GovTech', 'MOH'), or leave blank for all recent tenders. Free, no auth. Unique: not available in any other MCP server.",
+    inputSchema: z.object({
+        url: z.string().describe("Search keyword, agency name, or leave empty for all recent tenders. E.g. 'artificial intelligence', 'GovTech', 'cybersecurity'"),
+        max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await gebizAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "gebiz");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_idea_landscape ───────────────────────────────────────────
+// Idea validation composite — 6 sources that answer: should I build this?
+// HN pain points + YC funded competitors + GitHub crowding + job market signal
+// + package ecosystem adoption + Product Hunt recent launches.
+// The job market section is the key differentiator — companies paying salaries
+// around a problem is the strongest signal a real market exists.
+server.registerTool("extract_idea_landscape", {
+    description: "Idea validation composite tool for developers and founders. Given a project idea or keyword, simultaneously queries 6 sources to answer: Is this problem real? Is the market crowded? Is there funding? Are companies hiring? What just launched? Sources: (1) Hacker News — what developers are actively complaining about and discussing, (2) YC companies — who has already received funding in this space, (3) GitHub repos — how crowded the open source landscape is, (4) Job listings — hiring signal showing real company spend around this problem, (5) npm/PyPI package trends — ecosystem adoption and velocity, (6) Product Hunt — what just launched and how it was received. Returns a unified 6-source idea validation report.",
+    inputSchema: z.object({
+        idea: z.string().describe("Your idea, problem space, or keyword. E.g. 'data freshness for AI agents', 'procurement intelligence', 'developer observability'"),
+        max_length: z.number().optional().default(14000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ idea, max_length }) => {
+    const perSection = Math.floor((max_length ?? 14000) / 6);
+    const [hnResult, ycResult, repoResult, jobsResult, pkgResult, phResult] = await Promise.allSettled([
+        // 1. Pain signal — what are developers actively complaining about
+        hackerNewsAdapter({
+            url: `https://hn.algolia.com/api/v1/search?query=${encodeURIComponent(idea)}&tags=story&hitsPerPage=10`,
+            maxLength: perSection,
+        }),
+        // 2. Funding signal — who has already raised money in this space
+        ycAdapter({
+            url: `https://www.ycombinator.com/companies?query=${encodeURIComponent(idea)}`,
+            maxLength: perSection,
+        }),
+        // 3. Crowding signal — how many GitHub repos exist, how active
+        repoSearchAdapter({ url: idea, maxLength: perSection }),
+        // 4. Market signal — companies paying salaries = real spend on this problem
+        jobsAdapter({ url: idea, maxLength: perSection }),
+        // 5. Ecosystem signal — npm/PyPI adoption and release velocity
+        packageTrendsAdapter({ url: idea, maxLength: perSection }),
+        // 6. Launch signal — what just shipped and how the market received it
+        productHuntAdapter({ url: idea, maxLength: perSection }),
+    ]);
+    const section = (label, result) => result.status === "fulfilled"
+        ? `## ${label}\n${result.value.raw}`
+        : `## ${label}\n[Unavailable: ${result.reason}]`;
+    const combined = [
+        `# Idea Validation Landscape: "${idea}"`,
+        `Generated: ${new Date().toISOString()}`,
+        `Sources: Hacker News · YC Companies · GitHub · Job Listings · npm/PyPI · Product Hunt`,
+        "",
+        `## ℹ️ How to read this report`,
+        `Pain signal (HN): Are developers actively discussing this problem?`,
+        `Funding signal (YC): Has this already attracted institutional money?`,
+        `Crowding signal (GitHub): How many repos exist — empty = opportunity, crowded = validation.`,
+        `Market signal (Jobs): Companies hiring around this = real budget allocated = real market.`,
+        `Ecosystem signal (npm/PyPI): Are packages being built and adopted?`,
+        `Launch signal (Product Hunt): What just shipped — community reception and timing.`,
+        "",
+        section("🗣️ Pain Signal — Developer Discussions (Hacker News)", hnResult),
+        section("💰 Funding Signal — Backed Companies (YC)", ycResult),
+        section("📦 Crowding Signal — Open Source Landscape (GitHub)", repoResult),
+        section("💼 Market Signal — Hiring Activity (Job Listings)", jobsResult),
+        section("🔧 Ecosystem Signal — Package Adoption (npm/PyPI)", pkgResult),
+        section("🚀 Launch Signal — Recent Launches (Product Hunt)", phResult),
+    ].join("\n\n");
+    return { content: [{ type: "text", text: combined }] };
+});
 // ─── Start ───────────────────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/input_schema.json

@@ -1,45 +1,44 @@
 {
-  "title": "FreshContext MCP Input",
+  "title": "FreshContext Input",
   "type": "object",
   "schemaVersion": 1,
   "properties": {
     "tool": {
       "title": "Tool",
       "type": "string",
-      "description": "The FreshContext tool to run.",
+      "description": "The FreshContext tool to run. See README for full descriptions.",
       "enum": [
-        "extract_github",
         "extract_hackernews",
-        "extract_scholar",
+        "extract_github",
+        "extract_govcontracts",
+        "extract_sec_filings",
+        "extract_gdelt",
+        "extract_gebiz",
+        "extract_finance",
+        "extract_changelog",
         "extract_arxiv",
+        "extract_scholar",
         "extract_reddit",
         "extract_yc",
         "extract_producthunt",
         "search_repos",
         "package_trends",
-        "extract_finance",
-        "extract_landscape"
+        "search_jobs"
       ],
-      "default": "extract_landscape",
+      "default": "extract_hackernews",
       "editor": "select"
     },
     "url": {
-      "title": "URL",
-      "type": "string",
-      "description": "URL to extract from. Required for: extract_github, extract_hackernews, extract_scholar, extract_reddit. E.g. https://github.com/owner/repo",
-      "editor": "textfield"
-    },
-    "query": {
-      "title": "Query",
+      "title": "URL or Query",
       "type": "string",
-      "description": "Search query. Required for: extract_landscape, search_repos, extract_yc, extract_producthunt, package_trends, extract_finance.",
+      "description": "The main input for the tool. For extract_github: full GitHub URL. For extract_hackernews: HN URL or search URL. For extract_govcontracts/extract_sec_filings/extract_gdelt/extract_gebiz/extract_finance: company name, keyword, or ticker. For search_repos/package_trends/search_jobs: search keyword.",
       "editor": "textfield"
     },
     "max_length": {
       "title": "Max content length",
       "type": "integer",
-      "description": "Maximum characters returned per result. Default: 6000.",
-      "default": 6000,
+      "description": "Maximum characters returned. Default: 8000.",
+      "default": 8000,
       "minimum": 500,
       "maximum": 20000,
       "editor": "number"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "freshcontext-mcp",
   "mcpName": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Real-time web extraction MCP server with freshness timestamps for AI agents",
   "keywords": [
     "mcp",