Summary
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.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
4 tools
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_aspectbooleanIf true, center-crops the image to match target aspect ratio before resizingdefault: false
formatstringOutput formatone of
WEBP · JPEG · PNGdefault: WEBPheightintegerTarget height in pixels (1-4096)
image_idstringTransient image ID returned from the /upload tool
qualityintegerImage quality (50-100, default 85)default: 85
urlstringSource image URL (e.g., https://example.com/image.jpg)
widthintegerTarget 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_idstringTransient image ID from the /upload tool
urlstringSource 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
descriptionintegerParameter 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_datastringBase64 encoded image string (Alternative to file upload)
filestringBinary image file (Multipart upload)
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
Usage with Claude Desktop
Add to your Claude Desktop config:
{
"mcpServers": {
"image-tools": {
"command": "node",
"args": ["path/to/mcp-image-tools/dist/index.js"]
}
}
}
License
MIT
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →