# FreshContext

> Context integrity for AI agents: evaluate freshness, confidence, provenance, and decision readiness.

- name: io.github.PrinceGabriel-lgtm/freshcontext
- version: 0.5.3
- connection class: R0 (autonomous)
- trust: 97/100
- quality: 74/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.PrinceGabriel-lgtm%2Ffreshcontext
- tools: https://api.protogrid.dev/v1/servers/io.github.PrinceGabriel-lgtm%2Ffreshcontext/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "freshcontext": {
      "type": "http",
      "url": "https://api.freshcontext.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 99
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-97% +updated-24d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 74/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 22 of 22 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: extract_github (destructiveHint, idempotentHint); extract_yc (destructiveHint, idempotentHint); extract_reddit (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 2,843 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 50 (weight 15)

- pass `stability.changes`: 1 tool changes in 30 days
- fail `stability.rug_pull`: 1 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: deps.dev does not know freshcontext-mcp@0.5.3

- tools: 22, about 2,843 tokens to load them all
- tool set hash: 300f6a83cc10909e27cdf83d167fa082
- tools last changed: 2026-09-27T10:49:28.515Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.PrinceGabriel-lgtm/freshcontext.svg)](https://protogrid.dev/servers/io.github.PrinceGabriel-lgtm/freshcontext)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-27 `extract_yc` changed (description, inputSchema, annotations) **meaning changed**
  - before: Scrape YC company listings from a ycombinator.com/companies search URL. Returns name, batch, status, tags, and description per company. Freshness is unknown — YC listings carry no reliable per-company update date.
  - after: Withdrawn in 0.5.3 pending review of source terms. Returns an error; kept so existing clients get a clear answer.

Full history: https://api.protogrid.dev/v1/servers/io.github.PrinceGabriel-lgtm%2Ffreshcontext/changes

## Dependencies

- npm freshcontext-mcp@0.5.3: unknown

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://api.freshcontext.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.973913)

## Packages

- npm freshcontext-mcp@0.5.3

## Tools (22)

- `evaluate_context`: Evaluate caller-provided candidate context and return decision-ready output. This is the primary FreshContext judgment path: it does not fetch, crawl, scrape, browse, read folders, or call adapters.
- `extract_arxiv`: Search arXiv for research papers via the official API. Pass a topic or full arXiv API URL. Returns titles, authors, dates, abstracts.
- `extract_changelog`: Update history for any product. Accepts a GitHub repo URL or an npm package name. Returns version numbers, release dates, and entries.
- `extract_company_landscape`: Most complete single-call company intelligence: SEC 8-K filings + USASpending federal contracts + GDELT global news + product changelog + Stooq quote data. 5 unique sources.
- `extract_finance`: No-key stock quote data via Stooq. Accepts comma-separated ticker symbols and returns quote/OHLC/volume observations with timestamps.
- `extract_finance_landscape`: Composite financial intelligence: Stooq quote data + HN sentiment + Reddit discussion + GitHub ecosystem + product changelog. 5-source unified report.
- `extract_gdelt`: Global news intelligence from GDELT. Monitors news from every country in 100+ languages, updated every 15 minutes. Returns articles with source country, language, date.
- `extract_gebiz`: Singapore Government procurement opportunities (GeBIZ via data.gov.sg). Search by keyword, agency name, or empty for all recent tenders.
- `extract_github`: Extract real-time data from a GitHub repository — README, stars, forks, last commit, topics. Returns timestamped freshcontext.
- `extract_govcontracts`: US federal contract awards from USASpending.gov. Search by company name (e.g. 'Palantir'), keyword, or NAICS code. Returns amounts, dates, agencies.
- `extract_gov_landscape`: Composite government intelligence: federal contract awards (USASpending) + dev community awareness (HN) + GitHub repo activity + product release velocity (changelog). 4-source unified report.
- `extract_hackernews`: Extract top stories or search results from Hacker News. The url field accepts an HN/Algolia URL or a plain search query.
- `extract_idea_landscape`: Idea validation composite: HN pain signals + YC funded competitors + GitHub crowding + jobs market signal + npm/PyPI ecosystem + Product Hunt launches. 6 sources.
- `extract_landscape`: Composite tool. Queries GitHub + HN + npm simultaneously. Returns a unified landscape report with each source's own freshness.
- `extract_producthunt`: Extract recent Product Hunt launches by keyword/topic search or a PH URL. Returns name, tagline, votes, comment count, topics, and launch date per result.
- `extract_reddit`: Extract recent posts from a subreddit (e.g. 'r/MachineLearning') or a Reddit search/listing URL. Returns title, subreddit, author, score, comment count, and post date per result.
- `extract_scholar`: Extract research results (title, authors, year, snippet) from a Google Scholar search URL. Scholar exposes only the publication year, not an exact date, so freshness confidence is capped at medium.
- `extract_sec_filings`: SEC 8-K filings via EDGAR full-text search. 8-K = legally mandated material event disclosures (CEO changes, M&A, breaches). Pass company name, ticker, or keyword.
- `extract_yc`: Withdrawn in 0.5.3 pending review of source terms. Returns an error; kept so existing clients get a clear answer.
- `package_trends`: npm and PyPI package metadata — version history, release cadence, last updated.
- `search_jobs`: Search for real-time job listings with freshness badges on every result. Sources: Remotive + HN Who is Hiring.
- `search_repos`: Search GitHub for repositories matching a keyword. Returns top results by stars.