briefings

briefing-mcp

Briefing Service 用の MCP サーバーです。毎時、LLM の編集者がトピックごとに約 100 件のフィード（AI ニュース、AI 研究、最先端の研究機関、市場、米国スポーツ、欧州サッカー、米国ニュース、世界、暗号資産とオンチェーン）をランク付けします。さらに、1 日 2 回のエディション（Grants & Funding：新たに掲載された連邦政府の資金提供告知。各項目に締切／金額／対象者を記載。Noticias Lentas：その日のニュースを CEFR B1 相当のやさしいスペイン語で、用語集付きで紹介）も作成し、その結果を構造化 JSON、レンダリング済みの 480x800 電子ペーパー用ページ、複数ページの Morning Paper PDF、そして確認したすべての候補の無料の出典情報ダンプとして公開します。

このパッケージはローカルで stdio 経由で動作し、公開 REST API を呼び出します。同じツールは、インストール不要のストリーミング可能な HTTP 経由でも、https://briefing-service.wholemind.workers.dev/mcp でリモート提供されています。

インストール

Claude Desktop／Claude Code／Cursor／任意の stdio クライアント：

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

Claude Code のワンライナー：

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

Claude Desktop ではワンクリックで利用できます。briefing-mcp-0.1.0.mcpb をダウンロードして開いてください（MCP バンドル。任意の Reader キーを尋ねられます）。

ツール

ツール	返される内容	料金
list_briefings	11 個のキー（ai、research、labs、finance、sports、soccer、us、world、crypto、grants、slow-es-b1）、名前、料金	無料
get_briefing(key)	リード、ランク付けされた記事、調査、重要な理由、要点	1 日あたり IP ごとに 25 回まで無料。その後はキーまたは x402
get_summary(key)	見出しと短い説明	無料
get_candidates(key)	今時間内に確認したすべての候補：正規リンク、配信元、selected、duplicate_of を含む統合済み重複項目	無料
get_page(key, page, wide)	480x800 の 1 ビット PNG（または 800x480 の横長表紙ページ）	1 日あたり IP ごとに 25 回まで無料

料金

• 無料：1 日あたり IP ごとに JSON／ページ／ツールの呼び出しが 25 回まで無料。summary と candidates のエンドポイントは別途無料です。
• Reader キー：月額 9 ドル。読み取り回数無制限、Morning Paper の配信付き。BRIEFING_KEY に設定してください。https://briefing-service.wholemind.workers.dev/billing/checkout で購入できます。
• 呼び出しごと：リモートエンドポイントに対して x402（Base 上の USDC）で支払います。

エージェント向けドキュメント：https://briefing-service.wholemind.workers.dev/llms.txt

仕組み

index.js がサーバー全体です。@modelcontextprotocol/sdk に 5 つのツールを登録し、それぞれの呼び出しに対して HTTPS 経由で公開 Briefing Service REST API（GET /v1/briefings/...）を呼び出して応答します。何も保存せず、シェルコマンドも実行せず、2 つの環境変数（BRIEFING_KEY、BRIEFING_BASE_URL）のみを読み込みます。Dockerfile は同じものをビルドします。docker run -i は stdio 経由で MCP と通信します。

ローカルでスモークテストを実行します：

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

パイプライン（収集、エンティティ重複による統合、LLM 編集者、1 ビットレンダリング）と、最初の週に得られた知見についての記事：https://dev.to/jshelley/i-built-an-hourly-newspaper-for-e-ink-and-turned-the-pipeline-into-an-mcp-server-1ebg。各ブリーフィングには /v1/briefings/{key}/feed.xml の Atom フィードもあります。Morning Paper PDF には各記事の概要、表紙からのリンク、各記事ページにクリック可能なソース URL が含まれます。

環境変数

• BRIEFING_KEY：任意の Reader キー（Authorization: Bearer として送信）。
• BRIEFING_BASE_URL：API のベース URL を上書きします（デフォルト：公開サービス）。

ライセンス

MIT