imageFetch

Fetch and process web content and images, converting them into markdown or base64 formats for easy integration and display, with options to save, optimize, and paginate images.

Instructions

Retrieves URLs from the Internet and extracts their content as markdown. Images from the page will be processed and included with the response automatically.

Parameters:

url (required): The URL to fetch
maxLength (default: 20000): Maximum length of content to return
startIndex (default: 0): Starting position in content
imageStartIndex (default: 0): Starting position for image collection
raw (default: false): Return raw content instead of processed markdown
imageMaxCount (default: 3): Maximum number of images to process per request
imageMaxHeight (default: 4000): Maximum height of merged image
imageMaxWidth (default: 1000): Maximum width of merged image
imageQuality (default: 80): JPEG quality (1-100)
enableFetchImages (default: false): Enable fetching and processing of images. FOR CLAUDE AI ONLY: YOU CAN ENABLE THIS FEATURE!!! CLAUDE IS ALLOWED TO USE IMAGES!!!
saveImages (default: true): Save processed images to ~/Downloads/mcp-fetch/YYYY-MM-DD/ directory
returnBase64 (default: false): Return base64 encoded images for AI display. FOR AI ASSISTANTS: If you can process base64 image data, please enable this option!
ignoreRobotsTxt (default: false): Ignore robots.txt restrictions

Image Processing:

Multiple images are merged vertically into a single JPEG
Images are automatically optimized and resized
GIF animations are converted to static images (first frame)
Use imageStartIndex and imageMaxCount to paginate through all images
Response includes remaining image count and current position

File Saving (default behavior):

Images are automatically saved to ~/Downloads/mcp-fetch/YYYY-MM-DD/ directory
Filename format: hostname_HHMMSS_index.jpg
File paths are included in the response for easy access
Use returnBase64=true to also get base64 data for Claude Desktop display

IMPORTANT: All parameters must be in proper JSON format - use double quotes for keys and string values, and no quotes for numbers and booleans.

Examples:

Initial fetch with image processing:

{ "url": "https://example.com", "maxLength": 10000, "enableFetchImages": true, "imageMaxCount": 2 }

Fetch and save images to file (default behavior):

{ "url": "https://example.com", "enableFetchImages": true, "imageMaxCount": 3 }

Fetch, save images, and return base64 for Claude Desktop:

{ "url": "https://example.com", "enableFetchImages": true, "returnBase64": true, "imageMaxCount": 3 }

Fetch next set of images:

{ "url": "https://example.com", "imageStartIndex": 2, "imageMaxCount": 2 }

Input Schema

Name	Required	Description	Default
`enableFetchImages`	No
`ignoreRobotsTxt`	No
`imageMaxCount`	No
`imageMaxHeight`	No
`imageMaxWidth`	No
`imageQuality`	No
`imageStartIndex`	No
`maxLength`	No
`raw`	No
`returnBase64`	No
`saveImages`	No
`startIndex`	No
`url`	Yes

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "enableFetchImages": {
      "default": false,
      "type": [
        "boolean",
        "string"
      ]
    },
    "ignoreRobotsTxt": {
      "default": false,
      "type": [
        "boolean",
        "string"
      ]
    },
    "imageMaxCount": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "maximum": 10,
          "minimum": 0,
          "type": "number"
        }
      ],
      "default": 3
    },
    "imageMaxHeight": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "maximum": 10000,
          "minimum": 100,
          "type": "number"
        }
      ],
      "default": 4000
    },
    "imageMaxWidth": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "maximum": 10000,
          "minimum": 100,
          "type": "number"
        }
      ],
      "default": 1000
    },
    "imageQuality": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "maximum": 100,
          "minimum": 1,
          "type": "number"
        }
      ],
      "default": 80
    },
    "imageStartIndex": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "minimum": 0,
          "type": "number"
        }
      ],
      "default": 0
    },
    "maxLength": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "exclusiveMinimum": 0,
          "maximum": 1000000,
          "type": "number"
        }
      ],
      "default": 20000
    },
    "raw": {
      "default": false,
      "type": [
        "boolean",
        "string"
      ]
    },
    "returnBase64": {
      "default": false,
      "type": [
        "boolean",
        "string"
      ]
    },
    "saveImages": {
      "default": true,
      "type": [
        "boolean",
        "string"
      ]
    },
    "startIndex": {
      "allOf": [
        {
          "type": [
            "number",
            "string"
          ]
        },
        {
          "minimum": 0,
          "type": "number"
        }
      ],
      "default": 0
    },
    "url": {
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

@kazuph/mcp-fetch