English Français العربية

io.github.jshelley/briefings

Registre officiel Productivité

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http briefings 'https://briefing-service.wholemind.workers.dev/mcp' --header 'Authorization: <Bearer <license key> from /billing/checkout; omit to pay per call with x402>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "briefings": {
            "type": "http",
            "url": "https://briefing-service.wholemind.workers.dev/mcp",
            "headers": {
                "Authorization": "<Bearer <license key> from /billing/checkout; omit to pay per call with x402>"
            }
        }
    }
}
MCPB package https://github.com/jshelley/briefing-mcp/releases/download/v0.1.0/briefing-mcp-0.1.0.mcpb

Variables d'environnement

  • BRIEFING_KEY secret Optional Reader key ($9/month) sent as a bearer token; leave empty for the free tier (25 calls/IP/day)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. briefing-mcp
  2. Install
  3. Tools
  4. Pricing
  5. How it works
  6. Environment
  7. License

briefing-mcp

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:

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

Claude Code one-liner:

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:

npm install
node 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

Questions fréquentes

Qu'est-ce que io.github.jshelley/briefings ?

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

Comment installer io.github.jshelley/briefings ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http briefings 'https://briefing-service.wholemind.workers.dev/mcp' --header 'Authorization: <Bearer <license key> from /billing/checkout; omit to pay per call with x402>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.jshelley/briefings ?

Oui. Il attend BRIEFING_KEY, Authorization, à renseigner dans sa configuration.

io.github.jshelley/briefings est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.jshelley/briefings ?

Il est publié par jshelley. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.