flin-imgbb-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@flin-imgbb-mcp Upload image /home/user/photo.png"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
flin-imgbb-mcp
MCP server for uploading images to ImgBB from Claude-compatible clients.
Quick Start
The recommended setup uses uvx — no repository clone or virtual environment required.
Add this to your Claude MCP configuration:
{
"mcpServers": {
"imgbb": {
"command": "uvx",
"args": ["flin-imgbb-mcp@latest"],
"env": {
"IMGBB_API_KEY": "your-imgbb-api-key"
}
}
}
}Get your API key at api.imgbb.com.
Related MCP server: kimi-read-image-mcp
Tools
upload_image
Upload a single image file to ImgBB and get its public URL.
Parameter | Type | Required | Description |
| string | yes | Absolute or relative path to the image file |
| string | no | Optional name for the image on ImgBB |
| number | no | Expiration in seconds (60–15552000) |
Returns: url, display_url, delete_url, title
list_images
List all image files in a local folder (png, jpg, jpeg, gif, webp, bmp).
Parameter | Type | Required | Description |
| string | yes | Absolute path to the folder |
upload_all_images
Upload all images from a local folder to ImgBB.
Parameter | Type | Required | Description |
| string | yes | Absolute path to the folder |
| number | no | Expiration in seconds (60–15552000) for all images |
Configuration
Environment Variable | Required | Description |
| yes | Your ImgBB API key |
Troubleshooting
Server does not start / "IMGBB_API_KEY is not set"
Make sure IMGBB_API_KEY is set in the env block of your MCP configuration. The server checks for it at startup and will exit with a clear error if it is missing.
Upload fails with HTTP 400 The file path must point to a valid image file. Supported formats: png, jpg, jpeg, gif, webp, bmp.
uvx command not found
Install uv from docs.astral.sh/uv.
Development
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install dependencies
uv sync --group dev
# Run tests
uv run pytest tests/ -v
# Lint
uv run ruff check src/ tests/
# Build distribution artifacts
uv buildRelease
Releases are published to PyPI automatically when a version tag is pushed:
git tag v1.0.2
git push origin v1.0.2The GitHub Actions release workflow builds the package and publishes it via PyPI Trusted Publishing.
License
MIT
Available Tools
3 toolslist_imagesC
List all image files in a local folder (png, jpg, jpeg, gif, webp, bmp).
Args: folder_path: Absolute path to the folder containing images.
Inputs: folder_path (required). Returns: result
upload_all_imagesA
Upload all images from a local folder to ImgBB.
Args: folder_path: Absolute path to the folder containing images. expiration: Optional expiration time in seconds (60-15552000) for all images.
Inputs: folder_path (required), expiration. Returns: result
upload_imageA
Upload a single image file to ImgBB and return its public URL.
Args: file_path: Absolute or relative path to the image file. name: Optional name for the image on ImgBB. expiration: Optional expiration time in seconds (60-15552000). After this time the image is automatically deleted.
Inputs: file_path (required), name, expiration. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: one lists local images, one uploads all, one uploads a single. No overlap or ambiguity.
All tools use consistent snake_case verb_noun naming: list_images, upload_all_images, upload_image. Pattern is predictable.
With 3 tools, the server is well-scoped for its purpose of listing and uploading images to ImgBB. No unnecessary tools.
Core upload and list functionality is present, but there are notable gaps: no tool to delete images or retrieve info about previously uploaded images beyond the upload response.
Maintenance
Related MCP Connectors
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
MCP server for Qwen Image 3 AI image generation
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- AlicenseAqualityDmaintenanceA simple MCP server that reads local images and returns them as ImageContent for LLM vision analysis.124 PyPIMIT
- AlicenseBqualityCmaintenanceMinimal MCP server for Kimi-compatible image analysis, allowing local images to be sent as inline base64 to any compatible endpoint.1MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP server (Streamable HTTP) for generating and editing images via Google Gemini, usable as a custom connector in Claude.-
- AlicenseAqualityCmaintenanceA local (stdio) MCP server for PixelVault — agent-first image hosting, enabling upload of local files by path without base64.613 npmMIT