# Use QuokkaPix with your agent.

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

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

## Use QuokkaPix 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":"quokkapix.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":"quokkapix.com","tool":"quokkapix.get_contract","input":"{}"}' --json
```

## Registered WebMCP tools

QuokkaPix publishes 15 tools on quokkapix.com; 10 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `quokkapix.apply_recipe` | Applies an official recipe id or custom recipe JSON to configure a local browser workflow. Files must still be uploaded through the browser input. This does not start processing. | Listed for discovery; the registry allows read-only calls only |
| `quokkapix.apply_settings` | Applies browser-agent settings for mode, tool, scenario steps and tool options. Files must still be supplied through the browser file input or dropzone. | Listed for discovery; the registry allows read-only calls only |
| `quokkapix.cancel` | Cancels the current QuokkaPix browser-side processing run. | Listed for discovery; the registry allows read-only calls only |
| `quokkapix.get_contract` | Returns the QuokkaPix browser-agent contract, supported image tools, DOM selectors, payment policy and local browser processing constraints. | Callable read-only tool |
| `quokkapix.get_payment_policy` | Returns the Image, PDF, scenario, Video and transcription agent pricing rules and product-specific x402 policy. | Callable read-only tool |
| `quokkapix.get_payment_quote` | Counts expanded archive files and PDF pages locally, then returns the exact free or paid tier without starting processing. | Callable read-only tool |
| `quokkapix.get_recipe` | Returns one official QuokkaPix recipe by id. The recipe includes applySettings JSON, limits, payment requirement and expected result manifest contract. | Callable read-only tool |
| `quokkapix.get_result_manifest` | Returns a machine-readable browser-local processing result, source and output dimensions when available, warnings, capabilities and stable error code. | Callable read-only tool |
| `quokkapix.get_rule_profile` | Returns one sourced platform image requirement profile by id, including requirements, recommendations, source URL, source type and confidence. | Callable read-only tool |
| `quokkapix.get_state` | Returns current browser-side processing state, selected tool, upload mode, file count, progress, output metadata and payment state. | Callable read-only tool |
| `quokkapix.list_recipes` | Returns official QuokkaPix browser-local image workflow recipes such as Shopify product pack, Amazon white background pack, metadata clean batch and website WebP compression. | Callable read-only tool |
| `quokkapix.list_rule_profiles` | Returns sourced marketplace and social image requirement profiles used by QuokkaPix QA reports. Secondary sources are marked explicitly. | Callable read-only tool |
| `quokkapix.set_unlock_token` | Stores a short-lived x402 unlock token returned by QuokkaPix payment endpoint. The token is verified and consumed when a paid agent batch run starts. | Listed for discovery; the registry allows read-only calls only |
| `quokkapix.start` | State-changing action: after local upload and exact quote, starts the selected browser workflow. A required product token is consumed only immediately before processing begins. | Listed for discovery; the registry allows read-only calls only |
| `quokkapix.validate_recipe` | Validates a recipe id or custom recipe object before applying it. This does not upload files and does not start processing. | 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 QuokkaPix changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on quokkapix.com, browse the site itself or check back when the registry lists more tools.
