MCP Server

BeeIMG Image Hosting

com.beeimg/mcp
Media & Content Public & reachable MCP 2025-11-25

What this MCP does

Uploads, organizes, manages, and deletes hosted images using albums, folders, privacy controls, and image URLs or files.

beeimg_premium_info
Premium Plan 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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'additionalProperties': False}
create_album
Create Album
Create a new album. Returns the album ID to use with upload_url/upload_file albumid parameter.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['title', 'apikey'], 'properties': {'title': {'type': 'string', 'description': 'Album title.'}, 'apikey': {'type': 'string', 'description': 'Your BeeIMG API key.'}, 'privacy': {'enum': ['public', 'unlisted', 'private', 'truly-private'], 'type': 'string', 'description': 'Privacy setting. Public (default), unlisted (hidden from search), private/truly-private (Premium only).'}}, 'additionalProperties': False}
create_folder
Create Folder in Album
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', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['main_album_id', 'parent_id', 'apikey'], 'properties': {'name': {'type': 'string', 'description': 'Folder name (default "New Folder").'}, 'apikey': {'type': 'string', 'description': 'Your BeeIMG API key.'}, 'parent_id': {'type': 'string', 'description': 'Folder or album ID (5 or 9 chars) to place the folder in.'}, 'main_album_id': {'type': 'string', 'description': 'Parent album ID (5 chars).'}}, 'additionalProperties': False}
delete_image
Delete Image
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.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['image_id', 'apikey', 'delete_key'], 'properties': {'apikey': {'type': 'string', 'description': 'Your BeeIMG API key.'}, 'image_id': {'type': 'string', 'description': 'The image ID to delete (the value of "name" in the upload response).'}, 'delete_key': {'type': 'string', 'description': 'The deletion key returned with the upload response.'}}, 'additionalProperties': False}
get_album
Get Album Details
Get album details, folders, and images. Use folder IDs from the folders array with upload_url/upload_file albumid parameter.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'apikey'], 'properties': {'id': {'type': 'string', 'description': 'Album ID (5 chars) or folder ID (9 chars).'}, 'apikey': {'type': 'string', 'description': 'Your BeeIMG API key.'}}, 'additionalProperties': False}
list_albums
List Albums
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['apikey'], 'properties': {'apikey': {'type': 'string', 'description': 'Your BeeIMG API key.'}}, 'additionalProperties': False}
upload_file
Upload Image File
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', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['image'], 'properties': {'image': {'type': 'string', 'description': 'The image as a data URI (e.g. data:image/png;base64,....) or raw base64.'}, 'title': {'type': 'string', 'description': 'Optional title for the image.'}, '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': {'enum': ['public', 'private', 'truly-private'], 'type': 'string', 'description': 'public (default), private (unlisted - hidden from search but accessible via link), or truly-private (only you and admins can see it - Premium feature).'}, 'filename': {'type': 'string', 'description': 'Optional original filename (used to detect the extension and default title).'}}, 'additionalProperties': False}
upload_url
Upload Image by URL
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', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Remote image URL to fetch and host.'}, 'title': {'type': 'string', 'description': 'Optional title for the image.'}, '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': {'enum': ['public', 'private', 'truly-private'], 'type': 'string', 'description': 'public (default), private (unlisted - hidden from search but accessible via link), or truly-private (only you and admins can see it - Premium feature).'}}, 'additionalProperties': False}
Added
create_folder
Sept. 17, 2026, 12:33 p.m.
Added
get_album
Sept. 17, 2026, 12:33 p.m.
Added
create_album
Sept. 17, 2026, 12:33 p.m.
Added
list_albums
Sept. 17, 2026, 12:33 p.m.
Added
beeimg_premium_info
Sept. 17, 2026, 12:33 p.m.
Added
delete_image
Sept. 17, 2026, 12:33 p.m.
Added
upload_file
Sept. 17, 2026, 12:33 p.m.
Added
upload_url
Sept. 17, 2026, 12:33 p.m.