BeeIMG Image Hosting

Working · 1.8 s

com.beeimg/mcpv1.2.0 Domain verified

Upload, delete, and manage images on BeeIMG with albums, folders, privacy controls, and API access.

Design & Creative Productivity

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://beeimg.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

beeimg_premium_info Read-only

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.

This tool takes no arguments.

Tools (8)

beeimg_premium_info

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

create_album

Create a new album. Returns the album ID to use with upload_url/upload_file albumid parameter.

Argument	Type	Description
title*	string	Album title.
apikey*	string	Your BeeIMG API key.
privacy	string	Privacy setting. Public (default), unlisted (hidden from search), private/truly-private (Premium only).

Input schema (JSON)

{
  "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 a sub-folder in an album. Returns the folder ID (9 chars) to use with upload_url/upload_file albumid parameter.

Argument	Type	Description
name	string	Folder name (default "New Folder").
apikey*	string	Your BeeIMG API key.
parent_id*	string	Folder or album ID (5 or 9 chars) to place the folder in.
main_album_id*	string	Parent album ID (5 chars).

Input schema (JSON)

{
  "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 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

Argument	Type	Description
apikey*	string	Your BeeIMG API key.
image_id*	string	The image ID to delete (the value of "name" in the upload response).
delete_key*	string	The deletion key returned with the upload response.

Input schema (JSON)

{
  "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, folders, and images. Use folder IDs from the folders array with upload_url/upload_file albumid parameter.

read-only

Argument	Type	Description
id*	string	Album ID (5 chars) or folder ID (9 chars).
apikey*	string	Your BeeIMG API key.

Input schema (JSON)

{
  "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 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

Argument	Type	Description
apikey*	string	Your BeeIMG API key.

Input schema (JSON)

{
  "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 an image file to BeeIMG from base64 or a data URI. Returns the hosted image URL, thumbnail, view page, and delete URL.

Argument	Type	Description
image*	string	The image as a data URI (e.g. data:image/png;base64,....) or raw base64.
title	string	Optional title for the image.
apikey	string	Your BeeIMG API key. Required for album uploads and all delete requests. Get it at https://beeimg.com/api/newkey
albumid	string	Album or folder ID to place the image in. Accepts both 5-char master album IDs and 9-char folder IDs.
privacy	string	public (default), private (unlisted - hidden from search but accessible via link), or truly-private (only you and admins can see it - Premium feature).
filename	string	Optional original filename (used to detect the extension and default title).

Input schema (JSON)

{
  "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 an image to BeeIMG by fetching it from a remote URL. Returns the hosted image URL, thumbnail, view page, and delete URL.

Argument	Type	Description
url*	string	Remote image URL to fetch and host.
title	string	Optional title for the image.
apikey	string	Your BeeIMG API key. Required for album uploads and all delete requests. Get it at https://beeimg.com/api/newkey
albumid	string	Album or folder ID to place the image in. Accepts both 5-char master album IDs and 9-char folder IDs.
privacy	string	public (default), private (unlisted - hidden from search but accessible via link), or truly-private (only you and admins can see it - Premium feature).

Input schema (JSON)

{
  "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
}