Developer documentation

Build on the public Toolako catalog. The six ready image tools are compress, resize, crop, rotate and flip, convert, and watermark.

Ready tools

Tool catalog and schemas

The catalog lists localized descriptions, strict input and options JSON Schemas, result schemas, formats, limits, and execution requirements. Every listed operation runs in the user’s browser; the catalog service does not process images.

Open tools.jsonMarkdown API guide

Where tools run

The public site and hosted MCP catalog provide documentation and metadata only. Image pixels are processed in the browser on the user’s device. For AI clients, browser-agent access works only when the agent is authorized to use the active workbench tab. The local MCP companion starts a local browser and uses the same browser engine; a cloud-only MCP client cannot access files on the user’s device.

Batch limits

Each operation accepts one image in the ordinary workbench flow. The separate local MCP batch tools accept up to 50 images per import, with a 20 MiB per-file and 100 MiB aggregate input limit (including an optional shared logo). Images are limited to 16 megapixels and 8,192 pixels per side; retained batch outputs have a 100 MiB aggregate limit.

Privacy and data flow

The hosted catalog does not accept image bytes, Base64 data, local paths, or image URLs. Browser processing stays local. When using an AI provider, selected filenames or paths, tool arguments, and returned metadata may be visible to that provider; image pixels are not included by default. Local MCP import and export use the roots configured by the user.

Local MCP setup

Install the project’s local companion and configure allowed input and output directories in your MCP host. It uses stdio and launches a fresh local browser. See the setup guide for the exact command and host configuration.

  • Requires Node.js 22.23.4. Install dependencies with npm ci, and install Chromium with npx playwright install chromium.
  • Build the browser runner and local MCP companion with: npm run build:workbench, npm run build:runner, npm run build --workspace @local-image-tools/mcp-local.
  • Set LOCAL_IMAGE_INPUT_ROOTS to a path-delimited list of allowed input directories and LOCAL_IMAGE_OUTPUT_ROOT to the output directory. Configure your MCP host to run this command over stdio: node /absolute/path/to/packages/mcp-local/dist/cli.js

Read setup guide