freshcontext-mcp 0.3.11 → 0.3.12

package/.actor/Dockerfile

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

package/HANDOFF.md

@@ -0,0 +1,184 @@
+# FreshContext — Handoff Document
+**Version:** 0.3.11
+**Date:** 2026-03-20
+**Author:** Immanuel Gabriel (Prince Gabriel), Grootfontein, Namibia
+**Contact:** gimmanuel73@gmail.com
+
+---
+
+## What You Are Receiving
+
+FreshContext is a web intelligence engine for AI agents. It wraps every piece of
+retrieved web data in a structured freshness envelope — exact retrieval timestamp,
+publication date estimate, freshness confidence (high/medium/low), and a 0-100
+numeric score with domain-specific decay rates.
+
+15 tools. No API keys required. Deployed globally on Cloudflare's edge. Listed on
+Anthropic's official MCP Registry, npm, and Apify Store.
+
+The two tools that exist nowhere else: extract_govcontracts (US federal contract
+intelligence via USASpending.gov) and extract_changelog (product release velocity
+from any GitHub repo, npm package, or website).
+
+---
+
+## Services and Infrastructure
+
+### 1. GitHub Repository
+URL: https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
+Branch: main
+Transfer method: GitHub Settings > Transfer ownership
+What it contains: All source code, Dockerfile, specs, session saves, roadmap
+
+### 2. npm Package
+Package: freshcontext-mcp (v0.3.11)
+URL: https://www.npmjs.com/package/freshcontext-mcp
+Account: immanuel-gabriel on npmjs.com
+Transfer method: npm owner add new-username freshcontext-mcp
+Note: Published automatically via GitHub Actions on every push to main
+
+### 3. Cloudflare Account
+What lives here:
+  Worker:     freshcontext-mcp (the live MCP endpoint)
+  D1:         freshcontext-db (ID: d9898d65-f67e-4dcb-abdc-7f7b53f2d444)
+  KV:         RATE_LIMITER and CACHE (IDs in wrangler.jsonc)
+  Cron:       0 */6 * * * (every 6 hours, runs automatically)
+  Endpoint:   https://freshcontext-mcp.gimmanuel73.workers.dev/mcp
+
+Transfer method: Add new account as Super Administrator, remove original.
+D1 export: wrangler d1 export freshcontext-db --output=dump.sql
+
+### 4. Apify Actor
+Actor:        prince_gabriel/freshcontext-mcp
+URL:          https://apify.com/prince_gabriel/freshcontext-mcp
+Monetization: $50.00 per 1,000 results (Pay per event)
+Transfer method: Re-publish under new Apify account
+
+### 5. MCP Registry Listing
+Entry:  io.github.PrinceGabriel-lgtm/freshcontext
+Config: server.json in the GitHub repo
+Transfer method: Update server.json with new repo URL and re-submit
+
+### 6. GitHub Actions CI/CD
+File:   .github/workflows/publish.yml
+Action: On every push to main — npm ci > tsc > npm publish
+Secret: NPM_TOKEN (granular access token from npmjs.com, renew annually)
+
+---
+
+## Credentials Map (categories only — not values)
+
+| Credential | Where Used | Location |
+|---|---|---|
+| API_KEY | Worker auth header | Cloudflare env var |
+| ANTHROPIC_KEY | Synthesis/briefing endpoint | Cloudflare env var |
+| GITHUB_TOKEN | GitHub API rate limit bypass | Cloudflare env var |
+| NPM_TOKEN | GitHub Actions auto-publish | GitHub secret |
+
+---
+
+## Codebase Map
+
+src/server.ts          — MCP stdio server, all 15 tools registered here
+src/apify.ts           — Apify Actor entry point (read input, call adapter, exit)
+src/security.ts        — URL validation, SSRF prevention
+src/types.ts           — FreshContext, AdapterResult, ExtractOptions interfaces
+src/adapters/          — One file per data source (13 files)
+  changelog.ts         — UNIQUE: GitHub Releases API + npm + auto-discover
+  govcontracts.ts      — UNIQUE: USASpending.gov federal contract awards
+src/tools/
+  freshnessStamp.ts    — Score calculation, JSON form, text envelope
+worker/src/worker.ts   — Cloudflare Worker: 15 tools + KV cache + rate limit
+                         + D1 cron scraper + briefing formatter
+.actor/Dockerfile      — Apify build config (Node 20, runs dist/apify.js)
+.actor/actor.json      — Apify Actor metadata
+FRESHCONTEXT_SPEC.md   — The open standard (MIT license)
+ROADMAP.md             — 10-layer product vision
+server.json            — MCP Registry listing
+.github/workflows/
+  publish.yml          — GitHub Actions CI/CD
+
+---
+
+## The 15 Tools
+
+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 (3):
+  extract_landscape      — YC + GitHub + HN + Reddit + Product Hunt + npm
+  extract_gov_landscape  — govcontracts + HN + GitHub + changelog
+  extract_finance_landscape — finance + HN + Reddit + GitHub + changelog
+
+Unique — not in any other MCP server (2):
+  extract_changelog    — release history from any repo, package, or website
+  extract_govcontracts — US federal contract awards from USASpending.gov
+
+---
+
+## D1 Database Schema
+
+watched_queries  — 18 active monitored topics
+  id, adapter, query, label, filters, enabled, last_run_at
+
+scrape_results   — raw results, deduplicated by content hash
+  id, watched_query_id, adapter, query, raw_content, result_hash, is_new, scraped_at
+
+briefings        — formatted intelligence reports per cron run
+  id, user_id, summary, new_results_count, adapters_run, created_at
+
+user_profiles    — personalization data for briefing synthesis
+  id, name, skills, certifications, targets, location, context
+
+---
+
+## The FreshContext Specification
+
+FRESHCONTEXT_SPEC.md is the open standard, MIT license, authored March 2026.
+Any implementation returning the [FRESHCONTEXT]...[/FRESHCONTEXT] envelope
+or the structured JSON form with freshcontext.retrieved_at and
+freshcontext.freshness_confidence is FreshContext-compatible.
+
+The spec is the durable asset. The code is the reference implementation.
+
+---
+
+## What Keeps Running Without You
+
+The Cloudflare cron fires every 6 hours automatically. Every run scrapes all 18
+watched queries, deduplicates by content hash, stores new signals in D1, and
+generates a briefing. The dataset accumulates indefinitely. No action required.
+
+---
+
+## Pending Items at Time of Handoff
+
+Apify Playwright — extract_reddit, extract_yc, extract_producthunt may error on
+Apify. Fix: add RUN npx playwright install chromium --with-deps to .actor/Dockerfile.
+
+Synthesis endpoint — /briefing/now is paused. Needs ANTHROPIC_KEY in Worker env
+and credits loaded at console.anthropic.com. Infrastructure is fully built.
+
+Agnost AI analytics — free MCP analytics offered by Apify. Sign up at app.agnost.ai,
+add one line to server.ts. Gives tool call tracking and usage dashboards.
+
+Apify GitHub Actions trigger — npm publish is automated but Apify rebuild is
+manual. Add a workflow step calling Apify's API to auto-rebuild on push.
+
+---
+
+## Outreach Status at Time of Handoff
+
+19 confirmed delivered emails across US, Singapore, China, and Europe.
+Cloudflare for Startups — awaiting reply (10 business day window).
+GovTech Singapore — auto-acknowledged, reply expected by March 25, 2026.
+All others — first contact sent, no replies yet.
+
+HN post live: https://news.ycombinator.com/user?id=Prince-Gabriel
+
+---
+
+*"The work isn't gone. It's just waiting to be continued."*
+*— Prince Gabriel, Grootfontein, Namibia*

package/SESSION_SAVE_V4.md

@@ -0,0 +1,60 @@
+# FreshContext — Session Save V4
+**Date:** 2026-03-20
+**npm:** freshcontext-mcp@0.3.11
+**Tools:** 15 live → building to 18
+
+---
+
+## What Was Done This Session
+
+- Apify Actor fixed: Node 20 base image, clean build confirmed
+- HANDOFF.md created and pushed
+- Command reference HTML updated with example output section
+- Intelligence report (Anthropic/OpenAI/Palantir) confirmed as best product demo asset
+- SESSION_SAVE_V3.md written
+- Strategic discussion: keep the niche, deepen it — spec adoption > more tools
+- Identified two new unique adapters: extract_sec_filings + extract_gdelt
+- Composite: extract_company_landscape (5 sources: SEC + govcontracts + GDELT + changelog + finance)
+
+---
+
+## Next Build — NOW IN PROGRESS
+
+### extract_sec_filings
+Source: SEC EDGAR full-text search (efts.sec.gov/LATEST/search-index)
+No auth. Free. Real-time.
+Returns: 8-K filings — legally mandated material event disclosures
+CEO changes, major contracts, acquisitions, breaches, regulatory actions
+File: src/adapters/secFilings.ts
+
+### extract_gdelt
+Source: GDELT Project (api.gdeltproject.org/api/v2/doc/doc)
+No auth. Free. Updated every 15 minutes.
+Returns: Structured global news events with tone, goldstein scale, actor tags
+File: src/adapters/gdelt.ts
+
+### extract_company_landscape (composite)
+5 sources in parallel:
+  1. extract_sec_filings — legal disclosures
+  2. extract_govcontracts — federal contract footprint
+  3. extract_gdelt — global news events
+  4. extract_changelog — shipping velocity
+  5. extract_finance — market pricing
+File: register in src/server.ts
+
+---
+
+## Moat Summary (all 4 unique adapters)
+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 structured news events (GDELT Project)
+
+These 4 exist in no other MCP server. All free. All no-auth.
+
+---
+
+## Resume Prompt
+"I'm building freshcontext-mcp. Just built extract_sec_filings and extract_gdelt.
+Need to register them in server.ts and build extract_company_landscape composite.
+See SESSION_SAVE_V4.md."

package/dist/adapters/gdelt.js

@@ -0,0 +1,104 @@
+/**
+ * GDELT adapter — fetches structured global news intelligence from the GDELT Project
+ *
+ * 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.
+ *
+ * API: https://api.gdeltproject.org/api/v2/doc/doc
+ */
+const HEADERS = {
+    "Accept": "application/json",
+    "User-Agent": "freshcontext-mcp/1.0 contact@freshcontext.dev",
+};
+function parseGdeltDate(raw) {
+    if (!raw)
+        return null;
+    // Format: 20260320T093000Z → 2026-03-20T09:30:00Z
+    const m = raw.match(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z?$/);
+    if (!m)
+        return null;
+    return `${m[1]}-${m[2]}-${m[3]}T${m[4]}:${m[5]}:${m[6]}Z`;
+}
+async function fetchGdelt(query, maxRecords = 15) {
+    const params = new URLSearchParams({
+        query: query,
+        mode: "artlist",
+        maxrecords: String(maxRecords),
+        format: "json",
+        timespan: "1month",
+        sort: "DateDesc",
+    });
+    const url = `https://api.gdeltproject.org/api/v2/doc/doc?${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(`GDELT HTTP ${res.status}: ${text.slice(0, 200)}`);
+        }
+        const text = await res.text();
+        // GDELT sometimes returns empty body or non-JSON
+        if (!text.trim() || text.trim() === "null") {
+            return { articles: [] };
+        }
+        return JSON.parse(text);
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function formatArticles(data, query, maxLength) {
+    const articles = data.articles ?? [];
+    if (!articles.length) {
+        return {
+            raw: `No GDELT news events found for "${query}" in the last month.\n\nTips:\n- Try a broader keyword: "artificial intelligence" instead of "Claude AI"\n- Try a company name: "Palantir"\n- GDELT covers global news — try in English for best results`,
+            content_date: null,
+            freshness_confidence: "high",
+        };
+    }
+    const lines = [
+        `GDELT Global News Intelligence — ${query}`,
+        `${articles.length} articles from global news sources (last 30 days)`,
+        "",
+    ];
+    let latestDate = null;
+    articles.forEach((article, i) => {
+        const date = parseGdeltDate(article.seendate);
+        const title = (article.title ?? "No title").slice(0, 200);
+        const domain = article.domain ?? "unknown";
+        const country = article.sourcecountry ?? "N/A";
+        const language = article.language ?? "N/A";
+        const url = article.url ?? "";
+        if (date && (!latestDate || date > latestDate))
+            latestDate = date;
+        lines.push(`[${i + 1}] ${title}`);
+        lines.push(`    Source:   ${domain} (${country})`);
+        lines.push(`    Language: ${language}`);
+        lines.push(`    Date:     ${date ?? article.seendate ?? "unknown"}`);
+        if (url)
+            lines.push(`    URL:      ${url.slice(0, 200)}`);
+        lines.push("");
+    });
+    lines.push(`Source: GDELT Project — https://www.gdeltproject.org`);
+    lines.push(`Coverage: 100+ languages, every country, updated every 15 minutes`);
+    return {
+        raw: lines.join("\n").slice(0, maxLength),
+        content_date: latestDate,
+        freshness_confidence: "high",
+    };
+}
+export async function gdeltAdapter(options) {
+    const query = (options.url ?? "").trim();
+    const maxLength = options.maxLength ?? 6000;
+    if (!query)
+        throw new Error("Query required: company name, topic, or keyword");
+    const data = await fetchGdelt(query);
+    return formatArticles(data, query, maxLength);
+}

package/dist/adapters/secFilings.js

@@ -0,0 +1,98 @@
+/**
+ * SEC EDGAR adapter — fetches 8-K filings from the SEC's full-text search API
+ *
+ * No other MCP server has this. 8-K filings are legally mandated disclosures
+ * of material corporate events — CEO changes, acquisitions, data breaches,
+ * major contracts, regulatory actions. Filed within 4 business days of the event.
+ *
+ * This is the most reliable early-warning signal for corporate events in existence.
+ * Free, no auth, updated in real time.
+ *
+ * API: https://efts.sec.gov/LATEST/search-index
+ */
+const HEADERS = {
+    "Accept": "application/json",
+    "User-Agent": "freshcontext-mcp/1.0 contact@freshcontext.dev",
+};
+async function fetchSecFilings(query, maxResults = 10) {
+    const today = new Date().toISOString().slice(0, 10);
+    const oneYearAgo = new Date(Date.now() - 365 * 86400000).toISOString().slice(0, 10);
+    const params = new URLSearchParams({
+        q: `"${query}"`,
+        forms: "8-K",
+        dateRange: "custom",
+        startdt: oneYearAgo,
+        enddt: today,
+        hits: String(maxResults),
+    });
+    const url = `https://efts.sec.gov/LATEST/search-index?${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(`SEC EDGAR HTTP ${res.status}: ${text.slice(0, 200)}`);
+        }
+        return await res.json();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function formatFilings(data, query, maxLength) {
+    const hits = data.hits?.hits ?? [];
+    const total = data.hits?.total?.value ?? 0;
+    if (!hits.length) {
+        return {
+            raw: `No 8-K filings found for "${query}" in the last year.\n\nTips:\n- Try the full legal company name: "Palantir Technologies"\n- Try a ticker-like keyword: "PLTR"\n- 8-K filings are only for public companies`,
+            content_date: null,
+            freshness_confidence: "high",
+        };
+    }
+    const lines = [
+        `SEC 8-K Filings — ${query}`,
+        `${total.toLocaleString()} total filings found (showing ${hits.length})`,
+        "",
+    ];
+    let latestDate = null;
+    hits.forEach((hit, i) => {
+        const src = hit._source ?? {};
+        const entityName = src.entity_name ?? hit.entity_name ?? "Unknown";
+        const fileDate = src.filed_at?.slice(0, 10) ?? hit.file_date ?? "unknown";
+        const period = src.period_of_report?.slice(0, 10) ?? hit.period_of_report ?? "unknown";
+        const formType = src.form_type ?? hit.form_type ?? "8-K";
+        const location = [src.biz_location, src.inc_states].filter(Boolean).join(" / ") || "N/A";
+        const filingId = hit._id ?? "N/A";
+        if (fileDate && fileDate !== "unknown") {
+            if (!latestDate || fileDate > latestDate)
+                latestDate = fileDate;
+        }
+        lines.push(`[${i + 1}] ${entityName}`);
+        lines.push(`    Form:    ${formType}`);
+        lines.push(`    Filed:   ${fileDate}`);
+        lines.push(`    Period:  ${period}`);
+        lines.push(`    Location: ${location}`);
+        lines.push(`    Filing ID: ${filingId}`);
+        lines.push(`    View: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&company=${encodeURIComponent(entityName)}&type=8-K&dateb=&owner=include&count=10`);
+        lines.push("");
+    });
+    lines.push(`Source: SEC EDGAR — https://efts.sec.gov/LATEST/search-index`);
+    lines.push(`Note: 8-K filings are legally mandated disclosures of material events filed within 4 business days.`);
+    return {
+        raw: lines.join("\n").slice(0, maxLength),
+        content_date: latestDate,
+        freshness_confidence: "high",
+    };
+}
+export async function secFilingsAdapter(options) {
+    const query = (options.url ?? "").trim();
+    const maxLength = options.maxLength ?? 6000;
+    if (!query)
+        throw new Error("Company name or keyword required");
+    const data = await fetchSecFilings(query);
+    return formatFilings(data, query, maxLength);
+}

package/dist/server.js

@@ -13,6 +13,8 @@ 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 { stampFreshness, formatForLLM } from "./tools/freshnessStamp.js";
 import { formatSecurityError } from "./security.js";
 const server = new McpServer({
@@ -317,6 +319,95 @@ server.registerTool("extract_finance_landscape", {
     ].join("\n\n");
     return { content: [{ type: "text", text: combined }] };
 });
+// ─── Tool: extract_sec_filings ─────────────────────────────────────────────
+// 8-K filings = legally mandated material event disclosures. CEO changes,
+// acquisitions, breaches, major contracts, regulatory actions — all filed
+// within 4 business days. Most reliable early-warning corporate signal in existence.
+// Unique: no other MCP server has this.
+server.registerTool("extract_sec_filings", {
+    description: "Fetch SEC 8-K filings for any public company from the SEC EDGAR full-text search API. 8-K filings are legally mandated disclosures of material corporate events — CEO changes, acquisitions, data breaches, major contracts, regulatory actions — filed within 4 business days. Free, no auth, real-time. Pass a company name, ticker, or keyword. Unique: not available in any other MCP server.",
+    inputSchema: z.object({
+        url: z.string().describe("Company name, ticker, or keyword e.g. 'Palantir', 'PLTR', 'artificial intelligence'"),
+        max_length: z.number().optional().default(6000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await secFilingsAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "sec_filings");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_gdelt ─────────────────────────────────────────────────────
+// GDELT monitors news from every country in 100+ languages, updated every 15 min.
+// Returns structured global news intelligence — not just headlines but event
+// 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.",
+    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),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ url, max_length }) => {
+    try {
+        const result = await gdeltAdapter({ url, maxLength: max_length });
+        const ctx = stampFreshness(result, { url, maxLength: max_length }, "gdelt");
+        return { content: [{ type: "text", text: formatForLLM(ctx) }] };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: formatSecurityError(err) }] };
+    }
+});
+// ─── Tool: extract_company_landscape ─────────────────────────────────────────
+// The most complete single-call company intelligence available in any MCP server.
+// 5 moat sources: SEC 8-K legal disclosures + federal contract footprint +
+// 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.",
+    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."),
+        github_url: z.string().optional().describe("Optional GitHub repo or org URL e.g. 'https://github.com/palantir'. Improves changelog accuracy."),
+        max_length: z.number().optional().default(15000),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ company, ticker, github_url, max_length }) => {
+    const perSection = Math.floor((max_length ?? 15000) / 5);
+    const repoQuery = github_url ?? company;
+    const [secResult, contractsResult, gdeltResult, changelogResult, financeResult] = await Promise.allSettled([
+        // 1. What did they legally just disclose
+        secFilingsAdapter({ url: company, maxLength: perSection }),
+        // 2. Who is giving them government money
+        govContractsAdapter({ url: company, maxLength: perSection }),
+        // 3. What is global news saying right now
+        gdeltAdapter({ url: company, maxLength: perSection }),
+        // 4. Are they actually shipping product
+        changelogAdapter({ url: repoQuery, maxLength: perSection }),
+        // 5. What is the market pricing in
+        financeAdapter({ url: ticker ?? company, maxLength: perSection }),
+    ]);
+    const section = (label, result) => result.status === "fulfilled"
+        ? `## ${label}\n${result.value.raw}`
+        : `## ${label}\n[Unavailable: ${result.reason}]`;
+    const combined = [
+        `# Company Intelligence Landscape: "${company}"${ticker ? ` (${ticker})` : ""}`,
+        `Generated: ${new Date().toISOString()}`,
+        `Sources: SEC EDGAR · USASpending.gov · GDELT · Changelog · Yahoo Finance`,
+        "",
+        section("📋 SEC 8-K Filings — Legal Disclosures", secResult),
+        section("🏛️ Federal Contract Awards (USASpending.gov)", contractsResult),
+        section("🌍 Global News Intelligence (GDELT)", gdeltResult),
+        section("🔄 Product Release Velocity (Changelog)", changelogResult),
+        section("📈 Market Data (Yahoo Finance)", financeResult),
+    ].join("\n\n");
+    return { content: [{ type: "text", text: combined }] };
+});
 // ─── Start ───────────────────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

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