List articles
Articles from your reading list, a folder, a tag, a feed or Starred, newest first.
MCP tool inoreader_read → list_articles
read
Lists articles from one stream, newest first unless oldest_first is set. Set unread_only to leave out articles you read, and since to cover a time window. Pages hold up to 100 articles and 20 by default; pass next_cursor back as cursor until it is null. Oldest-first lookback is limited to about one month.
Parameters
| Name | Type | Description |
|---|---|---|
| stream string | string | Folder or tag name, feed ID from list_subscriptions, or one of: reading_list, starred. Default: reading_list. |
| unread_only boolean | boolean | Leave out articles you have read. |
| since datetime | datetime | Only articles newer than this time. |
| oldest_first boolean | boolean | Oldest first instead of newest first. |
| limit integer | integer | 1 to 100. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "inoreader_read",
"arguments": {
"operation": "list_articles",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"articles": [
{
"article_id": "1830442176",
"title": "MCP spec adds elicitation",
"feed": "The Changelog Weekly",
"published_at": "2026-10-16T07:12:00Z",
"starred": false,
"read": false,
"tags": [],
"summary": "Servers can now ask the user a question mid-call..."
},
{
"article_id": "1830442190",
"title": "Agents that plan before they browse",
"feed": "Lab Notes",
"published_at": "2026-10-16T08:40:00Z",
"starred": false,
"read": false,
"tags": [],
"summary": "A small planning step cut wasted page loads..."
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
},
"isError": false
}