Two forms

The same call exists as the MCP tool brain_context with topic and budget, and as GET /api/context?topic=<topic>&budget=1500.

What a topic briefing contains

If no page is titled with the topic, the briefing says so and lists the closest notes instead. If nothing matches at all, it says that the vault has nothing and suggests asking the owner.

Budget

budget is in tokens, counted as about four characters each. The default is 1,500. When a briefing is too long it is cut in this order: the tail of the longest sections, then the text of the longest lines, then whole sections from the end. The title and the reminder always stay. A claim or quote is never left without its source; if it cannot fit with its source, the line is dropped.

Example

Speed

On a vault of about 1,600 notes, a topic briefing from the CLI takes 0.4 to 0.8 seconds including process start. Through a running MCP server or the HTTP API it takes 0.1 to 0.3 seconds.