BeeIMG Image Hosting
Upload, delete, and manage images on BeeIMG with albums, folders, privacy controls, and API access.
Should I use this
Quality & Safety
Findings (1)
- LOWin upload_url
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://beeimg.com/mcp"
}
}
}Remote endpoints
https://beeimg.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (8)
🔴upload_url(url, apikey, albumid, privacy, title)
Upload an image to BeeIMG by fetching it from a remote URL. Returns the hosted image URL, thumbnail, view page, and delete URL.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Remote image URL to fetch and host."
},
"apikey": {
"type": "string",
"description": "Your BeeIMG API key. Required for album uploads and all delete requests. Get it at https://beeimg.com/api/newkey"
},
"albumid": {
"type": "string",
"description": "Album or folder ID to place the image in. Accepts both 5-char master album IDs and 9-char folder IDs."
},
"privacy": {
"type": "string",
"enum": [
"public",
"private",
"truly-private"
],
"description": "public (default), private (unlisted - hidden from search but accessible via link), or truly-private (only you and admins can see it - Premium feature)."
},
"title": {
"type": "string",
"description": "Optional title for the image."
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴upload_file(image, filename, apikey, albumid, privacy, ...)
Upload an image file to BeeIMG from base64 or a data URI. Returns the hosted image URL, thumbnail, view page, and delete URL.
Input Schema
{
"type": "object",
"properties": {
"image": {
"type": "string",
"description": "The image as a data URI (e.g. data:image/png;base64,....) or raw base64."
},
"filename": {
"type": "string",
"description": "Optional original filename (used to detect the extension and default title)."
},
"apikey": {
"type": "string",
"description": "Your BeeIMG API key. Required for album uploads and all delete requests. Get it at https://beeimg.com/api/newkey"
},
"albumid": {
"type": "string",
"description": "Album or folder ID to place the image in. Accepts both 5-char master album IDs and 9-char folder IDs."
},
"privacy": {
"type": "string",
"enum": [
"public",
"private",
"truly-private"
],
"description": "public (default), private (unlisted - hidden from search but accessible via link), or truly-private (only you and admins can see it - Premium feature)."
},
"title": {
"type": "string",
"description": "Optional title for the image."
}
},
"required": [
"image"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴delete_image(image_id, apikey, delete_key)
Delete an image hosted on BeeIMG using its image ID, your API key, and the delete key returned at upload time. Returns OK or ERROR.
Input Schema
{
"type": "object",
"properties": {
"image_id": {
"type": "string",
"description": "The image ID to delete (the value of \"name\" in the upload response)."
},
"apikey": {
"type": "string",
"description": "Your BeeIMG API key."
},
"delete_key": {
"type": "string",
"description": "The deletion key returned with the upload response."
}
},
"required": [
"image_id",
"apikey",
"delete_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢beeimg_premium_info
Returns the current BeeIMG free-plan limits, premium perks, and upgrade links. Call this when an upload fails with a rate limit, storage limit, or file-too-large error to advise the user about upgrading.
Input Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_albums(apikey)
List all albums owned by the authenticated user. Returns album IDs, titles, privacy, and view counts. Use album IDs with upload_url/upload_file albumid parameter.
Input Schema
{
"type": "object",
"properties": {
"apikey": {
"type": "string",
"description": "Your BeeIMG API key."
}
},
"required": [
"apikey"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡create_album(title, apikey, privacy)
Create a new album. Returns the album ID to use with upload_url/upload_file albumid parameter.
Input Schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Album title."
},
"apikey": {
"type": "string",
"description": "Your BeeIMG API key."
},
"privacy": {
"type": "string",
"enum": [
"public",
"unlisted",
"private",
"truly-private"
],
"description": "Privacy setting. Public (default), unlisted (hidden from search), private/truly-private (Premium only)."
}
},
"required": [
"title",
"apikey"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_album(id, apikey)
Get album details, folders, and images. Use folder IDs from the folders array with upload_url/upload_file albumid parameter.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Album ID (5 chars) or folder ID (9 chars)."
},
"apikey": {
"type": "string",
"description": "Your BeeIMG API key."
}
},
"required": [
"id",
"apikey"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡create_folder(main_album_id, parent_id, name, apikey)
Create a sub-folder in an album. Returns the folder ID (9 chars) to use with upload_url/upload_file albumid parameter.
Input Schema
{
"type": "object",
"properties": {
"main_album_id": {
"type": "string",
"description": "Parent album ID (5 chars)."
},
"parent_id": {
"type": "string",
"description": "Folder or album ID (5 or 9 chars) to place the folder in."
},
"name": {
"type": "string",
"description": "Folder name (default \"New Folder\")."
},
"apikey": {
"type": "string",
"description": "Your BeeIMG API key."
}
},
"required": [
"main_album_id",
"parent_id",
"apikey"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence