FreshContext
Context integrity for AI agents: evaluate freshness, confidence, provenance, and decision readiness.
我該用這個嗎
品質與安全性
發現項目（5）
- HIGHTool poisoning patterns detected
- LOWTool 'extract_finance' description lacks action verb在 extract_finance 中
- LOWTool 'extract_landscape' description lacks action verb在 extract_landscape 中
- LOWTool 'extract_idea_landscape' description lacks action verb在 extract_idea_landscape 中
- INFOTool description contains placeholder or incomplete text在 extract_hackernews 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"freshcontext": {
"command": "npx",
"args": [
"freshcontext-mcp"
]
}
}
}可執行的套件
0.5.3stdio遠端端點
https://freshcontext-mcp.gimmanuel73.workers.dev/mcpstreamable-httphttps://api.freshcontext.dev/mcpstreamable-http它能做什麼
工具清單
工具（22）
🟢evaluate_context(profile, intent, signals, now)
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.
輸入結構描述
{
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 1,
"description": "Source Profile id, e.g. academic_research, jobs_opportunities, market_finance, official_docs, local_custom."
},
"intent": {
"type": "string",
"minLength": 1,
"description": "Intent Profile id, e.g. citation_check, student_research, developer_adoption, job_search, market_watch, business_due_diligence, medical_literature_triage."
},
"signals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"source": {
"type": "string",
"minLength": 1,
"description": "Source URL, URI, document id, or stable source label."
},
"source_type": {
"type": "string",
"description": "Source type such as arxiv, jobs, official_docs, custom, or user_provided."
},
"title": {
"type": "string"
},
"content": {
"type": "string"
},
"published_at": {
"type": [
"string",
"null"
]
},
"content_date": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"semantic_score": {
"type": "number",
"description": "Optional relevance score from 0..1. Core clamps out-of-range values."
},
"date_confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low",
"unknown"
]
},
"freshness_confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"status": {
"type": "string",
"enum": [
"success",
"partial",
"stale",
"failed",
"unknown"
]
},
"metadata": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"source"
],
"additionalProperties": true
},
"minItems": 1,
"maxItems": 100,
"description": "Candidate context items provided by the caller. FreshContext evaluates these; it does not retrieve them."
},
"now": {
"type": "string",
"description": "Optional ISO timestamp for deterministic evaluation."
}
},
"required": [
"profile",
"intent",
"signals"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_github(url)
Extract real-time data from a GitHub repository — README, stars, forks, last commit, topics. Returns timestamped freshcontext.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Full GitHub repo URL e.g. https://github.com/owner/repo"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_hackernews(url)
Extract top stories or search results from Hacker News. The url field accepts an HN/Algolia URL or a plain search query.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"minLength": 1,
"description": "HN URL e.g. https://news.ycombinator.com/news, Algolia API URL, or search query e.g. 'browser agents'"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_scholar(url)
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.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Google Scholar search URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_yc(url)
Withdrawn in 0.5.3 pending review of source terms. Returns an error; kept so existing clients get a clear answer.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Previously a ycombinator.com/companies URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_repos(query)
Search GitHub for repositories matching a keyword. Returns top results by stars.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query e.g. 'mcp server typescript'"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢package_trends(packages)
npm and PyPI package metadata — version history, release cadence, last updated.
輸入結構描述
{
"type": "object",
"properties": {
"packages": {
"type": "string",
"description": "Package name(s) e.g. 'langchain' or 'npm:zod,pypi:fastapi'"
}
},
"required": [
"packages"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_reddit(url)
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.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Subreddit name e.g. 'r/MachineLearning' or search URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_producthunt(url)
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.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Search query or PH topic URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_finance(url)
No-key stock quote data via Stooq. Accepts comma-separated ticker symbols and returns quote/OHLC/volume observations with timestamps.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Ticker symbol(s) e.g. 'AAPL' or 'MSFT,GOOG'"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_jobs(query, max_length)
Search for real-time job listings with freshness badges on every result. Sources: Remotive + HN Who is Hiring.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Job search query e.g. 'typescript remote'"
},
"max_length": {
"type": "number",
"default": 6000
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_landscape(topic)
Composite tool. Queries GitHub + HN + npm simultaneously. Returns a unified landscape report with each source's own freshness.
輸入結構描述
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"description": "Project idea or keyword e.g. 'mcp server'"
}
},
"required": [
"topic"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_arxiv(url)
Search arXiv for research papers via the official API. Pass a topic or full arXiv API URL. Returns titles, authors, dates, abstracts.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Search query e.g. 'temporal retrieval', or a full arXiv API URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_changelog(url)
Update history for any product. Accepts a GitHub repo URL or an npm package name. Returns version numbers, release dates, and entries.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "GitHub repo URL or npm package name e.g. 'react'"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_gdelt(url)
Global news intelligence from GDELT. Monitors news from every country in 100+ languages, updated every 15 minutes. Returns articles with source country, language, date.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Query: company name, topic, or keyword"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_gebiz(url)
Singapore Government procurement opportunities (GeBIZ via data.gov.sg). Search by keyword, agency name, or empty for all recent tenders.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Keyword, agency, or empty for latest tenders"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_govcontracts(url)
US federal contract awards from USASpending.gov. Search by company name (e.g. 'Palantir'), keyword, or NAICS code. Returns amounts, dates, agencies.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Company name, keyword, or NAICS code"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_sec_filings(url)
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.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Company name, ticker, or keyword"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_gov_landscape(query, github_url)
Composite government intelligence: federal contract awards (USASpending) + dev community awareness (HN) + GitHub repo activity + product release velocity (changelog). 4-source unified report.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Company name, keyword, or NAICS code"
},
"github_url": {
"type": "string",
"description": "Optional GitHub repo URL for the company"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_finance_landscape(tickers, company_name, github_query)
Composite financial intelligence: Stooq quote data + HN sentiment + Reddit discussion + GitHub ecosystem + product changelog. 5-source unified report.
輸入結構描述
{
"type": "object",
"properties": {
"tickers": {
"type": "string",
"description": "One or more ticker symbols e.g. 'PLTR' or 'PLTR,MSFT'"
},
"company_name": {
"type": "string",
"description": "Company name for HN/Reddit/GitHub searches"
},
"github_query": {
"type": "string",
"description": "GitHub search query or repo URL"
}
},
"required": [
"tickers"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_company_landscape(company, ticker, github_url)
Most complete single-call company intelligence: SEC 8-K filings + USASpending federal contracts + GDELT global news + product changelog + Stooq quote data. 5 unique sources.
輸入結構描述
{
"type": "object",
"properties": {
"company": {
"type": "string",
"description": "Company name e.g. 'Palantir', 'Anthropic'"
},
"ticker": {
"type": "string",
"description": "Stock ticker for finance data"
},
"github_url": {
"type": "string",
"description": "Optional GitHub repo or org URL for changelog accuracy"
}
},
"required": [
"company"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_idea_landscape(idea)
Idea validation composite: HN pain signals + YC funded competitors + GitHub crowding + jobs market signal + npm/PyPI ecosystem + Product Hunt launches. 6 sources.
輸入結構描述
{
"type": "object",
"properties": {
"idea": {
"type": "string",
"description": "Your idea, problem space, or keyword"
}
},
"required": [
"idea"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}建議的提示詞
search_repossearch_repos社群
證據