# Use PixelVault with your agent.

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

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

## Use PixelVault 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":"pixelvault.dev"}' --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":"pixelvault.dev","tool":"pixelvault_api_overview","input":"{}"}' --json
```

## Registered WebMCP tools

PixelVault publishes 2 tools on pixelvault.dev; 2 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `pixelvault_api_overview` | Explain how to use the PixelVault image-hosting API: register for a key, upload an image, apply transforms, and connect the MCP server. Returns the endpoints, auth model, and free-tier limits. | Callable read-only tool |
| `pixelvault_build_transform_url` | Given a PixelVault CDN image URL (https://img.pixelvault.dev/...), append on-the-fly transform parameters and return the ready-to-use URL — no re-upload or API call. Params: w, h, fit (scale-down\|contain\|cover\|crop\|pad), fmt (auto\|webp\|avif | Callable read-only tool |

## 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 PixelVault changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on pixelvault.dev, browse the site itself or check back when the registry lists more tools.