Poacher
io.poacher/poacher · v1.19.0 · MCP 2026-07-28
Listing alerts: preview searches, create and approve alerts, read results and manage channels.
Reachability
reachable
checked 2026-11-21 05:37 UTC
Registry status active
Tools pinned 65
b3c851796a0f
Tools last changed
2026-11-21
Provenance
Registry namespace io.poacher
(domain verified by the official registry)
Remote endpoints
https://app.poacher.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:37 | tools changed | 0 added, 0 removed, 17 changed |
| 2026-11-20 05:35 | tools changed | 0 added, 0 removed, 11 changed |
| 2026-11-19 05:34 | tools changed | 42 added, 0 removed, 11 changed |
| 2026-11-16 05:31 | tools changed | 0 added, 0 removed, 23 changed |
| 2026-11-15 05:30 | first capture | 23 tools pinned |
Pinned tool definitions (65)
| Tool | Description |
|---|---|
| list_sources | Search the public catalog of sites Poacher can watch. Returns each source’s name, category, status (fixture_available or planned) and current availability. A listed source still needs the exact search previewed (quote_preview) before... |
| get_capabilities | Read what the API and MCP server can do today, the limits that apply and what is switched off. Read this before planning paid work. No account data, no sign-in. |
| start_alert_in_app | Make a link that opens Poacher’s alert builder with a search already filled in. Prefer creating the alert here in the conversation (see the server instructions); use this link only when the person asks to finish in Poacher, or has no... |
| read_account | Read prepaid balances, the monthly cap, time zone and billing environment. Money is in USD micros (1,000,000 micros = 1 USD). Changes nothing. Permission: account:read. |
| read_billing | Read the account’s billing, as on the app’s Balance & payments and Payment controls pages: balance, whether a card is on file, the monthly card-charge cap and how much of it is left, automatic recharge settings, this month’s usage and... |
| read_statement | Read one month’s statement, as on the app’s Usage & receipts page: usage by alert and source, minimums, the platform fee, and card payments with their status. Read-only. Permission: account:read. |
| read_payment | Read one card payment and its refunds, as on its receipt in the app. Read-only; refunds are requested in the app. Permission: account:read. |
| list_alerts | List saved alerts, newest first, with names, criteria, status and holds. Page with before. Permission: alerts:read. |
| get_alert | Read one alert you own, including edit_revision for edit_alert. Unknown alerts and other accounts’ alerts both return not_found. Permission: alerts:read. |
| get_alert_configuration | Read one alert’s current source URLs, schedules, exact filters, matching brief, selected channels and minimum, plus configuration_revision. Use the revision to make sure settings have not changed before quoting a replacement. Never... |
| list_results | Read matching results for one alert, newest first. Each has its title, price, link, the store photo Poacher saved (image_url) and the listing’s details. `match.summary` says why it matched, `match.evidence` supports it and... |
| get_result | Every store photo Poacher saved (`images`, up to 10), the listing’s details and description, all of the matching evidence, what could not be confirmed and the source check (source_check). With alerts:read it also returns the alert’s... |
| edit_alert | Rename an alert, pause it, or both. Needs edit_revision from get_alert. To turn a paused alert back on, use quote_resume and resume_alert. Pausing stops future checks; checks already running finish and are charged. Permission: alerts:write. |
| quote_resume | Read what turning a paused alert back on would do: its monthly minimum, estimated monthly cost, the channels that will get matches, and whether the account can pay. Changes nothing. If can_resume is false, `reason` says why. Show the... |
| resume_alert | Turn a paused alert back on, the same as Resume in the app. It runs until someone pauses it, with no end date; checks are charged from the balance, the monthly minimum applies while it is on, and the account’s monthly cap still applies.... |
| rate_result | Record the person’s answer to whether a result was what they wanted, the same as Yes, Close and No in the app: `yes` (a match), `close` (nearly) or `no` (not a match), with an optional note on what was right or wrong. It guides future... |
| mark_results_seen | Mark results the person has looked at as seen, the same as viewing them in the app: they stop counting as new and it counts as account activity. Reading results with list_results or get_result does not do this on its own. A result... |
| list_repairs | Read source repairs for an alert, the same as the app’s source repair review. When a source breaks, Poacher may propose a replacement with a newly measured monthly estimate; checks and the alert’s minimum stay paused until someone... |
| decide_repair | Approve or decline a source repair from list_repairs, the same as the app. Approving replaces the broken source and the alert’s estimate becomes the proposed one, so show the person both estimates and the notice first. Declining leaves... |
| list_channels | List this account’s channels (email, Slack, Discord, ntfy, web push, text) and whether each is on, paused, opted out or waiting for its code. Destinations and credentials are never returned. Permission: channels:manage. |
| get_channel | Read one channel, including whether its confirmation code was sent and when the code expires. Permission: channels:manage. |
| add_channel | Add a Slack or Discord webhook, an ntfy topic or a US mobile number. The channel stays off and receives nothing until confirm_channel gets the 6-digit code sent to it (valid 10 minutes). Text messages are charged per message from the... |
| confirm_channel | Enter the 6-digit code the channel received. Turns the channel on and adds it to alert_id (and to any alert named when it was added). Ask the person for the code; never guess. Five wrong codes need a new code. Permission: channels:manage. |
| resend_channel_code | Send a new code to a channel that is waiting for one. Earlier codes stop working. Up to 8 codes an hour per account. Permission: channels:manage. |
| set_alert_channels | Replace the confirmed channels an alert sends results to. [] keeps results in Poacher only. Starts no paid work; a text-message channel is charged per message when results arrive (price in get_capabilities, channels.sms). Permission:... |
| set_channel_on | Pause a confirmed channel or turn it back on, the same as the app’s Notifications page. A paused channel stays on its alerts but receives nothing until it is turned on. Works for the account email too. Permission: channels:manage. |
| remove_channel | Remove a Slack, Discord, ntfy, browser or text-message channel, the same as Remove in the app. It leaves every alert and the defaults at once, and a phone number’s text consent ends. Adding it back needs a new confirmation code. The... |
| get_channel_defaults | Read which channels new alerts start with. If none were chosen, every confirmed channel is used. Permission: channels:manage. |
| set_channel_defaults | Choose the confirmed channels new alerts start with. Existing alerts keep their own channels (change those with set_alert_channels). [] means new alerts notify nobody outside Poacher. Permission: channels:manage. |
| get_alert_delivery | Read an alert’s delivery style (grouped when busy, immediate, or hourly summaries), its limits and channels, with a plain explanation. Permission: channels:manage. |
| set_alert_delivery | Works like Delivery style in the app. `adaptive`: the first immediate_per_hour results in a rolling hour go out at once (default 3), the rest wait for an hourly summary. `instant`: every result as soon as it is ready. `hourly`: one... |
| list_shares | List the people an alert is shared with and each invitation’s status (pending, accepted, declined, revoked or expired). Permission: alerts:read. |
| share_alert | Create an invitation link for one email address, the same as Share in the app. Poacher emails no one: give the person the invitation_url and they send it themselves. Only that email address can accept, within 7 days. The recipient sees... |
| stop_sharing | End a share or withdraw an invitation, the same as Stop sharing in the app. Works for the owner, and for a recipient leaving an alert shared with them. Messages already on their way may still arrive. Permission: alerts:write. |
| list_shared_with_me | List alerts other people share with this account. They are receive-only: the owner sets the search and pays for it. Permission: alerts:read. |
| get_shared_alert | Read one alert shared with this account: its recent results (50 a page, from the last 60 days since accepting) and the channels they go to. Permission: alerts:read. |
| answer_invitation | Accept or decline an invitation link the person received, the same as opening it in the app. It only works for the invited email address. Accepting costs nothing; results are delivered only after choose_shared_channel and... |
| choose_shared_channel | Start receiving an alert shared with this account on one of its enabled channels (email, Slack, Discord, ntfy or browser). Sends an 8-digit code to that channel, valid 10 minutes; nothing is delivered until confirm_shared_channel gets... |
| confirm_shared_channel | Enter the 8-digit code the channel received. Ask the person for it; never guess. Five wrong codes need a new one. Permission: channels:manage. |
| stop_shared_channel | Stop sending a shared alert’s results to one channel. The share itself stays; choose another channel at any time. Permission: channels:manage. |
| set_shared_delivery | Choose how a confirmed channel receives a shared alert: `adaptive` (the first immediate_per_hour results in a rolling hour at once, default 3, then an hourly summary), `instant` or `hourly`. Permission: channels:manage. |
| quote_check | Set a spending ceiling for checking one active alert once now: all its sources plus result review. Saves a quote only; nothing runs and nothing is charged. Returns request_hash for approve_check. Permission: work:execute. |
| approve_check | Spends prepaid funds. Runs the quoted check within its ceiling and the person’s daily allowance; new matches go to the alert’s channels. Call only after the person approves this spend. Failed attempts are still charged, within the... |
| get_check | Read a check’s status, result counts and receipt. A pending charge is unknown, not zero. Read the results themselves with list_results. Permission: work:execute. |
| cancel_check | Stop further paid steps of a check. Work already sent can finish and is charged; saved results stay. Does not pause the alert. Permission: work:execute. |
| quote_preview | Set up a one-time preview of what an alert would find: one url, or sources (1–10 search URLs) each with its own interval and schedule, plus shared criteria. Poacher covers previews for now, so no ceiling is needed and nothing is... |
| quote_edit_preview | Quote a preview of an alert with some settings changed. Poacher covers it, so nothing is charged. Anything you leave out is copied exactly. Does not change the alert. Approve with approve_preview; applying the change later is a separate... |
| quote_copy_preview | Quote a preview of a new alert copied from an existing one, archived or not. Poacher covers it, so nothing is charged. Copies the sources, brief, filters and schedules, with any changes, like “Create a new alert with these settings” in... |
| approve_preview | Runs the quoted preview. Poacher covers its cost for now, so nothing is charged and the daily API allowance is not used. Never starts ongoing monitoring. Previews usually take 1–5 minutes on a source Poacher already reads and 10–20... |
| answer_preview_questions | When a preview’s status is needs_clarification, ask the person its questions and send their answers here, one per question in the order asked. The same preview continues. Poacher covers it, so there is no new quote, approval or charge.... |
| get_preview | Read a preview’s status, what it is doing now (progress), how long it usually takes, sample results and receipt. While it is queued or running, check again after check_again_after_seconds. A covered preview’s receipt shows 0; a paid... |
| cancel_preview | Stop further paid steps of a preview. Work already sent can finish and is charged. Safe to repeat. Permission: work:execute. |
| list_notification_connections | List enabled channel IDs, types and names to choose from when creating or replacing an alert. [] means no notifications. Permission: monitoring:manage. |
| get_alert_update | Read a replacement quote or its result. Changes nothing. Permission: monitoring:manage. |
| cancel_alert_update | Cancel an unapproved replacement. Does not undo an applied change. Permission: monitoring:manage. |
| get_alert_creation | Read a creation quote or the paused alert it created. Changes nothing. Permission: monitoring:manage. |
| cancel_alert_creation | Cancel an unapproved creation. Does not delete an alert already created. Permission: monitoring:manage. |
| get_monitoring | Read a monitoring permission: expiry, ceilings, settled charges and anything still pending. A pending maximum is not a final charge. Permission: monitoring:manage. |
| revoke_monitoring | Stop further paid checks under this permission and pause the alert if it is the current one. Work already sent can finish and is charged. Works even while new monitoring is switched off. Permission: monitoring:manage. |
| quote_alert_update | Quote replacing an alert’s whole search with a finished preview. Keeps result history, minimum and delivery preferences. Changes nothing yet. Permission: monitoring:manage. |
| approve_alert_update | Replace the alert’s sources and criteria with the quoted preview and leave it paused. Revokes earlier monitoring permissions. Call only after the person approves this exact change. Permission: monitoring:manage. Ask the person before calling. |
| quote_alert_creation | Quote creating a paused alert from a finished preview. Returns the monthly minimum and estimate. Nothing is charged or started. Permission: monitoring:manage. |
| approve_alert_creation | Create the quoted alert, paused. Call only after the person accepts the monthly minimum shown in the quote. Starts no checks: to turn it on, use quote_resume and resume_alert (runs until paused), or quote_monitoring and... |
| quote_monitoring | Optional. Quote an end date, a total ceiling (including the minimum) and a per-check ceiling for a paused alert. For an alert that runs until paused, use quote_resume and resume_alert instead. Starts nothing. Permission: monitoring:manage. |
| approve_monitoring | Starts recurring paid checks and notifications within the quoted limits until the end date. Call only after the person approves the search, channels, end date, ceilings and minimum. Failed checks are still charged, within the... |
Get alerted when this changes.
Email the moment io.poacher/poacher drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.poacher/poacher)
Maintain this server? Add the badge to your README. It links your users to this live status page.