Brifing for developers and agents

Brifing summarizes business, technology, AI, finance and career news from 500+ publishers into short, sourced story cards. Everything on this page is public, read-only and free — no API key, no sign-up.

Please cite the publisher and the original article (original_url) whenever you use a story; Brifing's text is a summary of their reporting.

Markdown

Every page has a Markdown version for agents that do not run JavaScript. Send Accept: text/markdown, or add ?format=md to the URL.

curl -H "Accept: text/markdown" https://brifing.si/
curl "https://brifing.si/s/af7be590-1524-41f9-8e5a-93865000e092?format=md"

Markdown responses include an x-markdown-tokens header with an approximate token count. Pages: home (/), stories (/s/{id}), topics (/c/{slug}), publishers (/source/{id}), /pricing and /legal/{terms,privacy,refund}.

REST API

Base URL: https://brifing.si/api/v1 · OpenAPI 3.1: /openapi.json · Status: /api/v1/health

Endpoint	What it returns
`GET /stories`	Newest stories. `topic`, `limit` (1–50), `lang`
`GET /stories?q=…`	Stories whose headline contains every keyword, newest first
`GET /stories/{id}`	One story: summary cards, publisher, original link, other outlets covering it
`GET /categories`	Topics and their slugs
`GET /sources`	Publishers Brifing follows
`GET /health`	Status and the age of the newest story

curl "https://brifing.si/api/v1/stories?topic=data-ai&limit=5"
curl "https://brifing.si/api/v1/stories?q=nvidia%20earnings"

Topics: business, data-ai, finance, growth, people, entrepreneurship, leadership, operations, engineering, marketing, product, design, sales. Languages: en (default), es, fr, de, it, pt, ja, ko, ar; stories without cards in a language fall back to English.

MCP server

URL: https://brifing.si/mcp (Streamable HTTP, JSON responses, no authentication). Add it as a custom connector in Claude, ChatGPT or any MCP client. Server card: /.well-known/mcp/server-card.json.

Tool	Arguments
`get_latest_stories`	`topic?`, `limit?`, `lang?`
`search_stories`	`query`, `limit?`, `lang?`
`get_story`	`id` (UUID or brifing.si/s/… URL), `lang?`
`list_topics`	`lang?`

Every tool is read-only and returns Markdown text plus structured JSON.

A2A agent

Endpoint: https://brifing.si/a2a (JSON-RPC; A2A 1.0 SendMessage and 0.3 message/send). Agent card: /.well-known/agent-card.json.

Send a text part such as "latest AI news", "Nvidia earnings" or a story link. The agent answers immediately with a message containing Markdown and a JSON data part; it keeps no tasks and does not stream.

curl https://brifing.si/a2a -H "Content-Type: application/json" -H "A2A-Version: 1.0" -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"m1","role":"ROLE_USER","parts":[{"text":"latest AI news"}]}}}'

Discovery files

File	Purpose
/llms.txt	Overview for language models
/.well-known/api-catalog	API catalog (RFC 9727)
/.well-known/ai-catalog.json	AI Catalog: MCP server and A2A agent
/.well-known/agent-skills/index.json	Agent skill for using Brifing
/auth.md	Authentication for agents (none needed)
/.well-known/http-message-signatures-directory	Public key of Brifing's crawler (Web Bot Auth)
/sitemap.xml	Sitemap; full archive in /sitemaps/index.xml

Fair use

Responses are cached for a few minutes; please do not poll faster than that.
Identify your client in User-Agent.
Personal data (a user's briefing, saves, subscription) is never available through these interfaces.

Contact

[email protected] — Horus Studios, publisher of Brifing.