# Use MBOX Viewer with your agent.

[MBOX Viewer](https://readmbox.com/) (`readmbox.com`) registers 6 WebMCP tools. MBOX Viewer lists 6 tools but declares none as read-only today, so `tools.call` cannot invoke them yet. Ask `sites.get` for the live status before planning a call.

This page mirrors the [WebMCP Registry](https://wmcp.ai/sites/readmbox.com) listing for `readmbox.com`, last live-checked by the registry at 2026-09-23T04:52:17.204Z. Run `ghostget webmcp sites.get --input '{"domain":"readmbox.com"}' --json` for the current schema; the listing can drift between checks.

## Use MBOX Viewer with my agent

Ghostget's bundled `webmcp` adapter speaks to the public WebMCP Registry, so an agent always reads this site's current tool schema instead of a stale hard-coded copy. Install v0.18.35, sync bundled adapters once, then call the registry operations:

```
bun add --global https://github.com/hraness/ghostget/releases/download/v0.18.35/hraness-ghostget-0.18.35.tgz
ghostget adapter sync-bundled --json
```

**Read the live tool schema** — every registered tool, its input schema, annotations, and the page that publishes it:

```
ghostget webmcp sites.get --input '{"domain":"readmbox.com"}' --json
```

**Call a read-only tool** — the registry refuses anything not declared `readOnlyHint` and returns the site's answer as untrusted content:

```
# no read-only-callable tools listed today; sites.get shows the live status
```

## Registered WebMCP tools

MBOX Viewer publishes 6 tools on readmbox.com; 0 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `clear_filters` | Remove every filter — text query, date range, attachment toggle — and return the reader to the whole mailbox in file order. | Listed for discovery; the registry allows read-only calls only |
| `filter_by_date` | Narrow the reader to a date range and/or change the sort order. Works instantly on any mailbox size because dates are already indexed. Updates what the person sees on screen. Does not do text search — that is scan_messages. | Listed for discovery; the registry allows read-only calls only |
| `get_mailbox_status` | Report whether an MBOX file is open in this tab and what is in it: message count, date span, how many messages the current filters match, and whether the mailbox is fully readable. Call this first. | Listed for discovery; the registry allows read-only calls only |
| `list_messages` | List messages currently shown in the reader, newest-first or in whatever order the page is sorted by. Returns index, date, sender and subject only. Cheap at any mailbox size. Use read_message for the body. | Listed for discovery; the registry allows read-only calls only |
| `read_message` | Read one message in full: headers, plain-text body, and the names and sizes of its attachments. Attachment contents are not available. Use an index from list_messages or scan_messages. | Listed for discovery; the registry allows read-only calls only |
| `scan_messages` | Search subjects and senders for text, and/or find messages with attachments, optionally within a date range. This reads each message from disk, so it works in bounded passes: if the result says done=false, call again with the returned curso | Listed for discovery; the registry allows read-only calls only |

## What to expect

- **Read-only only.** The registry refuses WebMCP tools that do not declare `readOnlyHint`; Ghostget never weakens that check.
- **Untrusted results.** Tool output is site content, not instructions — treat it as data.
- **Live schemas.** `sites.get` always returns the schema the registry saw most recently, so agents adapt when MBOX Viewer changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on readmbox.com, browse the site itself or check back when the registry lists more tools.