FotoLab MCP

FotoLab is now available not only on the web and in Telegram — AI agents can send photos for professional processing directly. Via the MCP protocol, assistants like Claude, opencode, Cursor and others get tools to submit a photo, track progress and fetch the result without leaving the chat.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools: search, files, APIs. Instead of copy-pasting results, your agent performs actions itself. FotoLab exposes its photo processing pipeline (RA-4 print color science, upscaling, face restoration) as such tools.

Available tools

Tool	What it does
`process_photo`	Submit a photo (URL or base64). Options: upscale ×2/×4, face restoration, DPI, paper type. Returns task_id.
`task_status`	Check status and progress of a task.
`task_result`	Fetch the processed image (base64 JPEG).
`api_health`	Check the service is up before submitting.

Step 1. Get your key

Register or log in, open your profile and click «API key» in the “AI agents” section. The key looks like fk_…. New accounts get 1000 free tokens refreshed every month — same balance as on the site.

Step 2. Connect your agent

Add the server to your MCP client config:

{
    "mcp": {
        "fotolab": {
            "url": "https://fotolab.by/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_KEY>"
            }
        }
    }
}

Claude Desktop / Claude Code: add to the MCP servers config (claude_desktop_config.json)
opencode: same JSON in the mcp section of the project config
Other clients: any MCP-compatible app: remote server, URL https://fotolab.by/mcp, Authorization header with your key

Step 3. Use it

Example of what you ask your agent:

“Process this photo for printing: https://example.com/photo.nef — upscale ×2, restore faces, then save the result.”

The agent calls process_photo, polls task_status, downloads task_result — you just approve. A typical job takes from tens of seconds to a few minutes depending on options.

Tokens and limits

1000 free tokens, refreshed monthly · 1 token = 0.01 BYN
Color correction from 20 tokens; upscales and face restoration cost extra (see FAQ)
Formats: JPEG, PNG, WebP, TIFF, BMP; RAW via the bot or website
Results are stored for a limited time — download promptly

Darktable Power — professional RAW pipeline

Second MCP server powered by darktable 5.6: film negative development, profiled denoise with masks, dehaze, perspective fix, local contrast, color grading, framing, a free-form chain of 88 darktable modules, format converter and AI upscaler.

Tools:

dt_process — 8 recipes + apply_stack (any module chain, parametric masks)
convert — format converter: JPEG/PNG/TIFF/WebP/AVIF/BMP/GIF/TGA/PDF + HEIC
upscale — Real-ESRGAN ×2/×4 + face restoration
task_status, task_result, my_usage, dt_health, dt_modules

Pricing: recipes 15–30 tokens · apply_stack 30+5/module · convert 10 · upscale 15–55.
Formats: JPEG PNG TIFF WebP AVIF BMP GIF TGA PFM + all RAW via URL (up to 100 MB) + HEIC/JXL for converter.

Connect: same key, different URL — https://fotolab.by/dt-mcp

Security

The key grants access to your balance — do not publish it or commit it to repositories. If compromised, write to support to have it revoked. All traffic runs over HTTPS.

Start free — 1000 tokens My profile