List posts
Posts on a blog or under a tag, newest first.
MCP tool tumblr_read → list_posts
read
Lists published posts of one blog, newest first. Set tag to read posts under a tag instead, from any public blog, and set private to read your private posts. Pages hold up to 20 posts; pass next_cursor back as cursor for the next page. Each item has the post text, tags, note count and the reblog key that reblog_post needs.
Parameters
| Name | Type | Description |
|---|---|---|
| blog string required | string | Blog name, e.g. 'studio-notes' for studio-notes.tumblr.com. Names come from list_blogs. |
| tag string | string | Read posts under this tag instead of the blog own posts. |
| visibility enum | enum | published or private. Default: published. |
| limit integer | integer | 1 to 20. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tumblr_read",
"arguments": {
"operation": "list_posts",
"arguments": {
"blog": "studio-notes"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"posts": [
{
"post_id": "7712345600123",
"blog": "pixel-lab",
"type": "image",
"summary": "Harbor town sprite sheet",
"tags": [
"pixel art",
"sprites"
],
"note_count": 842,
"published_at": "2026-10-16T18:40:00Z"
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
},
"isError": false
}