Log inSubmit server
Image Tiler MCP Server logo

Image Tiler MCP Server

by keiver

Tiles large images and web-page captures into model-specific vision inputs with token estimates and content hints.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Image Tiler MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "keiver-image-tiler-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "image-tiler-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The keiver/image-tiler-mcp-server MCP server tiles local or remote images and full web-page screenshots for detailed vision analysis. Its `tiler` tool first compares Claude, OpenAI, Gemini, and Gemini 3 presets, then creates tiles after the user selects a preset. Web capture uses headless Chrome, including mobile emulation and lazy-load scrolling. Reach for it when image downscaling could hide layout, diagram, or design details.

Use cases

  • Inspect full-page screenshots for layout and styling defects
  • Test responsive pages at a mobile viewport
  • Analyze diagrams and infographics at native detail
  • Compare visual changes across repeated captures

Key features

  • Model-specific image tiling presets
  • Full-page Chrome screenshot capture
  • Entropy-based tile detail classification
  • Interactive HTML tile previews
  • WebP or PNG tile output
  • Mobile viewport and retina capture

Tools1

What Image Tiler MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

22/22 checks healthy over the last 91d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · image-tiler-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads89Package downloads in the last 30 days.
Last commit8mo agoMost recent push to the default branch.
Tools exposed1Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Image Tiler MCP Server works

What keiver/image-tiler-mcp-server MCP server does

The keiver/image-tiler-mcp-server MCP server exposes one MCP tool, tiler, for preparing large visual inputs for language models. It accepts local files, remote image URLs, data URLs, base64 content, and web-page URLs. For a web page, it uses Chrome to produce a full-page screenshot before processing it.

The server is suited to visual QA, responsive-layout checks, diagrams, infographics, design mockups, and other images where a model's normal resizing could remove useful detail. It can also return only a captured screenshot when tiling is not needed.

How it works

Use the tool in two calls. The first call provides only the image source, such as filePath, sourceUrl, or url. It returns an output directory, and for image inputs it presents a comparison of the available presets with tile counts and estimated token use. The user must choose the preset rather than having the workflow silently select one.

The second call repeats the source and supplies the selected preset plus the output directory. For a web capture, use the screenshot path returned by the first call. This phase returns tile metadata, a summary, and content hints rather than embedding every tile immediately. Request only the needed tile range from the tile directory; tiles are returned as inline base64 images and can consume substantial context.

The four presets are claude with 1092-pixel tiles and about 1590 tokens per tile, openai with 768-pixel tiles and about 765 tokens, gemini3 with 1536-pixel tiles and about 1120 tokens, and gemini with 768-pixel tiles and about 258 tokens. Images larger than 10,000 pixels are downscaled by default. Output is WebP unless PNG is requested.

Setup and configuration

The keiver/image-tiler-mcp-server MCP server requires Node.js 20 or newer. The package can be run directly with npx -y image-tiler-mcp-server, installed globally with npm, built from the repository, or run in Docker. It uses the standard stdio transport, so the MCP client configuration supplies the command and arguments.

Named setup examples are provided for Claude Code, Codex CLI, VS Code with Cline or Continue, Cursor, and Claude Desktop. A Docker deployment must use interactive stdin, mount directories that the server reads or writes, and can set TILER_ALLOWED_DIRS to limit accessible paths. Docker includes Chromium for URL capture. TILER_DISABLE_URL_CAPTURE=1 disables that feature, while CHROME_NO_SANDBOX=0 re-enables Chrome's sandbox when the container environment supports it.

Tools and capabilities

  • tiler: tile an image or capture and tile a web page.
  • Compare model presets before committing to a tiling strategy.
  • Classify tiles by visual detail, including blank, low-detail, mixed, and high-detail results.
  • Generate an interactive HTML preview with model-specific grids and token estimates.
  • Capture full pages by scrolling through lazy-loaded content and stitching sections beyond 16,384 pixels.
  • Capture mobile layouts using a 390-pixel viewport, 2x retina scale, and a mobile Safari user agent.
  • Save results in versioned output directories for repeated capture-and-review workflows.

Limitations and notes

URL capture requires Chrome. The OpenAI preset targets the GPT-4o and o-series vision pipeline; GPT-4.1 is not supported by that configuration. Gemini 3 has a fixed token budget per image, so tiling can increase total token use even though it preserves local detail.

Do not request every tile by default. The second-phase summary and content hints are intended to help the agent skip blank or irrelevant regions. Each returned image tile can cost roughly 258 to 1590 tokens depending on the selected preset.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Image Tiler MCP Server

keiver/image-tiler-mcp-server is an MCP server that connects AI clients to local files, remote images, data URLs, base64 images, and web pages captured through Chrome. Its main `tiler` tool compares vision presets, creates model-sized image tiles, returns metadata and content hints, and can provide selected tiles for detailed analysis.

Install it by running `npx -y image-tiler-mcp-server` from your MCP client configuration. You can also install it globally with npm, build it from source, or build and run the supplied Docker image. Node.js 20 or newer is required for the package.

Yes, it works with Cursor through a stdio MCP configuration. Add an `image-tiler` entry to `~/.cursor/mcp.json` with `npx` as the command and `-y image-tiler-mcp-server` as its arguments.

Provide the page URL in the first `tiler` call, then use the returned screenshot path, output directory, and user-selected preset in the second call. Chrome is required, and the capture can scroll through lazy-loaded content, stitch long pages, or emulate a mobile viewport.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewImage Tiler MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/keiver-image-tiler-mcp-server?style=directory)](https://allmcps.com/mcp/keiver-image-tiler-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/keiver-image-tiler-mcp-server"><img src="https://allmcps.com/api/badge/keiver-image-tiler-mcp-server?style=directory" alt="Image Tiler MCP Server on AllMCPs" /></a>