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

# get_banner

> Get the project's live announcement banner

Returns the announcement banner currently live for the connected project — the one-line bar (badge, headline, one-sentence body, call-to-action, link) a site shows at the top of the page. Exactly one banner is live per project; publishing a new one replaces it under the same `slug`, which is the embed key.

## Arguments

None — the banner is resolved from the connection's project.

## Returns

```json theme={null}
{
  "slug": "acme-banner",
  "headline": "Scheduled X threads now post themselves",
  "body": "Approve once; Shipstar posts the thread at the scheduled time.",
  "cta_label": "See what's new",
  "badge": "New",
  "link_url": "https://acme.com/changelog",
  "period_start": "2026-08-31",
  "period_end": "2026-09-07",
  "published_at": "2026-09-07T09:02:11+00:00",
  "expires_at": null,
  "commit_count": 14
}
```

## Errors

* `No banner is live for this project.` — never published, replaced, or past its take-down time. Generate one with [`generate_banner`](/mcp/generation/generate-banner).

## Example prompts

> "What does our site banner say right now?"

> "Is a banner live? If so, when was it published?"