# img-src-io

> img-src-io is an open-source MCP server for design and media. MCP server connecting AI assistants to your img-src.io image hosting account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, VS Code, JetBrains, macOS, Windows, Linux
- **Repository:** https://github.com/img-src-io/mcp
- **MCP Registry name:** io.github.img-src-io/mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [mcp data access](https://ai-powered.com/categories/mcp-data-access), [image processing](https://ai-powered.com/categories/image-processing)
- **Listing updated:** 2026-11-21

## About

Gives AI assistants such as Claude, Cursor and VS Code Copilot direct access to an img-src.io image hosting account. Once configured with an API key, an assistant can upload images from a local file, URL or base64 data, organise them into folder paths, search and list the library, and read metadata for individual files.

Beyond file management, the server can generate CDN links with on-the-fly resizing, cropping fit modes, quality settings and output formats such as WebP, AVIF and JPEG XL. Account usage and settings can also be queried in plain language. Images are exposed as MCP resources so the assistant can inspect dimensions, formats and CDN URLs.

The package is aimed at developers and content teams who already work inside an AI coding or chat tool and want to handle image hosting without switching to a dashboard. It is distributed as an npm package and configured through a single JSON entry in each client.

## Features

- **Image upload from multiple sources:** Accepts a local file path, a remote URL or base64 data, with optional target folder paths.
- **Library search and listing:** Lists images by folder with pagination and searches by filename or path.
- **CDN URL generation:** Builds delivery URLs with resize, fit, quality and format options.
- **Image metadata lookup:** Retrieves details for a specific image by ID or file path.
- **Usage and settings queries:** Reports storage, upload and bandwidth usage along with account settings.
- **Image resources and prompts:** Exposes images as readable resources and offers prompts for upload-and-share, usage checks and search.

## Good for

- Upload a screenshot from an AI chat and get a resized CDN link to share
- Find images in a hosting library by keyword without opening a dashboard
- Generate WebP or AVIF delivery URLs at specific dimensions for a web project
- Check how much storage and bandwidth an img-src account has used
- Organise and clean up image folders by deleting outdated files from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env IMG_SRC_API_KEY='<IMG_SRC_API_KEY>' -- npx -y @img-src/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@img-src/mcp-server"
      ],
      "env": {
        "IMG_SRC_API_KEY": "<IMG_SRC_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@img-src/mcp-server"
      ],
      "env": {
        "IMG_SRC_API_KEY": "<IMG_SRC_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@img-src/mcp-server"
      ],
      "env": {
        "IMG_SRC_API_KEY": "<IMG_SRC_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@img-src/mcp-server"
      ],
      "env": {
        "IMG_SRC_API_KEY": "<IMG_SRC_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@img-src/mcp-server"
      ],
      "env": {
        "IMG_SRC_API_KEY": "<IMG_SRC_API_KEY>"
      }
    }
  }
}
```

## Tools

- `upload_image`: Upload an image from a local file, URL, or base64 data to your img-src.io account.
- `list_images`: List images in your account, optionally within a specific folder.
- `search_images`: Search for images by filename or path.
- `get_image`: Get detailed metadata for a specific image.
- `delete_image`: Permanently delete an image.
- `get_usage`: View your current usage statistics.
- `get_settings`: Get your account settings and configuration.
- `get_cdn_url`: Generate a CDN URL with optional image transformations.

## FAQ

### How do I get an API key?

Log in to img-src.io, open Settings, go to API Keys, create a new key and copy it. Keys begin with imgsrc_.

### Which AI clients can use img-src-io?

The README gives setup steps for Claude Desktop, Claude Code, Cursor, VS Code with GitHub Copilot, Windsurf, Cline, Zed and JetBrains IDEs.

### How is the server installed?

It is published on npm as @img-src/mcp-server and can be installed globally with pnpm or run directly with pnpm dlx or npx.

### Is the server free to use?

The server code is MIT licensed. Use of the underlying img-src.io image hosting service is governed by its own account plans.

### How do I add img-src-io to Claude Code?

Run this command in your terminal: claude mcp add mcp --env IMG_SRC_API_KEY='<IMG_SRC_API_KEY>' -- npx -y @img-src/mcp-server

### What are the best alternatives to img-src-io?

The closest alternatives to img-src-io are Mediamcp, Stock Images MCP, spronta, AI Image Editor MCP and editclips.online.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Mediamcp](https://ai-powered.com/mcp/mediamcp-2): Mediamcp is an open-source MCP server for design and media.
- [Stock Images MCP](https://ai-powered.com/mcp/stock-images-mcp): Stock Images MCP is an open-source MCP server for finance and payments.
- [spronta](https://ai-powered.com/mcp/spronta): spronta is a freemium MCP server for web search and scraping.
- [AI Image Editor MCP](https://ai-powered.com/mcp/ai-image-editor-mcp): AI Image Editor MCP is a freemium MCP server for design and media.
- [editclips.online](https://ai-powered.com/mcp/editclips-online): editclips.online is a paid MCP server for design and media.
- [Image Resolver](https://ai-powered.com/mcp/image-resolver): Image Resolver is an open-source MCP server for design and media.
- [AI Photo Editor MCP](https://ai-powered.com/mcp/ai-photo-editor-mcp): AI Photo Editor MCP is an open-source MCP server for design and media.
- [Image Generation MCP Server](https://ai-powered.com/mcp/image-generation-mcp-server): Image Generation MCP Server is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/img-src-io
