Briefings

io.github.jshelley由 GitHub 帳號 jshelley 發布v0.3.0更新於 Nov 2, 2026

Hourly ranked news (AI, markets, sports, world): JSON, e-ink pages, Morning Paper PDF; 25 free/day

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取媒體與設計

概覽

AI 產生的概覽

提供由 LLM 每小時編排的新聞簡報（AI、市場、體育、世界、加密、補助），以結構化 JSON 或電子墨水 PNG 頁面回傳。

可以做什麼
  • 列出可用簡報及其名稱與價格
  • 以結構化 JSON 取得某份簡報：頭條、排序後報導、研究項目、重要性說明與重點
  • 將簡報某一頁算繪為 480x800 的 1 位元 PNG，適合電子墨水與小螢幕
  • 讀取標題與一句話摘要，或取得含去重標記的完整候選清單
適用情境
適合讓助理就固定主題彙整或討論即時新聞，或產生精簡的電子墨水風格標題頁，而不必自行建置抓取與排序流程。
執行需求
可使用遠端 streamable HTTP 端點，或透過 npx 或 MCP 套件在本機以 stdio 執行。需要連線至公開的 Briefing Service API。選用 BRIEFING_KEY 供付費 Reader 方案；未填則每個 IP 每天免費 25 次呼叫，遠端端點也可透過 x402 按次付費。
安裝前請注意
僅供新聞讀取，但付費方案涉及費用：每月 9 美元的 Reader 金鑰需以 BRIEFING_KEY 或 Authorization bearer 標頭傳入，或透過 x402 在 Base 上按次支付 USDC。免費額度為每 IP 每天 25 次呼叫。內容來自第三方服務，標題與排序反映其 LLM 編輯的結果。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Briefings，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.jshelley%2Fbriefings/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "briefings": {
      "type": "http",
      "url": "https://briefing-service.wholemind.workers.dev/mcp"
    }
  }
}

README

briefing-mcp

[npm] [Listed on mcpservers.org] [briefing-mcp on Glama] [Indexed on TensorBlock MCP Index]

MCP server for Briefing Service: every hour an LLM editor ranks ~100 feeds per topic (AI news, AI research, frontier labs, markets, US sports, European football, US news, world, crypto & onchain) plus two daily editions (Grants & Funding: newly posted federal funding notices with Deadline / Amount / Eligible on every item; Noticias Lentas: the day's news in simple Spanish at CEFR B1 with a glossary) and publishes the result as structured JSON, a rendered 480x800 e-ink page, a multi-page Morning Paper PDF, and a free provenance dump of every candidate it saw.

This package runs locally over stdio and calls the public REST API. The same tools are served remotely (streamable HTTP, no install) at https://briefing-service.wholemind.workers.dev/mcp.

Install

Claude Desktop / Claude Code / Cursor / any stdio client:

json
{  "mcpServers": {    "briefings": {      "command": "npx",      "args": ["-y", "briefing-mcp"],      "env": { "BRIEFING_KEY": "" }    }  }}

Claude Code one-liner:

bash
claude mcp add briefings -- npx -y briefing-mcp

Claude Desktop, one click: download briefing-mcp-0.1.0.mcpb and open it (MCP bundle; it asks for the optional Reader key).

Tools

toolwhat it returnscost
list_briefingsthe 11 keys (ai, research, labs, finance, sports, soccer, us, world, crypto, grants, slow-es-b1), names and pricesfree
get_briefing(key)lead, ranked stories, research, why-it-matters, key points25 free/IP/day, then key or x402
get_summary(key)headlines and one-linersfree
get_candidates(key)every candidate this hour: canonical link, outlets, selected, collapsed duplicates with duplicate_offree
get_page(key, page, wide)480x800 1-bit PNG (or 800x480 wide front page)25 free/IP/day

Pricing

Docs for agents: https://briefing-service.wholemind.workers.dev/llms.txt

How it works

index.js is the whole server: it registers five tools with @modelcontextprotocol/sdk and answers each by calling the public Briefing Service REST API over HTTPS (GET /v1/briefings/...). It stores nothing, runs no shell commands, and reads only two environment variables (BRIEFING_KEY, BRIEFING_BASE_URL). The Dockerfile builds the same thing; docker run -i speaks MCP over stdio.

Run the smoke test locally:

bash
npm installnode client-test.mjs   # lists tools and calls list_briefings, get_summary, get_candidates, get_page, get_briefing

Write-up of the pipeline (collect, entity-overlap dedupe, LLM editor, 1-bit render) and what the first week taught: https://dev.to/jshelley/i-built-an-hourly-newspaper-for-e-ink-and-turned-the-pipeline-into-an-mcp-server-1ebg. Each briefing also has an Atom feed at /v1/briefings/{key}/feed.xml; the Morning Paper PDF carries an outline per story, front-page go-to links and a clickable source URL on every story page.

Environment

  • BRIEFING_KEY: optional Reader key (sent as Authorization: Bearer).
  • BRIEFING_BASE_URL: override the API base (default: the public service).

License

MIT

來源：README.md，提交 25c3370

工具

3

list_briefings

List the briefings available (AI, Frontier Labs, Markets, US Sports, European Football, US News, World News, Crypto & Onchain hourly; Grants & Funding and Noticias Lentas (simple Spanish, B1) daily).

無需輸入參數。

get_briefing

One briefing as structured JSON: lead story, ranked stories and research items with summaries, why-it-matters and key points, plus when it was ranked.

輸入參數key必填

get_page

One rendered page of a briefing as a 480x800 1-bit PNG (page 0 is the front page; story pages follow). Made for e-ink and small displays.

輸入參數key必填page

版本歷史

1
  1. v0.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分