Skip to content
poacher.

Developers · API 1.10.1

Changelog

Developer docsChangelog
  1. Overview
  2. Quickstart
  3. Connect over MCP
  4. MCP tools
  5. REST API
  6. Sign-in and permissions
  7. Workflows
  8. Errors
  9. Changelog

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

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

  • The MCP server, its server card and the MCP Registry entry list Poacher’s square icon (SVG, and PNG at 192 and 512 pixels).
  • 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.
  • 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).
  • Read an alert’s saved settings as one snapshot with a configuration_revision.
  • Previews with up to ten sources, each with its own interval and schedule.
  • Replace an alert’s search from a finished preview.
  • Create an alert from a preview and approve fixed-term monitoring (monitoring:manage, off by default).
  • Quote and approve a one-off check of an alert.
  • Quote and approve capped paid previews within a daily API allowance.
  • Rename or pause an alert with If-Match and Idempotency-Key.
  • Account tools over MCP at /api/mcp/account.
  • Scoped read-only API keys, public MCP discovery tools and the OpenAPI document.

View this page as MarkdownAPI version 1.10.1Changelog