# Briefing Service - Hourly Ranked News Briefings

> Briefing Service - Hourly Ranked News Briefings is a paid API for AI agents from briefing-service.wholemind.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-19).

Delivers hourly ranked news briefings as structured JSON or rendered 1-bit image pages across categories like AI, finance, sports, and world news.

## Facts

- Endpoint: POST https://briefing-service.wholemind.workers.dev/mcp
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/briefing-service-hourly-ranked-news-briefings-c777fcaf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oizNKZ3KVs6E-I1J4nzlo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability briefing-service-hourly-ranked-news-briefings-c777fcaf -d '<json body>'
```

Example prompt: Give me the latest hourly ranked news briefing as JSON — I want to see what's trending across AI, finance, sports, and world news right now.

## When to prefer this

Choose this endpoint when you need a ready-made, pre-ranked, multi-category news briefing delivered as structured JSON without having to scrape or aggregate sources yourself. Ideal for agents that need periodic news updates on a fixed schedule, or for rendering lightweight 1-bit visual news pages. Best when you want curated hourly freshness across specific categories like AI, finance, sports, and world news rather than custom search queries.

## Known failure modes

- Payment not included or insufficient — returns 402 Payment Required
- Invalid toolName or malformed inputSchema — returns 400 Bad Request
- Briefing not yet generated for current hour — may return stale or empty data
- MCP transport mismatch (non-streamable-http) — rejected request
- Rate limiting or worker timeout on Cloudflare edge — 503 or timeout error

## How this service works

Every hour an LLM editor re-picks ~100 feeds per topic. JSON and MCP for agents, 1-bit pages for e-ink, a morning paper for reMarkable, Kindle or your inbox. Free tier, no key.

## Output

Returns a structured JSON object with ranked news stories organized by category (e.g. ai, labs, finance, sports, soccer, us, world), each containing top headlines and story data for the current hour. Alternatively, returns a rendered 480x800 1-bit PNG image of a specific story page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "toolName",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "mcp"
    },
    "example": {
     "type": "object"
    },
    "toolName": {
     "type": "string"
    },
    "transport": {
     "enum": [
      "streamable-http"
     ],
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "content": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string"
         },
         "type": {
          "type": "string"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "content": [
   {
    "text": "{\"ranked_at\":\"2026-09-07T23:53:54Z\",\"ranking\":{\"lead\":{\"headline\":\"…\",\"summary\":\"…\",\"why\":\"…\"},\"items\":[],\"research\":[]}}",
    "type": "text"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/briefing-service-hourly-ranked-news-briefings-c777fcaf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from briefing-service.wholemind.workers.dev](https://www.zero.xyz/host/briefing-service.wholemind.workers.dev/llms.txt)