# Announcements tools

> MCP tools for Announcements: announcements_list_current.

- `announcements_list_current`: List the current announcements

## `announcements_list_current`

**List the current announcements.** Operation [`announcements.list_current`](https://ownrecord.io/docs/reference/announcements-list-current.md) · Platform level · permission `account:read` · risk tier `read` · since M12

The announcements Ownrecord shows at the top of the console right now (spec §39.1), most severe first: planned
maintenance, incidents, changes that need your attention. With `orgId` (an organization you belong to), the list
also has the announcements for that organization's plan; without it, only those for everyone. Messages are plain
text from Ownrecord staff.

Annotations: `readOnlyHint: true` · `destructiveHint: false` · `idempotentHint: true` · `openWorldHint: false`

### Arguments

| Argument | Type         | Required | Description                    |
| -------- | ------------ | -------- | ------------------------------ |
| `orgId`  | ID (`org_…`) | no       | An organization you belong to. |

- **Read-only:** changes nothing; `idempotency_key` is ignored.

### Errors

- [`resource_not_found`](https://ownrecord.io/docs/reference/errors.md#resource_not_found): `orgId` isn't an organization you belong to.
- [`permission_denied`](https://ownrecord.io/docs/reference/errors.md#permission_denied): You aren't signed in as a person (API keys have no console).

### Example

**Planned maintenance**

Arguments:

```json
{}
```

Result `output`:

```json
{
  "object": "list",
  "data": [
    {
      "object": "announcement",
      "id": "maintenance-2026-11-08",
      "message": "Planned maintenance on Sunday, November 8, 02:00–02:30 UTC. Checkout and the API stay up.",
      "severity": "info",
      "link": "/docs"
    }
  ]
}
```
