QuokkaPix agent guide

QuokkaPix is a browser-only image editor. Agents should use the page through browser automation or the in-browser window.QuokkaPixAgent API. There is no server processing API; image files must be uploaded through the browser and are processed locally.

Discovery

• llms.txt
• agents.md
• agent-manifest.json
• ARD ai-catalog.json
• QuokkaPix editor

Flow

1. Open the editor with agent=1 and the desired hash parameters.
2. Upload image files through [data-agent="file-picker"] or [data-agent-action="upload"].
3. Wait for .page-shell[data-agent-status="ready"].
4. Start with [data-agent="process-trigger"] or window.QuokkaPixAgent.start().
5. Poll .page-shell[data-process-status] or call window.QuokkaPixAgent.getState().
6. Wait for done, error or cancelled.
7. Download via [data-agent="download-link"][data-status="ready"] or [data-agent="zip-download-link"][data-status="ready"].

Runtime API

window.QuokkaPixAgent.getContract()
window.QuokkaPixAgent.getState()
window.QuokkaPixAgent.applySettings(payload)
window.QuokkaPixAgent.buildUrl(payload)
window.QuokkaPixAgent.start()
window.QuokkaPixAgent.cancel()
window.QuokkaPixAgent.clear()
window.QuokkaPixAgent.getPaymentPolicy()
window.QuokkaPixAgent.setUnlockToken(token)
window.QuokkaPixAgent.verifyUnlockToken()
window.QuokkaPixAgent.clearUnlockToken()
window.QuokkaPixAgent.getEvents()
window.QuokkaPixAgent.clearEvents()

Experimental WebMCP

When the browser exposes the draft document.modelContext.registerTool API, QuokkaPix registers browser-native WebMCP tools. This is an experimental layer, not a server MCP endpoint. If WebMCP is unavailable, use window.QuokkaPixAgent and stable data-agent selectors.

quokkapix.get_contract
quokkapix.get_state
quokkapix.get_payment_policy
quokkapix.apply_settings
quokkapix.set_unlock_token
quokkapix.start
quokkapix.cancel

Agent payments

Human UI, reward ads and normal user workflows are unchanged. Payments apply only in agent=1 mode. Single image agent runs and single image scenarios are free. Agent batch or batch scenario runs up to 50 files cost 0.01 USDC.

• Options: /api/agent-payment/options
• Coinbase x402 unlock: /api/agent-unlock/coinbase-x402
• Verify: /api/agent-unlock/verify

Paid unlock endpoints return a short-lived unlockToken. The token unlocks an agent batch/scenario run in the browser; image files are still uploaded through the browser file input and are not sent to a QuokkaPix processing server.

Stable selectors

[data-agent="file-picker"]
[data-agent="process-trigger"]
[data-agent="cancel-trigger"]
[data-agent="download-link"]
[data-agent="zip-download-link"]
[data-agent="preview-link"]
.page-shell[data-agent-status]
.page-shell[data-process-status]

Capabilities

Agents should read window.QuokkaPixAgent.getState().capabilities before choosing formats or background/GIF workflows. It exposes current browser export formats, worker support, background model status, GIF limitations and file limits.

Analytics

Agent events are stored locally and sent to Google Analytics through gtag when it is available. Events do not include file names, local paths, image contents or user-entered text.

Examples

https://quokkapix.com/#agent=1&tool=compress&quality=80&format=webp
https://quokkapix.com/#agent=1&mode=batch&tool=resize&resize-mode=fit&w=1200&h=1200&format=webp
https://quokkapix.com/#agent=1&mode=batch&tool=constructor&steps=resize|compress|convert&w=1600&quality=78&format=webp