> ## 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.

# generate_blog_post_ideas

> Brainstorm blog post angles from recent commits

Unlike the other generation tools, this call is **synchronous** — it returns a list of blog post ideas immediately without creating a background task or persisting anything.

Use it as the first step in a two-step flow: brainstorm ideas, let the user (or the model) pick one, then pass that idea back to [`generate_blog_post`](/mcp/generation/generate-blog-post).

## Arguments

| Name           | Type              | Default      | Description                            |
| -------------- | ----------------- | ------------ | -------------------------------------- |
| `start_date`   | string (ISO-8601) | 7 days ago   | Earliest commit timestamp to consider. |
| `end_date`     | string (ISO-8601) | now          | Latest commit timestamp to consider.   |
| `product_name` | string            | project name | Override the product name.             |

## Returns

```json theme={null}
{
  "ideas": [
    {
      "title": "Ship faster with webhook retries",
      "summary": "We shipped per-endpoint retry budgets this week, and here's why it matters.",
      "angle": "Reliability story for platform teams",
      "category": "Engineering"
    }
  ]
}
```

Each idea is a valid `idea` payload for `generate_blog_post`.

## Example prompts

> "Give me three blog post angles from what we shipped last week."

> "Brainstorm ideas, pick the most user-facing one, and kick off generation."