# Changelog

> What changed in the Poacher API and MCP server, by version.

Source: https://app.poacher.io/developers/changelog · API version 1.10.1

The API is versioned as a whole. Additions do not break existing clients; anything that would is announced here first.

## 1.10.1 · 2026-11-14 {#v1-10-1}

- The MCP server, its server card and the MCP Registry entry list Poacher’s square icon (SVG, and PNG at 192 and 512 pixels).

## 1.10.0 · 2026-11-14 {#v1-10-0}

- One MCP address, `/mcp`, for public and account tools. Clients sign in the first time an account tool is called; a missing permission returns HTTP 403 with the scope to ask for.
- New tool `start_alert_in_app` hands a search to the person as a link that opens the alert builder already filled in.
- Tools now return the same JSON as their REST twins (`{"data": …}`) and declare output schemas, titles and the permission they need.
- MCP protocol 2026-07-28 alongside 2025-era clients.
- OAuth redirects may use loopback HTTP on any port or an app’s own scheme. Authorization responses include `iss`.
- Errors carry a `docs` link, `required_scope` and `retry_after_seconds` where they apply.
- The source catalog, capabilities and OpenAPI document can be read from any origin and are cached for five minutes.
- New docs at `/developers`, each page also served as Markdown, plus `/llms-full.txt`, an MCP server card and an RFC 9727 API catalog.

## 1.9.0 · 2026-10-28 {#v1-9-0}

- Preview a change to a saved search, copying everything you leave out exactly.
- OAuth 2.1 sign-in for MCP clients, with client ID metadata documents and dynamic registration.
- Added on 2026-11-13: channels. Add Slack, Discord, ntfy and text-message channels, confirm them with the code they receive, and choose where an alert sends results (`channels:manage`).

## 1.8.0 · 2026-10-28 {#v1-8-0}

- Read an alert’s saved settings as one snapshot with a `configuration_revision`.

## 1.7.0 · 2026-10-28 {#v1-7-0}

- Previews with up to ten sources, each with its own interval and schedule.

## 1.6.0 · 2026-10-28 {#v1-6-0}

- Replace an alert’s search from a finished preview.

## 1.5.0 · 2026-10-28 {#v1-5-0}

- Create an alert from a preview and approve fixed-term monitoring (`monitoring:manage`, off by default).

## 1.4.0 · 2026-10-28 {#v1-4-0}

- Quote and approve a one-off check of an alert.

## 1.3.0 · 2026-10-28 {#v1-3-0}

- Quote and approve capped paid previews within a daily API allowance.

## 1.2.0 · 2026-10-28 {#v1-2-0}

- Rename or pause an alert with `If-Match` and `Idempotency-Key`.

## 1.1.0 · 2026-10-28 {#v1-1-0}

- Account tools over MCP at `/api/mcp/account`.

## 1.0.0 · 2026-10-27 {#v1-0-0}

- Scoped read-only API keys, public MCP discovery tools and the OpenAPI document.