Feed, read

List blips

List this project's blips: the posts worth replying to, best first. The defaults are the feed's own, the ones still waiting for a reply in the last 30 minutes.

MCP

Tool namelist_blips
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_blips",
    "arguments": {
      "project_id": "<uuid>"
    }
  }
}

Input

project_idrequireduuid

The project. list_projects names them and marks the default.

statusnew | notified | replied | dismissed

One state. Left out, it lists the new and notified ones together, as the feed does.

group_iduuid

One of the project's watch folders.

min_scoreinteger

Only blips scoring at least this.

platformx | hn | youtube | bluesky | reddit

Only blips from this platform.

repliedboolean

True for the ones already answered, false for the rest.

favoritedboolean

True for the starred ones, which ignore the state unless one is named.

sincestring

How far back to look. A window (30m, 2h, 6h, 24h, 7d, 30d) or an ISO time.

limitinteger

How many rows, up to 100. 30 by default.

studied_onlyboolean

Only blips from an account this project studies, the feed's Studying mark.

Returns

Each blip with its id, score and reasons, its state, the post itself with its author and counts, the watch it came from, its folder label, whether it is starred or studied, and the reply drafted for it when there is one.