Yourimageshare

What yourimageshare MCP server does

The yourimageshare MCP server gives MCP-compatible AI clients access to YourImageShare's file-hosting API. YourImageShare supports image and video hosting for anonymous and registered users, while API access is authenticated with an API key. Through the MCP package, an agent can send files for hosting, inspect uploads associated with the account, and remove individual uploads.

The underlying API is available at https://yourimageshare.com/api. It provides three operations: uploading a file with POST, retrieving a paginated upload list with GET, and deleting one upload with DELETE /api/{id}. Upload responses include file metadata and hosted URLs such as an image path, page source URL, and direct URL.

How it works

The MCP distribution is published as yourimageshare-mcp on npm and can be launched with npx yourimageshare-mcp. An MCP-compatible client starts the package as a server and makes its exposed operations available to the model. The server then calls the YourImageShare API rather than requiring the agent to construct raw HTTP requests.

YourImageShare requires an API key in an X-API-Key header, with a query-string key supported as a fallback by the API. The normal account key can manage uploads. YourImageShare also provides a separate upload-only key for situations where a credential may be visible to other people; that restricted key cannot list or delete files.

Setup and configuration

Create or access a YourImageShare account, open the API tab in the account area, and copy or regenerate an API key. The same area provides the separate upload-only key. Add the yourimageshare-mcp package to an MCP-compatible client using that client's standard server configuration, then provide the credential as required by the package configuration. The supplied material identifies the launch command but does not specify a universal environment-variable name or a client-specific configuration block.

The package is also listed through Smithery and Glama. Client setup therefore depends on whether the server is launched directly with npm or installed through one of those directories.

Tools and capabilities

The yourimageshare MCP server is described as exposing these operations:

• Upload a file to YourImageShare.
• List the account's uploads, with pagination provided by the API.
• Delete one of the account's uploads by ID.

The underlying upload endpoint also accepts an optional expires_in value from 60 to 2,592,000 seconds. When used, the hosted object is removed after expiry and its page begins returning a gone response within approximately five minutes. Whether this field is exposed directly by the MCP upload tool is not specified in the supplied material.

Limitations and notes

This server depends on the YourImageShare API and a valid API key. It is intended for MCP-compatible clients; the README specifically names Claude Code and Cursor and also describes support for other MCP clients. API rate limits, error codes, and complete request and response schemas are documented in the API reference, but their details are not included here.

Use an upload-only key when a credential could become public. It can upload files but cannot perform the list or delete operations. The MCP package is distributed through npm, and the README does not state a separate license for the MCP server itself, although the related SDKs are identified as MIT-licensed.