Agent integration

QuokkaPix MCP Runner

A local MCP adapter for Claude Desktop, Cursor, LM Studio/Ollama wrappers and other agents. It opens QuokkaPix in a local browser, processes local files and writes quokkapix-result.json.

agents.html agent-test.html GitHub

What agents can do

Run official recipes such as Shopify, Amazon, Google Merchant, metadata cleanup and social packs.
Run direct custom settings with process_with_settings, using the same payload as window.QuokkaPixAgent.applySettings.
Validate result manifests and get QA checks for formats, dimensions, size limits and ZIP contents.
Read x402 payment options and verify unlock tokens for paid agent batch runs.
Upload optional local asset files for logo watermarks and background-image replacement.

MCP tools

list_recipesget_recipevalidate_recipevalidate_result_manifestprocess_imagesprocess_with_settingsget_payment_optionsexplain_payment_flowverify_unlock_token

Setup

{
  "mcpServers": {
    "quokkapix": {
      "command": "npx",
      "args": [
        "quokkapix-mcp"
      ],
      "env": {
        "QUOKKAPIX_APP_URL": "https://quokkapix.com/#agent=1"
      }
    }
  }
}

Examples

{
  "settings": {
    "mode": "single",
    "tool": "compress",
    "settings": {
      "compress": {
        "format": "webp",
        "quality": 0.82
      }
    }
  },
  "inputFiles": [
    "/Users/me/photo.jpg"
  ],
  "outputDir": "/Users/me/quokkapix-output"
}

Important notes

Images still enter through the local browser file input. QuokkaPix does not expose a public server-side processing API.