> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# list_blog_posts

> List all published Shipstar blog posts, newest first

List every published blog post, ordered from most recent to oldest.

## Arguments

This tool takes no arguments.

## Returns

An array of blog post objects. Each object contains:

| Field          | Type           | Description                                                          |
| -------------- | -------------- | -------------------------------------------------------------------- |
| `slug`         | string         | Public slug, usable with [`get_blog_post`](/mcp/blog/get-blog-post). |
| `content`      | string         | Full markdown body of the post.                                      |
| `category`     | string \| null | Optional category tag.                                               |
| `period_start` | string \| null | Start of the period the post covers (`YYYY-MM-DD`).                  |
| `period_end`   | string \| null | End of the period the post covers (`YYYY-MM-DD`).                    |
| `published_at` | string \| null | ISO-8601 timestamp of the latest update.                             |
| `created_at`   | string \| null | ISO-8601 timestamp when the post was first generated.                |

```json theme={null}
[
  {
    "slug": "drop-one-script-tag",
    "content": "# Drop One Script Tag...",
    "category": "Product",
    "period_start": "2026-03-12",
    "period_end": "2026-03-19",
    "published_at": "2026-03-20T09:00:00+00:00",
    "created_at": "2026-03-19T14:22:11+00:00"
  }
]
```

## Example prompts

> "List our published blog posts and tell me which ones cover the embed widget."

> "Find the most recent blog post in the `Product` category and paraphrase the opening paragraph."