rog0x avatar

Image

rog0x/mcp-image-tools

Provides five tools for working with images without downloading or processing them. You get metadata extraction via HTTP headers, favicon discovery across multiple sources (HTML links, manifest.json, and fallback routes), Open Graph and Twitter card image extraction for link previews, placeholder generation through the placehold.co API with customizable dimensions and colors, and responsive image markup generation with srcset and picture elements. Useful when you need to inspect what images a site uses, grab icons and preview images for card layouts, or generate boilerplate HTML for responsive designs. Metadata only, so it's fast and doesn't touch image data itself.

tools
4
transport
STDIO
last updated
Mar 22, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

resizeDeterministic image resizing. Only downsizing is supported. Cost: 0.002 USDC7 params

Deterministic image resizing. Only downsizing is supported. Cost: 0.002 USDC

Parameters* required
crop_to_aspectboolean
If true, center-crops the image to match target aspect ratio before resizingdefault: false
formatstring
Output formatone of WEBP · JPEG · PNGdefault: WEBP
heightinteger
Target height in pixels (1-4096)
image_idstring
Transient image ID returned from the /upload tool
qualityinteger
Image quality (50-100, default 85)default: 85
urlstring
Source image URL (e.g., https://example.com/image.jpg)
widthinteger
Target width in pixels (1-4096)
identifyExtracts format, mode, dimensions, and EXIF metadata from an image. Cost: 0.001 USDC2 params

Extracts format, mode, dimensions, and EXIF metadata from an image. Cost: 0.001 USDC

Parameters* required
image_idstring
Transient image ID from the /upload tool
urlstring
Source image URL to identify
feature-requestSubmit a feature request. Free but throttled to 1 request per agent per 24h. Cost: 0.000 USDC1 params

Submit a feature request. Free but throttled to 1 request per agent per 24h. Cost: 0.000 USDC

Parameters* required
descriptioninteger
Parameter description
uploadStages an image for processing. Returns an image_id valid for 1 hour. Cost: 0.001 USDC2 params

Stages an image for processing. Returns an image_id valid for 1 hour. Cost: 0.001 USDC

Parameters* required
base64_datastring
Base64 encoded image string (Alternative to file upload)
filestring
Binary image file (Multipart upload)

Sponsors

Readme

mcp-image-tools

MCP server providing image analysis tools for AI agents. Metadata inspection only -- no image processing or manipulation.

Tools

image_metadata

Read image metadata from a URL using HTTP headers. Returns content-type, file size, last-modified, etag, and cache info without downloading the full image.

find_favicons

Find all favicons for any website. Checks /favicon.ico, parses HTML <link> tags, and inspects manifest.json. Returns all discovered favicons with sizes and types.

extract_og_image

Extract Open Graph image, Twitter card image, and Apple touch icon from any URL. Useful for generating link previews.

generate_placeholder

Generate placeholder image URLs via the placehold.co API. Supports custom dimensions, colors, text, format, and font. Returns the URL plus ready-to-use HTML and Markdown markup. Can generate multiple sizes at once.

responsive_images

Generate srcset and <picture> element HTML for responsive images. Given a base image URL, produces multiple size variants with proper markup for responsive design, including multi-format <source> elements.

Setup

npm install
npm run build

View the full README on GitHub

Details

Repository
github.com/rog0x/mcp-image-tools
Package
@rog0x/mcp-image-tools
Transport
STDIO
Registry
MCP registry, active

More from rog0x