About atx-mcp
atx-mcp is an MCP server published by gridhra in the Files category: deterministic, non-generative image transform MCP server: reproducible recipes, immutable originals.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
Claude Code
claude mcp add atx-mcp -- npx -y atx-mcpnpx
npx -y atx-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (13)
apply_transformApply a recipe (or a `preset`) at full resolution and produce a new revision (the same recipe always yields the same revision). Takes `revision_id` for one image or `revision_ids` to run the same recipe over a batch of up to 64
Parameters not published.
compare_revisionsDownscale two revisions to long edge ≤640 and return them composited into a single inline image, arranged via `layout:"side_by_side"\
Parameters not published.
detect_documentFind the dominant quadrilateral (page, screen, whiteboard, sign) via Canny + contours and return it as a `perspective`-ready `quad` (tl, tr, br, bl) with `confidence`, `area_ratio`, an `output_size_hint` and a paste-ready `suggested_operation`. Returns `quad:null` with a reason (`no_quad_found` / `already_rectified` / `low_confidence`) rather than guessing (read-only)
Parameters not published.
detect_text_blocksFind the text-like blocks (headline, paragraphs, table, caption) via Otsu binarization + run-length smearing + connected components, in reading order, each with `line_count`, `median_line_height_px` and `ink_ratio`. `legibility.line_height_at_1568_px` says whether the text survives a downscale to long edge 1568 (below ~16px it usually does not), and `legibility.recommended_bands` splits the image into horizontal bands that clear that bar — each entry is already a `crop` operation to paste before `render_preview` (read-only)
Parameters not published.
detect_tiltEstimate tilt angle via Canny+Hough (coarse) plus a projection profile (sub-0.1° refinement). Also returns horizontal/vertical family estimates; the full score curve is opt-in via `include_score_curve:true`. Returns "do not correct" when confidence is low (read-only)
Parameters not published.
explain_operationFull reference for one operation: parameter table (type, range, required/default, semantics), ready-to-paste JSON examples and gotchas. A built-in preset name works too and returns its full operation list. An unknown name returns the valid operations and presets, grouped (read-only)
Parameters not published.
export_assetWrite revisions out of the workspace: `revision_id` + `dest_path` for one file, or `revision_ids` + `dest_dir` for up to 64 at once, named by `filename_template` (default `"{revision_id}.{ext}"`, also `{index}` / `{stem}`). An existing file is only overwritten when `overwrite:true` is explicitly set, and it never writes inside the workspace store or through a symbolic link
Parameters not published.
generate_maskGenerate a deterministic grayscale mask (`linear_gradient` / `radial_gradient` / `luminosity_range` / `color_range`) as a PNG revision with the same dimensions as the reference image, to be referenced from an operation's `mask` field (idempotent)
Parameters not published.
import_assetImport a local image into the workspace (sha256-idempotent). Takes `path` for one file or `paths` for a batch of up to 64 (a failing file does not abort the batch). Warns via `already_derived_from` when the bytes are already the output of a recipe in this workspace
Parameters not published.
inspect_imageInspect dimensions, EXIF summary, ICC profile, presence of GPS data, luma statistics, a `sharpness` score (variance of the Laplacian — relative, so compare it against a known-good capture of the same subject) and a `perceptual_hash` (dHash, 16 hex digits) for "is this the same picture?". `include_exif:true` additionally returns every EXIF field as `{ifd, tag, value}` entries — off by default because the full dump can carry GPS coordinates and names (read-only)
Parameters not published.
Show all 13 tools
list_assetsRead the revision ledger (read-only)
Parameters not published.
list_operationsCompact catalog of the recipe vocabulary: every operation with a one-line description and terse parameter hints, plus the built-in preset names. Optional `category:"geometry"\
Parameters not published.
render_previewApply a recipe (or a `preset`) at low resolution (long edge ≤768 by default, `long_edge` 256..1568 to hand a vision model a legible page) and return it as an inline image. `overlay:"grid"\
Parameters not published.
Ask AI
✦
Ask AI about atx-mcp
Powered by Claude · Grounded in docs
I know everything about atx-mcp. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
6 checks have not been run yet.