Recipe for agents
Check a notification's status
Find out whether it arrived, was delivered, opened or downloaded.
This is the recipe the MCP server gives AI assistants, as is. It is in English because models follow it best that way; the assistant answers you in your language.
An assistant reads it with docs({uri:"docs://recipes/check-a-notification-status"})
docs://recipes/check-a-notification-status — what happened to a notification that was sent
Use when the lawyer asks "did it arrive?", "was it delivered?", "did they open it?" about a
notification. For what those words legally mean, read docs://recipes/what-counts-as-delivered
before you answer — the words matter in court.
1. whoami({})
→ orgId
skip if you already hold orgId
2. notificationList({orgId:"<orgId>", limit:50})
→ notification.id, status, subject, case
Newest first. The lawyer named a case or radicado instead? Use
docs://recipes/find-a-case-by-radicado first, then match on the case.
Not in the first 50? Call again with limit:200. Still not there? Stop and ask for more detail.
skip if you already hold notification.id
3. notificationDetail({orgId:"<orgId>", id:"<notification.id>"})
→ status, recipients[] (each with its status), attachments[], timeline[]
status "draft"? It was never sent — say so. An open send request is waiting for the lawyer's
confirmation in the panel if they asked you to send it.
status "freezing" | "frozen" | "sending"? It is on its way; check again in a minute. Do not
poll more than 5 times.
status "failed"? Say so, and quote the timeline's last event.
4. Report per recipient, in plain words, with times in America/Bogota:
- "accepted" = the recipient's mail server took the message (the delivery proof).
- "opened" = a tracking pixel loaded: an INDICIO only, never proof of reading.
- "downloaded" = someone fetched an attachment through the per-recipient link.
- "acknowledged" = the recipient confirmed receipt on the recipient page.
- "bounced" | "complained" | "deferred" = say exactly that, and suggest the lawyer check the address.
Done when every recipient has a status line and a time, or you said why not.
Tips
- Read, don't infer: quote the timeline events, never guess a delivery that is not there.
- A "sent" notification with a recipient still "sent" (not "accepted") usually means the remote
server has not answered yet; minutes are normal, hours are worth mentioning.
- The constancia is issued after delivery events arrive — see
docs://recipes/download-evidence-for-a-perito to fetch it.