# Use TokenWatch with your agent.

[TokenWatch](https://tokenwatch.wyrdwerk.com/) (`tokenwatch.wyrdwerk.com`) registers 21 WebMCP tools. 7 of 21 tools declares `readOnlyHint`, so an agent can invoke them through `tools.call`. The registry runs the tool in a fresh headless page on tokenwatch.wyrdwerk.com and returns untrusted site content.

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

## Use TokenWatch 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":"tokenwatch.wyrdwerk.com"}' --json
```

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

```
ghostget webmcp tools.call --input '{"domain":"tokenwatch.wyrdwerk.com","tool":"about_tokenwatch","input":"{}"}' --json
```

## Registered WebMCP tools

TokenWatch publishes 21 tools on tokenwatch.wyrdwerk.com; 7 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `about_tokenwatch` | Read-only. Returns the TokenWatch WebMCP operating brief (rules and page capability map) plus the URL of the full skill. Call this before ranking, filtering, or comparing so you use {provider, id} identity and the live table correctly. | Callable read-only tool |
| `apply_preset` | Applies a named mix preset (agentic, balanced, heavy-output, no-cache) and re-renders the table. Does not change filters. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `clear_filters` | Resets search, ZDR, subscription, promo, group-by, min-intelligence/coding/agentic, benchmarked-only, hide-batch (back to on), cache-only, max blended, min tok/s, and HQ filters. Keeps the current workload. Re-renders the table. For operati | Listed for discovery; the registry allows read-only calls only |
| `compare_models` | Add, remove, clear, or set the compare tray (max 6). Identity is {provider, id} from get_view, never a rank. Optionally open the side-by-side compare modal. Re-renders the table and tray. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `download_cost_card` | Triggers a PNG download of the cost card for one offering in the current view. In-app browsers may block the download; use get_share_url as a fallback. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `explain_ranking` | Read-only deterministic explanation of why the current #1 ranks ahead of #2 using the table's active sort and direction (cost, blended rate, speed, prices, context, provider, org, or model name). Includes the active ranking metric, ranking | Callable read-only tool |
| `export_csv` | Triggers a CSV download of the current ranked results (same as the Export CSV button). In-app browsers may block the download; the result still reports filename and rowCount. Prefer get_share_url if the file does not appear. For operational | Listed for discovery; the registry allows read-only calls only |
| `get_catalog_info` | Read-only. Page name, pricing.json generated_at, and catalog size. Use this instead of inventing how fresh the data is. For operational details, call about_tokenwatch. | Callable read-only tool |
| `get_model` | Read-only detail for one offering in the current view: pricing, context, cache, ZDR/subscription, benchmarks, Neuralwatt energy if present, speedP50, and ttftP50 (seconds). Requires {provider, id} from get_view. For operational details, cal | Callable read-only tool |
| `get_share_url` | Read-only. Returns the current page URL including the hash of mix/filters so the human can open the same view in any browser without ChatGPT. For operational details, call about_tokenwatch. | Callable read-only tool |
| `get_view` | Read-only snapshot of the TokenWatch text calculator the human is looking at: current mix, modes, filters, active sort, compare tray, rowCount, and the top ranked offerings (rank, provider, id, name, cost, blended $/M, zdr, speedP50, ttftP5 | Callable read-only tool |
| `highlight_tradeoff` | Fills the compare tray with cheapest / fastest / ZDR-cheapest / smartest (highest AA intelligence with a score) from the current view and opens the compare modal. Re-renders the table. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `list_presets` | Read-only list of named mix presets (agentic, balanced, heavy-output, no-cache) with their token mix. Use apply_preset to apply one — that re-renders the table. For operational details, call about_tokenwatch. | Callable read-only tool |
| `open_detail` | Opens the detail modal for one offering that is in the current view (pricing, benchmarks, Neuralwatt energy). Requires {provider, id} from get_view. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `set_cache_write` | Sets the one-time cache-write volume (millions of tokens) and amortization N, then re-renders the table. Included in Total Cost. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `set_filters` | Partial update of filters: provider search, model search, ZDR only, subscription only, promos only, group-by, min intelligence/coding/agentic, benchmarked only, hideBatch (default true), cacheOnly, maxBlended $/M, minToks, hq country. Re-re | Listed for discovery; the registry allows read-only calls only |
| `set_sort` | Sets the active table sort and direction, then re-renders the same results. Sortable columns: org, provider, model, input, output, cache_read, context, speed, ttft, intelligence, coding, agentic, blended, and cost. Text fields sort alphabet | Listed for discovery; the registry allows read-only calls only |
| `set_use_case` | Switches the Benchmarks page use-case tab (agentic, reasoning, knowledge, ui_quality) and re-renders. This changes which score columns and Value metric are active. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `set_workload` | Sets tokens or budget, input/cache/output mix, per-session vs monthly, and forward vs budget mode. Re-renders the results table. Mix percentages must sum to 100 (±0.5); they are not silently renormalized. Partial updates are allowed. For op | Listed for discovery; the registry allows read-only calls only |
| `snapshot_compare` | Opens the compare modal (needs ≥2 selected) and triggers a PNG download of the comparison card. In-app browsers may block the download; use get_share_url as a fallback. For operational details, call about_tokenwatch. | Listed for discovery; the registry allows read-only calls only |
| `switch_catalog` | Navigates to another TokenWatch catalog (text, image, video, benchmarks). The next page may register a thinner tool set. This leaves the current page. For operational details, call about_tokenwatch. | 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 TokenWatch changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on tokenwatch.wyrdwerk.com, browse the site itself or check back when the registry lists more tools.