List articles
list_articlesBrowse, filter, and paginate the Tenjin article directory. Full-text search over title/excerpt/tags plus the whole body of every piece, a paid body included — a match on gated prose only decides WHICH public row is listed (also matches a creator handle); returns preview-only listing items (never a paid body, snippet, match offset, or score), cursor-paginated — newest-first when browsing (or a chosen sort: oldest, most-read, least-read, cheapest, dearest). q alone is relevance-ranked; q + sort filters by the query and orders the matches by the sort. The content match ORs your plain words (or and - are operators; stopwords drop) and the handle arm matches outside it, so extra terms widen the set and relevance orders it: q is still for SHORT terms (a topic word, a name, a handle), and for a whole QUESTION use the search tool, which matches meaning as well as wording.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_articles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text query over title, excerpt, tags, creator handle, and the whole body of every piece (a paid body included; the match only decides which public row is listed, and results stay preview-only). The content match ORs your plain words, so use SHORT terms; a whole question belongs on the `search` tool | |
| tag | No | Tag slug to scope to | |
| sort | No | Browse order: recency (newest/oldest), public read count (most-read/least-read), or price (cheapest/dearest). Composes with q (query filters, sort orders the matches); omit with q for relevance ranking | |
| limit | No | 1–100, default 50 | |
| cursor | No | nextCursor from the previous page | |
| creator | No | Publisher word-handle or 0x address to scope to | |
| maxPrice | No | Price ceiling, atomic USDC digits ("250000" = $0.25; "0" = free only) | |
| minPrice | No | Price floor, atomic USDC digits ("1" = paid pieces only) | |
| updatedSince | No | Incremental sync: ISO 8601 UTC instant — re-fetch only pieces updated since your last crawl (combine with the default newest order) | |
| publishedSince | No | ISO 8601 UTC instant — keep only pieces published at or after it |