# Unlisted - agent instructions

unlisted.click files, clocks and re-checks your household's data-broker removals. One ledger, exportable, and readable by your agent over MCP.

## Connect

- MCP endpoint: `https://www.unlisted.click/mcp` (JSON-RPC 2.0, streamable HTTP, stateless).
- Public tools need no auth: `list_brokers`, `deadlines`, `pricing`.
- Account tools need `Authorization: Bearer <token>`. A human gets the token on the account page; it starts with `ul_`. See [auth.md](https://www.unlisted.click/auth.md).

## The one workflow

1. `list_brokers` - see the catalogue and pick a group.
2. `add_person` - name plus US state. The state sets the clock.
3. `queue_removals` - one case per broker.
4. File each request through the broker's own channel, then `record_filing` with the date and the broker's ticket number. That starts the statutory clock and sets the re-check date.
5. `recheck` on the re-check date. It fetches the case's listing URL and returns `present`, `absent`, `blocked`, `unknown`, or `channel-reachable` when no listing URL is on file. Record exactly what it returned.
6. `next_actions` tells you what is overdue; `export_ledger` gives the evidence file.

## Rules that keep the ledger honest

- Never mark a case `confirmed` on a broker confirmation page alone. `confirmed` means a later fetch returned 200 with no name match.
- A `blocked` result (403, 429, or a browser challenge) is not a removal and not a reappearance. Say so.
- `filed` needs a date and, where the broker gave one, its ticket number.
- One person's email address per person. Brokers send verification links to the address on the request.
- Dates are UTC ISO. `filed_at` is `YYYY-MM-DD`.

## What this service does not do

- It does not log into brokers on your behalf or solve their captchas.
- It does not promise a listing is gone. It records what the fetch returned.
- Unlisted is a filing and record-keeping service, not a law firm and not legal advice. It files the requests you authorise, records what happened, and shows you the receipts.